← Back to Skills Marketplace

Bird Twitter

Name: Bird Twitter
Author: chuhuilove

by chuhuilove · GitHub ↗ · v1.0.0

cross-platform ✓ Security Clean

2928

Downloads

Stars

Active Installs

Versions

Install in OpenClaw

/install bird-twitter

Description

Twitter/X CLI wrapper using bird — post tweets, reply, read, search, and manage your timeline. Fast GraphQL-based X CLI.

README (SKILL.md)

Bird Twitter Skill 🐦

Fast Twitter/X CLI wrapper using bird — post tweets, reply, read, search, and manage your timeline via Twitter's GraphQL API.

Required Environment Variables

export AUTH_TOKEN=\x3Cyour_twitter_auth_token>
export CT0=\x3Cyour_twitter_ct0_cookie>

How to Get Tokens

Log in to Twitter/X in your browser
Open Developer Tools (F12)
Go to Application/Storage → Cookies → twitter.com
Copy:
- auth_token → AUTH_TOKEN
- ct0 → CT0

Quick Usage

# Check login status
bird whoami

# Check credential availability
bird check

# Post a tweet
bird tweet "Hello from bird-twitter skill!"

# Reply to a tweet
bird reply \x3Ctweet-id-or-url> "Great thread!"

# Read a tweet
bird read \x3Ctweet-id-or-url>

# Read with JSON output
bird read \x3Ctweet-id-or-url> --json

# Search tweets
bird search "query"

# Get home timeline
bird home

# Get mentions
bird mentions

# Get liked tweets
bird likes

# Follow a user
bird follow \x3Cusername>

# Get user's tweets
bird user-tweets \x3Chandle>

# Get trending topics
bird news
bird trending

Commands

Posting

Command	Description
`bird tweet \x3Ctext>`	Post a new tweet
`bird reply \x3Curl> \x3Ctext>`	Reply to a tweet
`bird tweet \x3Ctext> --media \x3Cpath>`	Tweet with media (up to 4 images or 1 video)

Reading

Command	Description
`bird read \x3Curl>`	Read/fetch a tweet
`bird thread \x3Curl>`	Show full conversation thread
`bird replies \x3Curl>`	List replies to a tweet
`bird user-tweets \x3Chandle>`	Get user's tweets

Timelines

Command	Description
`bird home`	Home timeline ("For You" feed)
`bird mentions`	Tweets mentioning you
`bird likes`	Your liked tweets
`bird bookmarks`	Your bookmarked tweets

Search & Discovery

Command	Description
`bird search \x3Cquery>`	Search tweets
`bird news`	AI-curated news from Explore
`bird trending`	Trending topics

Account Management

Command	Description
`bird whoami`	Show logged-in account
`bird check`	Check credential availability
`bird follow \x3Cuser>`	Follow a user
`bird unfollow \x3Cuser>`	Unfollow a user
`bird followers`	List your followers
`bird following`	List users you follow
`bird lists`	Your Twitter lists

Output Options

Option	Description
`--json`	JSON output
`--json-full`	Include raw API response
`--plain`	Plain text (no emoji, no color)
`--no-emoji`	Disable emoji
`--no-color`	Disable ANSI colors
`--timeout \x3Cms>`	Request timeout

Configuration

Reads from:

~/.config/bird/config.json5
./.birdrc.json5

Supports: chromeProfile, firefoxProfile, cookieTimeoutMs, timeoutMs, quoteDepth

Environment Variables

Variable	Description
`AUTH_TOKEN`	Required — Twitter auth_token cookie
`CT0`	Required — Twitter ct0 cookie
`NO_COLOR`	Disable colors
`BIRD_TIMEOUT_MS`	Default timeout
`BIRD_COOKIE_TIMEOUT_MS`	Cookie extraction timeout
`BIRD_QUOTE_DEPTH`	Max quoted tweet depth

Examples

# Check who's logged in
bird whoami

# Post a simple tweet
bird tweet "Hello world from OpenClaw!"

# Post with an image
bird tweet "Check this out!" --media ./image.png

# Reply to a tweet
bird reply 1234567890123456789 "Thanks for sharing!"

