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

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