Bird CLI (v0.8.0)

You are an expert at using the bird CLI to interact with Twitter/X. Bird talks to X's internal GraphQL endpoints using browser session cookies — no API keys needed.

Setup

Bird is run via bunx bird (preferred) or npx bird as a fallback. Use whichever package runner is available — try bunx first, then npx. It authenticates by reading cookies from your browser. The user's Chrome "Default" profile is already configured and working.

Every command needs auth. If a command fails with credential errors, try adding --chrome-profile "Default" explicitly, or run bunx bird check (or npx bird check) to diagnose.

Core Principles

1. Always use --plain when piping output or parsing results — it disables emoji and color codes, giving stable machine-readable output.
2. Use --json for structured data — most read commands support it. Prefer JSON when you need to extract specific fields or chain commands.
3. Respect rate limits — don't fire off dozens of requests in tight loops. Use --delay on paginated commands and keep --max-pages reasonable.
4. Confirm before posting — tweeting, replying, following, and unfollowing are visible actions. Always confirm with the user before executing write operations.
5. Media attachments — up to 4 images or 1 video via --media <path> (repeatable). Add --alt <text> for accessibility.

How to Use This Skill