twitter-cli
A CLI for Twitter/X — feed, bookmarks, and user timeline in terminal
twitter-cli is a command-line agent skill for Twitter/X that enables AI agents to read timelines, bookmarks, search tweets, fetch user profiles, and perform write operations like posting, liking, and retweeting—all without requiring API keys. It provides structured YAML and JSON output optimized for agent consumption, cookie-based authentication with browser extraction, and anti-detection features including TLS fingerprinting and request jitter. The tool is explicitly designed for AI agent workflows and includes a SKILL.md manifest for integration with Skills CLI and other agent frameworks.
Key Features
Use Cases
- 01AI agents monitoring Twitter timelines and bookmarks for trending topics or relevant content
- 02Automated tweet posting and reply workflows with image attachments for social media bots
- 03Research pipelines extracting structured tweet data by keyword or user for sentiment analysis
- 04Content aggregation agents collecting and ranking tweets by engagement metrics
- 05Automated Twitter Article archival and conversion to Markdown for documentation systems
- 06Social listening agents tracking mentions, hashtags, or competitor accounts with structured output
Related Skills
View moresuperpowers
An agentic skills framework & software development methodology that works.
skills
Skills for Real Engineers. Straight from my .agents directory.
skills
Public repository for Agent Skills
ponytail
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
twitter-cli — FAQ
What is twitter-cli and what does it do?+
twitter-cli is a terminal-based agent skill for Twitter/X that reads timelines, bookmarks, search results, and user profiles, and performs write operations like posting, liking, and retweeting. It outputs structured YAML or JSON for AI agent integration and works without Twitter API keys by using cookie-based authentication.
How do I install twitter-cli?+
Install with `uv tool install twitter-cli` (recommended) or `pipx install twitter-cli`. For agent integration via Skills CLI, run `npx skills add jackwener/twitter-cli`. You can also clone the repository manually into `.agents/skills/twitter-cli`.
Does twitter-cli require API keys or authentication?+
No API keys are needed. It uses cookie-based authentication via automatic browser extraction (Arc, Chrome, Edge, Firefox, Brave) or manual environment variables `TWITTER_AUTH_TOKEN` and `TWITTER_CT0`. You must be logged in to x.com in a supported browser for auto-extraction.
Which AI clients and agent frameworks work with twitter-cli?+
It ships with a SKILL.md manifest compatible with Skills CLI and other agent frameworks that consume structured skill definitions. The tool outputs YAML/JSON suitable for any AI agent that can execute shell commands and parse structured data.
Is twitter-cli free and open source?+
Yes, twitter-cli is open source and available on GitHub under the public-clis organization. It's free to use with no licensing costs.
How do I avoid getting banned when using twitter-cli?+
Use a proxy via `TWITTER_PROXY`, keep request volumes low with `--max`, avoid frequent script runs, use browser cookie extraction for full fingerprint, and prefer residential proxies over datacenter IPs. The tool includes built-in jitter and write-operation delays to reduce detection risk.
How do I install twitter-cli?+
Open the source repository on GitHub and follow its README. twitter-cli is a skill — MCP Agents Market links you directly to the official repo.
Is twitter-cli free?+
twitter-cli is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.