| name | clix |
| description | Interact with Twitter/X from the terminal — read timelines, search, post, like, retweet, bookmark. Use when user asks to check Twitter, post tweets, monitor accounts, search X, or manage bookmarks. |
clix — Twitter/X CLI Skill
A CLI tool for Twitter/X using cookie-based authentication (no API keys needed).
Setup
cd /path/to/clix && uv sync
clix auth login
clix auth set --token TOKEN --ct0 CT0
export X_AUTH_TOKEN=xxx X_CT0=xxx
Commands Reference
Reading
clix feed
clix feed --type following
clix feed --count 50
clix feed --filter top --top 5
clix search "query"
clix search "query" --type Latest
clix search "from:user topic"
clix tweet TWEET_ID
clix tweet TWEET_ID --thread
clix user handle
clix user tweets handle
clix user likes handle
clix user followers handle
clix user following handle
clix bookmarks
Writing
clix post "Hello world"
clix post "reply text" --reply-to ID
clix post "quote" --quote URL
clix delete TWEET_ID --force
clix like TWEET_ID
clix unlike TWEET_ID
clix retweet TWEET_ID
clix unretweet TWEET_ID
clix bookmark TWEET_ID
clix unbookmark TWEET_ID
Account Management
clix auth status
clix auth login
clix auth login --browser chrome
clix auth set --token T --ct0 C
clix auth accounts
clix auth switch ACCOUNT_NAME
JSON Output (Agent Mode)
All commands support --json for structured output. Output is auto-JSON when stdout is not a TTY (piped).
clix feed --json
clix search "query" --json
clix user handle --json
clix auth status --json
JSON Tweet Schema
{
"id": "1234567890",
"text": "Tweet content",
"author_handle": "username",
"author_name": "Display Name",
"author_verified": true,
"created_at": "2024-01-01T00:00:00Z",
"engagement": {
"likes": 100,
"retweets": 50,
"replies": 10,
"views": 5000,
"bookmarks": 5,
"quotes": 2
},
"media": [{"type": "photo", "url": "..."}],
"reply_to_id": null,
"tweet_url": "https://x.com/username/status/1234567890"
}
Best Practices for Agents
- Always use
--json for parseable output
- Use
--force on delete to skip interactive confirmation
- Respect rate limits — add delays between bulk operations
- Use
--count to limit results (default: 20, max: 100)
- Use
--pages for pagination (feed/search only)
- Check auth first with
clix auth status --json before operations
- Use
--account for multi-account workflows
Exit Codes
| Code | Meaning |
|---|
| 0 | Success |
| 1 | General error |
| 2 | Authentication error |
| 3 | Rate limit exceeded |
Rate Limiting
- Read operations have ~1.5s built-in delay between requests
- Write operations have 1.5-4s random delay
- Exponential backoff on 429 responses
- For bulk operations, add your own delays between calls
MCP Server
clix is also available as an MCP server with 14 tools for any MCP-compatible client.
clix mcp
Configure in your MCP client:
{
"mcpServers": {
"clix": {
"command": "uvx",
"args": ["clix0", "mcp"]
}
}
}
Proxy Support
export X_PROXY=socks5://host:port
export X_PROXY=http://host:port