# Search for tweets about AI
bird search "artificial intelligence" --json

# Get your home timeline
bird home -n 20

# Read a tweet thread
bird thread https://x.com/user/status/1234567890

# Get trending topics
bird trending

Troubleshooting

401 Unauthorized

Check that AUTH_TOKEN and CT0 are set and valid. Run bird check to verify.

Token Expired

Twitter tokens expire periodically. Re-copy from browser cookies.

Rate Limited

Twitter GraphQL API has rate limits. Wait a few minutes and retry.

TL;DR: Fast Twitter/X CLI via bird. Set AUTH_TOKEN and CT0, then tweet, read, search, and manage your timeline!

Usage Guidance

This skill appears coherent and small, but before installing: (1) only use a bird binary from a trusted source (verify upstream repo/releases), (2) treat AUTH_TOKEN and CT0 like full-account credentials — do not paste them into untrusted places or share them, and consider using a secondary account if you fear automation mistakes, (3) follow the SKILL.md cookie extraction instructions carefully to avoid copying unrelated cookies, (4) be aware the agent can call the skill autonomously by default (allowing it to post tweets), so consider disabling autonomous invocation or restricting the agent if you want manual control.

Capability Analysis

Type: OpenClaw Skill Name: bird-twitter Version: 1.0.0 The skill bundle is a transparent wrapper for the `bird` CLI tool, designed to interact with the Twitter/X API. It explicitly declares its need for `AUTH_TOKEN` and `CT0` environment variables in `SKILL.md` and `_meta.json`, and the `lib/bird-helper.sh` script validates their presence before executing the `bird` command. The script safely passes arguments using `bird "$@"`, preventing simple shell injection. There is no evidence of data exfiltration, persistence mechanisms, obfuscation, or malicious prompt injection attempts in the `SKILL.md` file. The skill's functionality aligns with its stated purpose of providing a Twitter CLI interface.

Capability Assessment

✓ Purpose & Capability

Name/description, required binary (bird), and required env vars (AUTH_TOKEN, CT0) all align: a CLI wrapper for Twitter/X legitimately needs a bird binary and Twitter auth cookies.

ℹ Instruction Scope

SKILL.md instructs the user to extract auth_token and ct0 from browser cookies — this is coherent with the declared env vars, but copying browser cookies is sensitive and could lead non-technical users to expose credentials if done carelessly. The included helper script only validates env vars and forwards arguments to bird; it does not access other files or external endpoints.

✓ Install Mechanism

No install spec; this is an instruction-only skill that assumes a preinstalled 'bird' binary. The small included shell wrapper is harmless and merely checks environment variables then invokes bird.

ℹ Credentials

The skill requires only AUTH_TOKEN and CT0, which are exactly the credentials needed to authenticate to Twitter via the bird CLI. Those cookies grant full account capabilities (posting, following, etc.), so they should be treated as highly sensitive.

✓ Persistence & Privilege

always is false and there is no install that persists code beyond the included script; the skill does not modify other skills or system config. Note: disable-model-invocation is false (platform default), so the agent could call the skill autonomously unless you change that setting.

How to Use

Make sure OpenClaw is installed (local or Docker)
Run the install command in chat: /install bird-twitter
After installation, invoke the skill by name or use /bird-twitter
Provide required inputs per the skill's parameter spec and get structured output

Version History

v1.0.0

Initial release - Twitter/X CLI wrapper using bird

Metadata

Slug bird-twitter

Version 1.0.0

License —

All-time Installs 27

Active Installs 27

Total Versions 1

Frequently Asked Questions

What is Bird Twitter?

Twitter/X CLI wrapper using bird — post tweets, reply, read, search, and manage your timeline. Fast GraphQL-based X CLI. It is an AI Agent Skill for Claude Code / OpenClaw, with 2928 downloads so far.

How do I install Bird Twitter?

Run "/install bird-twitter" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Bird Twitter free?

Yes, Bird Twitter is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Bird Twitter support?

Bird Twitter is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Bird Twitter?

It is built and maintained by chuhuilove (@chuhuilove); the current version is v1.0.0.

More Skills