frigatebird

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.

Safety Notice

This listing is from the official public ClawHub registry. Review SKILL.md and referenced scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "frigatebird" with this command: npx skills add oceanswave/frigatebird

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.

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Related Skills

Related by shared tags or category signals.

Coding

miaoda-app-chat-sync

Convert Git repository code to structured JSON instructions for AI agents. Fetches code from Git repositories (GitHub, GitLab, etc.), generates structured JS...

Registry SourceRecently Updated
Coding

Golang Modernize

Continuously modernize Golang code to use the latest language features, standard library improvements, and idiomatic patterns. Use this skill whenever writin...

Registry SourceRecently Updated
2040samber
Coding

Reliable Tool Context

Build reliable tool context from command output using artifacts and compact reproducible code queries.

Registry SourceRecently Updated
Coding

qwencloud-text

[QwenCloud] Generate text, have conversations, write code, reason, and call functions with Qwen models. TRIGGER when: user asks to chat with Qwen, generate t...

Registry SourceRecently Updated