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
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
