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.
Scanned 9/7/2026
Install to Claude Code
Skills Directorynpx -y skills add modbender/skill-library-mcp --skill frigatebird --agent claude-codeInstalls into .claude/skills of the current project.
Are you the author of Frigatebird?
Add the live security badge to your README — it updates automatically with every re-scan.
[](https://www.skillsdirectory.com/skills/modbender-frigatebird)More formats (shields.io, HTML) on the badges page.
---
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
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.
Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.
No comments yet. Be the first to comment!
