How do I install the Twitter CLI skill?

Run npx skillmds@latest add phattbeats/twitter-cli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Twitter CLI safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Twitter CLI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Twitter CLI free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Twitter CLI?

phattbeats (@phattbeats) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Twitter CLI by phattbeats — Agent Skill

Name: Twitter CLI
Rating: 4.5 (4 reviews)
Author: phattbeats

Twitter CLI

Use twitter-cli for Twitter/X access without API keys. Use when user wants to read tweets, search Twitter, browse timelines, check user profiles, or interact with Twitter content. Requires user cookies (auth_token + ct0). Supports read (feed, search, user, bookmarks) and write (post, like, retweet) operations. DO NOT use for API-based Twitter access - this is the free alternative.

phattbeats Updated Sep 22, 2026

File contents

twitter-cli Skill

Use this skill for all Twitter/X operations without needing expensive API keys.

Installation (Already Done)

The CLI is installed at: /root/.openclaw/utilities/twitter-cli.sh

Wrapper script handles PYTHONPATH automatically.

Authentication

Credentials are stored in ~/.env in the skill folder (git-ignored). The wrapper script loads them automatically. No setup needed — just use the commands below.

To update credentials:

Go to twitter.com in your browser
Open Developer Tools → Application tab → Cookies → twitter.com
Copy auth_token and ct0 values

Update ~/.env in the skill folder:

TWITTER_AUTH_TOKEN=your_auth_token
TWITTER_CT0=your_ct0

Or the CLI can extract cookies from your browser automatically.

Commands

Reading

# Home timeline (For You)
/root/.openclaw/utilities/twitter-cli.sh feed

# Following timeline
/root/.openclaw/utilities/twitter-cli.sh feed -t following

# Limit results
/root/.openclaw/utilityil/twitter-cli.sh feed --max 20

# Search tweets
/root/.openclaw/utilities/twitter-cli.sh search "keyword"
/root/.openclaw/utilities/twitter-cli.sh search "AI" -t Latest --max 50

# User profile
/root/.openclaw/utilities/twitter-cli.sh user elonmusk

# User tweets
/root/.openclaw/utilities/twitter-cli.sh user-posts elonmusk --max 10

# User likes
/root/.openclaw/utilities/twitter-cli.sh likes elonmusk --max 20

# Bookmarks
/root/.openclaw/utilities/twitter-cli.sh bookmarks

# Tweet detail
/root/.openclaw/utilities/twitter-cli.sh tweet 1234567890

Writing

# Post tweet
/root/.openclaw/utilities/twitter-cli.sh post "Hello from OpenClaw!"

# Reply
/root/.openclaw/utilities/twitter-cli.sh post "reply text" --reply-to 1234567890

# Like
/root/.openclaw/utilities/twitter-cli.sh like 1234567890

# Retweet
/root/.openclaw/utilities/twitter-cli.sh retweet 1234567890

JSON Output

# Export to JSON for parsing
/root/.openclaw/utilities/twitter-cli.sh feed --json > tweets.json
/root/.openclaw/utilities/twitter-cli.sh search "topic" --json > results.json

Common Workflows

Daily Twitter Digest

Get home timeline: twitter-cli.sh feed --max 50
Get bookmarks: twitter-cli.sh bookmarks --max 20
Summarize into digest for user

Topic Research

Search: twitter-cli.sh search "keyword" -t Latest --max 50
Parse JSON output
Summarize findings

User Monitoring

Get user posts: twitter-cli.sh user-posts <handle> --max 20
Get likes: twitter-cli.sh likes <handle> --max 20
Track activity over time

Error Handling

No Twitter cookies: Ask user for auth_token + ct0
401/403: Cookies expired, need fresh ones
Rate limited: Wait and retry, or use proxy

Notes

Write operations have built-in delays (1.5-4s) to avoid rate limits
TLS fingerprint automatically matches Chrome
Supports proxy via TWITTER_PROXY env var

---name: twitter-clidescription: Use twitter-cli for Twitter/X access without API keys. Use when user wants to read tweets, search Twitter, browse timelines, check user profiles, or interact with Twitter content. Requires user cookies (auth_token + ct0). Supports read (feed, search, user, bookmarks) and write (post, like, retweet) operations. DO NOT use for API-based Twitter access - this is the free alternative.---# twitter-cli SkillUse this skill for all Twitter/X operations without needing expensive API keys.## Installation (Already Done)The CLI is installed at: `/root/.openclaw/utilities/twitter-cli.sh`Wrapper script handles PYTHONPATH automatically.## AuthenticationCredentials are stored in `~/.env` in the skill folder (git-ignored). The wrapper script loads them automatically. No setup needed — just use the commands below.**To update credentials:**1. Go to twitter.com in your browser2. Open Developer Tools → Application tab → Cookies → twitter.com3. Copy `auth_token` and `ct0` values4. Update `~/.env` in the skill folder: ``` TWITTER_AUTH_TOKEN=your_auth_token TWITTER_CT0=your_ct0 ```**Or** the CLI can extract cookies from your browser automatically.## Commands### Reading```bash# Home timeline (For You)/root/.openclaw/utilities/twitter-cli.sh feed# Following timeline/root/.openclaw/utilities/twitter-cli.sh feed -t following# Limit results/root/.openclaw/utilityil/twitter-cli.sh feed --max 20# Search tweets/root/.openclaw/utilities/twitter-cli.sh search "keyword"/root/.openclaw/utilities/twitter-cli.sh search "AI" -t Latest --max 50# User profile/root/.openclaw/utilities/twitter-cli.sh user elonmusk# User tweets/root/.openclaw/utilities/twitter-cli.sh user-posts elonmusk --max 10# User likes/root/.openclaw/utilities/twitter-cli.sh likes elonmusk --max 20# Bookmarks/root/.openclaw/utilities/twitter-cli.sh bookmarks# Tweet detail/root/.openclaw/utilities/twitter-cli.sh tweet 1234567890```### Writing```bash# Post tweet/root/.openclaw/utilities/twitter-cli.sh post "Hello from OpenClaw!"# Reply/root/.openclaw/utilities/twitter-cli.sh post "reply text" --reply-to 1234567890# Like/root/.openclaw/utilities/twitter-cli.sh like 1234567890# Retweet/root/.openclaw/utilities/twitter-cli.sh retweet 1234567890```### JSON Output```bash# Export to JSON for parsing/root/.openclaw/utilities/twitter-cli.sh feed --json > tweets.json/root/.openclaw/utilities/twitter-cli.sh search "topic" --json > results.json```## Common Workflows### Daily Twitter Digest1. Get home timeline: `twitter-cli.sh feed --max 50`2. Get bookmarks: `twitter-cli.sh bookmarks --max 20`3. Summarize into digest for user### Topic Research1. Search: `twitter-cli.sh search "keyword" -t Latest --max 50`2. Parse JSON output3. Summarize findings### User Monitoring1. Get user posts: `twitter-cli.sh user-posts <handle> --max 20`2. Get likes: `twitter-cli.sh likes <handle> --max 20`3. Track activity over time## Error Handling- **No Twitter cookies**: Ask user for auth_token + ct0- **401/403**: Cookies expired, need fresh ones- **Rate limited**: Wait and retry, or use proxy## Notes- Write operations have built-in delays (1.5-4s) to avoid rate limits- TLS fingerprint automatically matches Chrome- Supports proxy via TWITTER_PROXY env var

Frequently asked questions