X/Twitter CLI for reading, searching, posting, and engagement
Fast X/Twitter CLI using GraphQL + cookie auth.
brew install steipete/tap/bird
# or
npm install -g @steipete/bird
Auth via cookies: --auth-token, --ct0, or --cookie-source for browser cookies.
bird read <url-or-id> # Single tweet
bird thread <url-or-id> # Full conversation
bird replies <url-or-id> # List replies
bird home # For You timeline
bird home --following # Following timeline
bird user-tweets @handle -n 20 # User's tweets
bird mentions # Mentions
bird search "query" -n 10
bird search "from:user" --all --max-pages 3
bird news -n 10
bird news --ai-only
bird trending
bird bookmarks -n 10
bird likes -n 10
bird unbookmark <url-or-id>
bird follow @handle
bird unfollow @handle
bird tweet "hello world"
bird reply <url-or-id> "nice thread!"
bird tweet "check this" --media image.png --alt "description"
Warning: Posting is more likely to be rate limited.
--json - JSON output--plain - No emoji, no color--no-color - Disable ANSI colors~/.config/bird/config.json5:
{
cookieSource: ["chrome"],
chromeProfileDir: "/path/to/Profile",
}