bird-twitter

// Twitter/X CLI wrapper using bird — post tweets, reply, read, search, and manage your timeline. Fast GraphQL-based X CLI.

$ git log --oneline --stat

stars:1,933

forks:367

updated:March 4, 2026

SKILL.mdreadonly

SKILL.md Frontmatter

namebird-twitter

descriptionTwitter/X CLI wrapper using bird — post tweets, reply, read, search, and manage your timeline. Fast GraphQL-based X CLI.

version1.0.0

authorcyzi

tagstwitter,x,tweet,social,timeline,search

metadata[object Object]

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_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!