sferik/t
T
t is a command-line Twitter client that wraps Twitter's REST and streaming APIs, enabling users to post tweets, manage accounts, and search Twitter directly from the terminal. It supports authenticating and switching between multiple Twitter profiles stored in a local configuration file, allowing commands to be executed under the active account.
The tool distinguishes itself through shell-integrated workflows, including tab completion for Zsh and Bash, and Unix-pipe-compatible output formatting that defaults to tab-separated columns for piping into standard utilities like grep and awk. It also provides CSV export via a flag for spreadsheet or database ingestion, and supports parallel API request batching to accelerate bulk operations such as mass unfollowing or deletion.
Additional capabilities include real-time tweet streaming through a persistent HTTP connection, deep tweet search with pagination up to 3,200 tweets and client-side regex filtering, and a follow relationship check that exits with a non-zero code if one user does not follow another. The project generates shell-completion scripts and formats output for seamless terminal automation.
Features
- Social Media CLI Clients - Runs Twitter operations such as delete, list, set, and stream through a command-line interface.
- Social Media CLI Clients - A command-line tool for posting tweets, managing accounts, and searching Twitter from the terminal.
- Tweet Sending - Sends a new tweet to the authenticated account's timeline from the command line.
- Short Status Updates - Publishes a status update to the authenticated user's Twitter timeline from the command line.
- Social Media CLI Automations - Running Twitter operations like posting, deleting, and searching from the command line without a browser.
- Social Media API Wrappers - Wraps Twitter's REST and streaming APIs for bulk operations and real-time data from the terminal.
- Account Context Switching - Switches between multiple Twitter profiles stored in a local config file and runs commands under the active account.
- Account Authentication - Authenticates and stores multiple Twitter accounts, switching between them with a subcommand.
- Multi-Account Session Management - Stores and switches between multiple authenticated Twitter profiles in a local config file.
- OAuth Token Swapping - Stores per-account OAuth credentials in a local YAML file and swaps the active token at runtime to impersonate different users.
- Paginated - Iterates through paginated REST API responses up to the 3,200-tweet limit and applies client-side regex filtering.
- Bulk Data Operations - Executes multiple API requests in parallel to perform large-scale tasks like mass unfollowing or deletion.
- CSV Exports - Converts any command's structured output into comma-separated values when the --csv flag is passed.
- Social Media Streams - Opens a persistent HTTP connection to receive real-time tweets matching a filter or timeline.
- Social Media Stream Consumers - Opens a persistent connection to receive and filter tweets in real time from the terminal.
- Search and Indexing - Queries Twitter's search API and returns matching tweets in the terminal.
- Social Media Searches - Searches up to 3,200 tweets via the REST API and filters results with a regular expression.
- Parallel Request Executors - Fires multiple independent Twitter API requests concurrently using thread-level parallelism to accelerate bulk operations.
- Command Piping - Formats command output for seamless piping to standard Unix utilities like grep and awk.
- CSV Output Formats - Converts any command's output to CSV format using the --csv flag.
- Tab-Separated Output Formats - Formats command output as tab-separated columns by default for piping into grep, awk, and other standard Unix tools.
- Bulk Operations - Fires multiple independent API requests concurrently to accelerate bulk operations like mass unfollowing.
- Shell Completion Generators - Generates Zsh and Bash completion scripts that expose all subcommands, flags, and dynamic arguments for tab-completion.
- Shell Completion Integrations - Completes commands with tab completion and pipes output to Unix tools for scripting and automation.
- Shell Completion Providers - Provides tab completion for commands, subcommands, and flags in Zsh and Bash.
- Shell Integration Tools - Provides tab completion for Zsh and Bash and formats output for piping to Unix utilities.
- Persistent HTTP Connections - Opens a long-lived HTTP connection to Twitter's streaming endpoint and processes incoming JSON events line-by-line in real time.
- Third Party APIs - Command-line power tool for Twitter.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
