bird-fast

Post tweets, read threads, and search X/Twitter from the terminal using the bird CLI.

1|Updated May 6, 2026
One-click install
npx skills add https://github.com/surfingalien/FinSurfing --skill bird-fast-surfingalien
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bird-fast
Source: https://github.com/surfingalien/FinSurfing/tree/main/.claude/skills/bird-fast
Command: npx skills add https://github.com/surfingalien/FinSurfing --skill bird-fast-surfingalien

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Automating Twitter/X interactions normally requires API keys, OAuth setup, and paid developer access. This Skill lets you post tweets, read threads, search content, and monitor mentions directly from the terminal by reusing your existing browser session, with no API credentials to configure. ## Core Features & Use Cases - Tweet Lifecycle Management: Post tweets and replies with media attachments (images, GIFs, videos) and alt text, read single tweets, full threads, and replies. - Search & Monitoring: Run advanced Twitter searches, check mentions, and list bookmarks with JSON output for scripting. - Zero-Config Authentication: Extracts auth cookies automatically from Safari, Chrome, or Firefox, with environment variable and CLI flag overrides. - Use Case: A developer wants to monitor brand mentions and auto-reply from a cron job. They run bird mentions -n 50 --json, parse results with jq, and post replies via bird reply — all without registering a Twitter developer app. ## Quick Start Ask the assistant to post a tweet saying "Hello from the terminal" using the bird CLI after verifying authentication with bird whoami.

Frequently Asked Questions about bird-fast

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I post a tweet from the command line?

Install the bird CLI via npm (`npm install -g @steipete/bird`) or Homebrew, then run `bird tweet "your message"`. Authentication is automatic if you are logged into x.com in Safari, Chrome, or Firefox.

How to search Twitter without API keys?

The bird CLI uses Twitter's internal GraphQL API with cookies extracted from your browser session, so no developer account or API keys are needed. Run `bird search "query" -n 20` with support for advanced operators like from:, since:, and filter:links.

Can I attach images or videos to tweets from a script?

Yes, use the --media flag with up to 4 images/GIFs or 1 video per tweet, and add --alt for accessibility text. Videos cannot be mixed with images in a single tweet.

Why does bird show a 'No auth token found' error?

This error means no valid x.com session was found in your browsers. Log into x.com in Safari, Chrome, or Firefox, or set the AUTH_TOKEN and CT0 environment variables manually, then verify with `bird whoami`.

What are the limitations of using browser cookies for Twitter automation?

Cookie-based access depends on Twitter's internal APIs, which can change without notice and break functionality. Rate limits apply, error 226 may trigger automation detection, and sessions expire when you log out of the browser.