guzus/birdy
skills/birdy/SKILL.md
Install, operate, and troubleshoot birdy (multi-account proxy for the bird CLI on X/Twitter). Use when configuring birdy accounts/auth cookies, selecting rotation strategies, forwarding bird commands, setting up CI via BIRDY_ACCOUNTS, or debugging why bird/birdy-bird/bundled bird cannot be found or executed (Node 22+ requirement).
$ install --global
skillsauthnpx skillsauth add guzus/birdy birdyInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 28, 2026, 2:26 PM196.4s6 files scanned
SKILL.md
- name:
- birdy
- description:
- Install, operate, and troubleshoot birdy (multi-account proxy for the bird CLI on X/Twitter). Use when configuring birdy accounts/auth cookies, selecting rotation strategies, forwarding bird commands, setting up CI via BIRDY_ACCOUNTS, or debugging why bird/birdy-bird/bundled bird cannot be found or executed (Node 22+ requirement).
Birdy
Workflow
Use birdy to run bird commands through a rotating pool of X/Twitter sessions (auth cookies), reducing rate-limit risk.
0. Preflight (CLI Required)
If you need to run commands, ensure the birdy CLI is installed first:
bash skills/birdy/scripts/ensure_birdy.sh
birdy version
1. Install
Prefer the installer (bundles bird as birdy-bird):
curl -fsSL https://raw.githubusercontent.com/guzus/birdy/main/install.sh | bash
Notes:
- The installer requires GitHub CLI
gh. - Bundled
birdy-birdrequires Node>= 22.
Alternative installs:
# Installs birdy only (no bundled bird); you must provide bird yourself.
go install github.com/guzus/birdy@latest
2. Add Accounts
birdy needs two cookies per account: auth_token and ct0.
Optional: extract tokens automatically from your local browser cookies:
# Default tries Chrome, Safari, Firefox
bash skills/birdy/scripts/extract_x_tokens.sh
# Force a specific browser backend
bash skills/birdy/scripts/extract_x_tokens.sh --browsers chrome
# Pick a Chrome profile interactively (arrow keys)
bash skills/birdy/scripts/extract_x_tokens.sh --interactive
birdy account add personal
birdy account add work --auth-token "xxx" --ct0 "yyy"
birdy account list
Stored by default:
~/.config/birdy/accounts.json~/.config/birdy/state.json
3. Run Bird Commands Through Birdy
Any unknown command/flag is forwarded to bird using the selected account.
# Auto-rotate accounts
birdy home
birdy search "golang"
birdy read 1234567890
# Show which account was used
birdy -v home
# Force an account and skip rotation
birdy --account personal whoami
# Choose rotation strategy
birdy --strategy least-used home
4. Use In CI (Non-Interactive)
Provide accounts via BIRDY_ACCOUNTS JSON:
export BIRDY_ACCOUNTS='[{"name":"bot1","auth_token":"xxx","ct0":"yyy"}]'
birdy -v home
5. Troubleshoot Bird Detection
birdy locates the underlying bird command in this order:
BIRDY_BIRD_PATH(explicit override)birdy-birdonPATH(installed by the birdy installer)- Bundled package next to the
birdybinary atbird/dist/cli.js birdonPATH
Fixes:
- If
birdy-birdis installed but fails: ensurenodeis available andnode --versionis>= 22. - If you installed via
go install: install bird separately, or pointBIRDY_BIRD_PATHto a workingbird. - If running from a git clone: the repo vendors bird at
third_party/@steipete/bird/dist/cli.js.
Security
- Treat
auth_tokenandct0as secrets. - Avoid pasting tokens into logs; prefer environment variables and secrets managers in CI.
Related Skills
guzus/release-notes
tools
VerifiedTrustedCommunity
Generate release notes from git log between tags
4SKILL.mdUpdated Apr 15, 2026
openclaw/taskflow
tools
VerifiedTrustedCommunity
Use when work should span one or more detached tasks but still behave like one job with a single owner context. TaskFlow is the durable flow substrate under authoring layers like Lobster, ACPX, plugins, or plain code. Keep conditional logic in the caller; use TaskFlow for flow identity, child-task linkage, waiting state, revision-checked mutations, and user-facing emergence.
357,764SKILL.mdUpdated Apr 10, 2026
openclaw/extensions/lobster
tools
VerifiedTrustedCommunity
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
357,764SKILL.mdUpdated Apr 10, 2026
steipete/extensions/lobster
tools
VerifiedTrustedCommunity
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
357,588SKILL.mdUpdated Apr 13, 2026