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
tweet-cli post "Your tweet text here"
tweet-cli reply <tweet-id-or-url> "Your reply text"
tweet-cli reply https://x.com/user/status/123456 "Your reply text"
tweet-cli quote <tweet-id-or-url> "Your commentary"
tweet-cli quote https://x.com/user/status/123456 "Your commentary"
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.