modbender 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
- Log in to Twitter/X in your browser
- Open Developer Tools (F12)
- Go to Application/Storage → Cookies → twitter.com
- Copy:
auth_token→AUTH_TOKENct0→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!