Bird Twitter

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

Security Scan

This skill is a straightforward wrapper around the local 'bird' CLI and only requests the Twitter cookies (AUTH_TOKEN and CT0) that are required to operate; its files and instructions are consistent with that purpose.

Purpose & Capability

Name/description, required binary (bird), and required env vars (AUTH_TOKEN, CT0) all align: a CLI wrapper for Twitter/X legitimately needs a bird binary and Twitter auth cookies.

Instruction Scope

SKILL.md instructs the user to extract auth_token and ct0 from browser cookies — this is coherent with the declared env vars, but copying browser cookies is sensitive and could lead non-technical users to expose credentials if done carelessly. The included helper script only validates env vars and forwards arguments to bird; it does not access other files or external endpoints.

Install Mechanism

No install spec; this is an instruction-only skill that assumes a preinstalled 'bird' binary. The small included shell wrapper is harmless and merely checks environment variables then invokes bird.

Credentials

The skill requires only AUTH_TOKEN and CT0, which are exactly the credentials needed to authenticate to Twitter via the bird CLI. Those cookies grant full account capabilities (posting, following, etc.), so they should be treated as highly sensitive.

Persistence & Privilege

always is false and there is no install that persists code beyond the included script; the skill does not modify other skills or system config. Note: disable-model-invocation is false (platform default), so the agent could call the skill autonomously unless you change that setting.

Assessment

This skill appears coherent and small, but before installing: (1) only use a bird binary from a trusted source (verify upstream repo/releases), (2) treat AUTH_TOKEN and CT0 like full-account credentials — do not paste them into untrusted places or share them, and consider using a secondary account if you fear automation mistakes, (3) follow the SKILL.md cookie extraction instructions carefully to avoid copying unrelated cookies, (4) be aware the agent can call the skill autonomously by default (allowing it to post tweets), so consider disabling autonomous invocation or restricting the agent if you want manual control.

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!