- name
- frigatebird
- description
- 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.
- argument-hint
- whoami, read https://x.com/user/status/123, tweet "hello", article "Launch notes" "We shipped", add "AI News" @openai @anthropicai
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
- Validate auth/session:
- frigatebird check - frigatebird whoami
- Read flows (use JSON when scripting):
- frigatebird read <tweet-id-or-url> --json - frigatebird search "<query>" --json - frigatebird home --json
- Mutation flows:
- frigatebird tweet "<text>" - frigatebird reply <tweet-id-or-url> "<text>" - frigatebird article "<title>" "<body>"
- List automation:
- frigatebird add "<List Name>" @handle1 @handle2 - frigatebird remove @handle "<List Name>" - frigatebird batch accounts.json
- 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-idsis retained for command compatibility and does not drive Playwright execution.- Some GraphQL-specific behavior from original
birdis represented as compatibility flags in Playwright mode.