bird

# bird 🐦 Fast X/Twitter CLI using GraphQL + cookie auth. ## Install ```bash # npm/pnpm/bun npm install -g @steipete/bird # Homebrew (macOS, prebuilt binary) brew install steipete/tap/bird # One-shot (no install) bunx @steipete/bird whoami ``` ## Authentication `bird` uses cookie-based auth. Use `--auth-token` / `--ct0` to pass cookies directly, or `--cookie-source` for browser cookies. Run `bird check` to see which source is active. For Arc/Brave, use `--chrome-profile-dir <path>`. ## Commands ### Account & Auth ```bash bird whoami # Show logged-in account bird check # Show credential sources bird query-ids --fresh # Refresh GraphQL query ID cache ``` ### Reading Tweets ```bash bird read <url-or-id> # Read a single tweet bird <url-or-id> # Shorthand for read bird thread <url-or-id> # Full conversation thread bird replies <url-or-id> # List replies to a tweet ``` ### Timelines ```bash bird home # Home timeline (For You) bird home --following # Following timeline bird user-tweets @handle -n 20 # User's profile timeline bird mentions # Tweets mentioning you bird mentions --user @handle # Mentions of another user ``` ### Search ```bash bird search "query" -n 10 bird search "from:steipete" --all --max-pages 3 ``` ### News & Trending ```bash bird news -n 10 # AI-curated from Explore tabs bird news --ai-only ...