Fast Twitter/X CLI wrapper using bird — post tweets, reply, read, search, and manage your timeline via Twitter's GraphQL API.
export AUTH_TOKEN=<your_twitter_auth_token>
export CT0=<your_twitter_ct0_cookie>
auth_token → AUTH_TOKENct0 → CT0# 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
| Command | Description |
|---|---|
| --------- | ------------- |
bird tweet | Post a new tweet |
bird reply | Reply to a tweet |
bird tweet | Tweet with media (up to 4 images or 1 video) |
| Command | Description |
|---|---|
| --------- | ------------- |
bird read | Read/fetch a tweet |
bird thread | Show full conversation thread |
bird replies | List replies to a tweet |
bird user-tweets | Get user's tweets |
| Command | Description |
|---|---|
| --------- | ------------- |
bird home | Home timeline ("For You" feed) |
bird mentions | Tweets mentioning you |
bird likes | Your liked tweets |
bird bookmarks | Your bookmarked tweets |
| Command | Description |
|---|---|
| --------- | ------------- |
bird search | Search tweets |
bird news | AI-curated news from Explore |
bird trending | Trending topics |
| Command | Description |
|---|---|
| --------- | ------------- |
bird whoami | Show logged-in account |
bird check | Check credential availability |
bird follow | Follow a user |
bird unfollow | Unfollow a user |
bird followers | List your followers |
bird following | List users you follow |
bird lists | Your Twitter lists |
| 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 | Request timeout |
Reads from:
~/.config/bird/config.json5./.birdrc.json5Supports: chromeProfile, firefoxProfile, cookieTimeoutMs, timeoutMs, quoteDepth
| 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 |
# 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
Check that AUTH_TOKEN and CT0 are set and valid. Run bird check to verify.
Twitter tokens expire periodically. Re-copy from browser cookies.
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!
共 1 个版本