Smithery Logo
MCPsSkillsDocsPricing
Login
Smithery Logo

Accelerating the Agent Economy

Resources

DocumentationPrivacy PolicySystem Status

Company

PricingAboutBlog

Connect

© 2026 Smithery. All rights reserved.

    oceanswave

    frigatebird

    oceanswave/frigatebird
    Communication
    2

    About

    SKILL.md

    Install

    Install via Skills CLI

    or add to your agent
    • Claude Code
      Claude Code
    • Codex
      Codex
    • OpenClaw
      OpenClaw
    • Cursor
      Cursor
    • Amp
      Amp
    • GitHub Copilot
      GitHub Copilot
    • Gemini CLI
      Gemini CLI
    • Kilo Code
      Kilo Code
    • Junie
      Junie
    • Replit
      Replit
    • Windsurf
      Windsurf
    • Cline
      Cline
    • Continue
      Continue
    • OpenCode
      OpenCode
    • OpenHands
      OpenHands
    • Roo Code
      Roo Code
    • Augment
      Augment
    • Goose
      Goose
    • Trae
      Trae
    • Zencoder
      Zencoder
    • Antigravity
      Antigravity
    ├─
    ├─
    └─

    About

    Use the frigatebird npm package to interact with X from the CLI with bird-style command parity, posting/reply/article support, and list automation without X API keys.

    SKILL.md

    Frigatebird Skill

    Frigatebird is a Playwright-first CLI and npm package (frigatebird) that preserves bird command ergonomics while running against X via browser session cookies.

    Use This Skill When

    • The user asks for bird-style CLI workflows on X.
    • The user needs posting/reply/article actions from CLI.
    • The user needs list automation (add, remove, batch, lists).
    • The user needs API-key-free browser-cookie operation.

    Package and Install

    • npm package: frigatebird
    • Global install: npm install -g frigatebird
    • Local use: npx frigatebird <command>

    Core Workflow

    1. Validate auth/session:
      • frigatebird check
      • frigatebird whoami
    2. Read flows (use JSON when scripting):
      • frigatebird read <tweet-id-or-url> --json
      • frigatebird search "<query>" --json
      • frigatebird home --json
    3. Mutation flows:
      • frigatebird tweet "<text>"
      • frigatebird reply <tweet-id-or-url> "<text>"
      • frigatebird article "<title>" "<body>"
    4. List automation:
      • frigatebird add "<List Name>" @handle1 @handle2
      • frigatebird remove @handle "<List Name>"
      • frigatebird batch accounts.json
    5. For larger reads, use paging controls:
      • --all, --max-pages, --cursor, -n

    Feature Coverage

    • Posting/mutations: tweet, post, reply, article, like, retweet, follow, unfollow, unbookmark
    • Read/timelines: read, replies, thread, search, mentions, user-tweets, home, bookmarks, likes, list-timeline, news, about
    • Identity/health: check, whoami, query-ids, help
    • List automation: add, remove, batch, lists, list, refresh

    Options That Matter Most

    • Auth/cookies: --auth-token, --ct0, --cookie-source, --chrome-profile, --firefox-profile
    • Determinism/testing: --base-url, --plain, --no-color
    • Pagination: -n, --all, --max-pages, --cursor, --delay
    • Output: --json, --json-full
    • Media posting: --media, --alt

    Live E2E Notes

    • Standard live mutation e2e does not run premium-feature checks by default.
    • Premium-feature e2e opt-in:
      • npm run test:e2e:live -- --list-name <name> --enable-premium-features-e2e --article-cookie-source chrome --article-expected-handle-prefix <prefix>

    Caveats

    • This tool depends on X web UI selectors; selector drift can break flows.
    • query-ids is retained for command compatibility and does not drive Playwright execution.
    • Some GraphQL-specific behavior from original bird is represented as compatibility flags in Playwright mode.
    Recommended Servers
    Browser tool
    Browser tool
    X (Twitter)
    X (Twitter)
    Vercel Grep
    Vercel Grep
    Repository
    oceanswave/frigatebird
    Files