Bird Twitter Skill 🐦

Fast Twitter/X CLI wrapper using bird — post tweets, reply, read, search, and manage your timeline via Twitter's GraphQL API.

Required Environment Variables

export AUTH_TOKEN=<your_twitter_auth_token>
export CT0=<your_twitter_ct0_cookie>

How to Get Tokens

1. Log in to Twitter/X in your browser
2. Open Developer Tools (F12)
3. Go to Application/Storage → Cookies → twitter.com
4. Copy:
   • auth_token → AUTH_TOKEN
   • ct0 → CT0

Quick Usage

# Check login status
bird whoami

# Check credential availability
bird check

# Post a tweet
bird tweet "Hello from bird-twitter skill!"

# Reply to a tweet
bird reply <tweet-id-or-url> "Great thread!"

# Read a tweet
bird read <tweet-id-or-url>

# Read with JSON output
bird read <tweet-id-or-url> --json

# Search tweets
bird search "query"

# Get home timeline
bird home

# Get mentions
bird mentions

# Get liked tweets
bird likes

# Follow a user
bird follow <username>

# Get user's tweets
bird user-tweets <handle>

# Get trending topics
bird news
bird trending

Commands

Posting

| Command | Description | |---------|-------------| | bird tweet <text> | Post a new tweet | | bird reply <url> <text> | Reply to a tweet | | bird tweet <text> --media <path> | Tweet with media (up to 4 images or 1 video) |

Reading

| Command | Description | |---------|-------------| | bird read <url> | Read/fetch a tweet | | bird thread <url> | Show full conversation thread | | bird replies <url> | List replies to a tweet | | bird user-tweets <handle> | Get user's tweets |

Timelines

| Command | Description | |---------|-------------| | bird home | Home timeline ("For You" feed) | | bird mentions | Tweets mentioning you | | bird likes | Your liked tweets | | bird bookmarks | Your bookmarked tweets |

Search & Discovery

| Command | Description | |---------|-------------| | bird search <query> | Search tweets | | bird news | AI-curated news from Explore | | bird trending | Trending topics |

Account Management

| Command | Description | |---------|-------------| | bird whoami | Show logged-in account | | bird check | Check credential availability | | bird follow <user> | Follow a user | | bird unfollow <user> | Unfollow a user | | bird followers | List your followers | | bird following | List users you follow | | bird lists | Your Twitter lists |

Output Options

| Option | Description | |--------|-------------| | --json | JSON output | | --json-full | Include raw API response | | --plain | Plain text (no emoji, no color) | | --no-emoji | Disable emoji | | --no-color | Disable ANSI colors | | --timeout <ms> | Request timeout |

Configuration

Reads from:

• ~/.config/bird/config.json5
• ./.birdrc.json5

Supports: chromeProfile, firefoxProfile, cookieTimeoutMs, timeoutMs, quoteDepth

Environment Variables

| Variable | Description | |----------|-------------| | AUTH_TOKEN | Required — Twitter auth_token cookie | | CT0 | Required — Twitter ct0 cookie | | NO_COLOR | Disable colors | | BIRD_TIMEOUT_MS | Default timeout | | BIRD_COOKIE_TIMEOUT_MS | Cookie extraction timeout | | BIRD_QUOTE_DEPTH | Max quoted tweet depth |

Examples

# Check who's logged in
bird whoami

# Post a simple tweet
bird tweet "Hello world from OpenClaw!"

# Post with an image
bird tweet "Check this out!" --media ./image.png

# Reply to a tweet
bird reply 1234567890123456789 "Thanks for sharing!"

# Search for tweets about AI
bird search "artificial intelligence" --json

# Get your home timeline
bird home -n 20

# Read a tweet thread
bird thread https://x.com/user/status/1234567890

# Get trending topics
bird trending

Troubleshooting

401 Unauthorized

Check that AUTH_TOKEN and CT0 are set and valid. Run bird check to verify.

Token Expired

Twitter tokens expire periodically. Re-copy from browser cookies.

Rate Limited

Twitter GraphQL API has rate limits. Wait a few minutes and retry.

---

TL;DR: Fast Twitter/X CLI via bird. Set AUTH_TOKEN and CT0, then tweet, read, search, and manage your timeline!