tweet-cli

Post tweets, replies, and quotes to X/Twitter using the official API v2. Use this instead of bird for posting. Uses API credits so only post when explicitly asked or scheduled.

promptBeginner5 min to valuemarkdown

4 views

Feb 21, 2026

Loading actions...

tweet-cli

Post to X/Twitter using the official API v2. This tool uses API credits (limited to 1,500 posts/month on the Free tier), so only use it when the user explicitly asks you to post, or during scheduled cron tasks. Do not speculatively draft and post tweets.

For reading tweets, searching, and browsing timelines, use bird instead (no credit cost).

Setup

Install (pinned to release tag):

npm install -g github:0xmythril/tweet-cli#v1.0.0

Get API keys from https://developer.x.com/en/portal/dashboard (Free tier works)
Configure credentials (file is created with restricted permissions):

mkdir -p ~/.config/tweet-cli
touch ~/.config/tweet-cli/.env
chmod 600 ~/.config/tweet-cli/.env
cat > ~/.config/tweet-cli/.env << 'EOF'
X_API_KEY=your_consumer_key
X_API_SECRET=your_secret_key
X_ACCESS_TOKEN=your_access_token
X_ACCESS_TOKEN_SECRET=your_access_token_secret
EOF

Verify: tweet-cli whoami

Security

Credentials: Stored in ~/.config/tweet-cli/.env (read by dotenv at runtime). Set chmod 600 to restrict access.
No postinstall scripts: The package has zero install scripts — verify via npm pack --dry-run or inspect package.json.
No telemetry or network calls except to the official X API (api.x.com) when you run a command.
Pinned install: The install command pins to a specific release tag. Audit the source at https://github.com/0xmythril/tweet-cli before installing.
Dependencies: Only 3 runtime deps — twitter-api-v2 (official X API client), commander (CLI parsing), dotenv (env file loading). No transitive dependencies.

Commands

Verify auth

tweet-cli whoami

Post a tweet

tweet-cli post "Your tweet text here"

Reply to a tweet

tweet-cli reply <tweet-id-or-url> "Your reply text"
tweet-cli reply https://x.com/user/status/123456 "Your reply text"

Quote a tweet

tweet-cli quote <tweet-id-or-url> "Your commentary"
tweet-cli quote https://x.com/user/status/123456 "Your commentary"

Delete a tweet

tweet-cli delete <tweet-id-or-url>

Important rules

Do NOT post unless the user explicitly asks or a cron job triggers it. Each post uses API credits.
Always confirm with the user before posting, replying, or quoting. Show them the text first.
For reading tweets, searching, or viewing timelines, use bird (not tweet-cli).
tweet-cli accepts both raw tweet IDs and full URLs (x.com or twitter.com).
If you get a 402 CreditsDepleted error, inform the user their monthly credits are exhausted.

View Original Source

Related Skills

Openclaw

PromptBeginner5 minmarkdown

Clawlett

Secure token swaps and Trenches trading on **Base Mainnet**, powered by Safe + Zodiac Roles.

Feb 13, 2026

Openclaw

PromptBeginner5 minmarkdown

frame-builder

Build in public with vibe raising. Launch your builder coin and ship products under it — every launch compounds funding and traction back to your builder. Claim vesting rewards and trading fees. Gas-free on Frame (Base).

Feb 12, 2026

Openclaw

PromptBeginner5 minmarkdown

aisa-provider

Configure AIsa as a first-class model provider for OpenClaw, enabling production access to major Chinese AI models (Qwen, DeepSeek, Kimi K2.5, Doubao) through official partnerships with Alibaba Cloud, BytePlus, and Moonshot. Use this skill when the user wants to set up Chinese AI models, configure AIsa API access, compare pricing between AIsa and other providers (OpenRouter, Bailian), switch between Qwen/DeepSeek/Kimi models, or troubleshoot AIsa provider configuration in OpenClaw. Also use when the user mentions AISA_API_KEY, asks about Chinese LLM pricing, Kimi K2.5 setup, or needs help with Qwen Key Account setup.

Feb 21, 2026

tweet-cli

For reading tweets, searching, and browsing timelines, use bird instead (no credit cost).

Setup

Install (pinned to release tag):

npm install -g github:0xmythril/tweet-cli#v1.0.0

Get API keys from https://developer.x.com/en/portal/dashboard (Free tier works)
Configure credentials (file is created with restricted permissions):

mkdir -p ~/.config/tweet-cli
touch ~/.config/tweet-cli/.env
chmod 600 ~/.config/tweet-cli/.env
cat > ~/.config/tweet-cli/.env << 'EOF'
X_API_KEY=your_consumer_key
X_API_SECRET=your_secret_key
X_ACCESS_TOKEN=your_access_token
X_ACCESS_TOKEN_SECRET=your_access_token_secret
EOF

Verify: tweet-cli whoami

Security

Credentials: Stored in ~/.config/tweet-cli/.env (read by dotenv at runtime). Set chmod 600 to restrict access.
No postinstall scripts: The package has zero install scripts — verify via npm pack --dry-run or inspect package.json.
No telemetry or network calls except to the official X API (api.x.com) when you run a command.
Pinned install: The install command pins to a specific release tag. Audit the source at https://github.com/0xmythril/tweet-cli before installing.
Dependencies: Only 3 runtime deps — twitter-api-v2 (official X API client), commander (CLI parsing), dotenv (env file loading). No transitive dependencies.

Commands

Verify auth

tweet-cli whoami

Post a tweet

tweet-cli post "Your tweet text here"

Reply to a tweet

tweet-cli reply <tweet-id-or-url> "Your reply text"
tweet-cli reply https://x.com/user/status/123456 "Your reply text"

Quote a tweet

tweet-cli quote <tweet-id-or-url> "Your commentary"
tweet-cli quote https://x.com/user/status/123456 "Your commentary"

Delete a tweet

tweet-cli delete <tweet-id-or-url>

Important rules

Do NOT post unless the user explicitly asks or a cron job triggers it. Each post uses API credits.
Always confirm with the user before posting, replying, or quoting. Show them the text first.
For reading tweets, searching, or viewing timelines, use bird (not tweet-cli).
tweet-cli accepts both raw tweet IDs and full URLs (x.com or twitter.com).
If you get a 402 CreditsDepleted error, inform the user their monthly credits are exhausted.