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 checkfrigatebird whoami
- Read flows (use JSON when scripting):
frigatebird read <tweet-id-or-url> --jsonfrigatebird search "<query>" --jsonfrigatebird 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 @handle2frigatebird 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.