ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

bird-twitter

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

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/chuhuilove/bird-twitter
Or

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_tokenAUTH_TOKEN
    • ct0CT0

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

CommandDescription
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

CommandDescription
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

CommandDescription
bird homeHome timeline ("For You" feed)
bird mentionsTweets mentioning you
bird likesYour liked tweets
bird bookmarksYour bookmarked tweets

Search & Discovery

CommandDescription
bird search <query>Search tweets
bird newsAI-curated news from Explore
bird trendingTrending topics

Account Management

CommandDescription
bird whoamiShow logged-in account
bird checkCheck credential availability
bird follow <user>Follow a user
bird unfollow <user>Unfollow a user
bird followersList your followers
bird followingList users you follow
bird listsYour Twitter lists

Output Options

OptionDescription
--jsonJSON output
--json-fullInclude raw API response
--plainPlain text (no emoji, no color)
--no-emojiDisable emoji
--no-colorDisable ANSI colors
--timeout <ms>Request timeout

Configuration

Reads from:

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

Supports: chromeProfile, firefoxProfile, cookieTimeoutMs, timeoutMs, quoteDepth

Environment Variables

Metadata

Stars2387
Views0
Updated2026-03-09
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-chuhuilove-bird-twitter": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Tags

#twitter#x#tweet#social#timeline#search
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.