twitter-api

name	twitter-api
description	Post, quote, reply to, and delete X (Twitter) tweets via the local X CLI script using API keys. Use when the user asks to tweet, quote tweet, reply, or delete on X/Twitter.
metadata	{"author":"0.zo.computer","category":"Community","display-name":"Post to X (Twitter)","emoji":"🐦"}

X (Twitter) API CLI

Post, quote, reply to, and delete tweets using the local X CLI script in Community/twitter-api/scripts/.

Setup

The USER must complete these steps in the X Developer Portal:

1. Sign in with their X account.
2. Create a new project (or use the default).
3. Create a new app under the project.
4. Change the app permissions to Read & Write before generating keys.
5. Go to the app's "Keys and Tokens" tab and generate:
   • API Key and Secret (Consumer Keys)
   • Access Token and Secret (User Context)

Then the USER must set secrets in Settings > Developers or export them locally:

• X_API_KEY
• X_API_KEY_SECRET (or X_API_SECRET)
• X_ACCESS_TOKEN
• X_ACCESS_TOKEN_SECRET (or X_ACCESS_SECRET)

Optional local setup: copy scripts/.env.example to scripts/.env and fill in values.

If required keys are missing, stop and ask the user to configure them before posting.

Commands

Run from Community/twitter-api/scripts/:

bun x.ts post "Your tweet text here"
bun x.ts quote https://x.com/user/status/123 "Your commentary"
bun x.ts reply https://x.com/user/status/123 "Your reply text"
bun x.ts delete https://x.com/user/status/123

Media

Attach media by repeating --media:

bun x.ts post --media /path/to/image.png "Caption"
bun x.ts quote https://x.com/user/status/123 --media /path/to/image.png "Commentary"

Notes

• Max length is 280 characters. If over, trim before posting.
• Use actual line breaks in the shell for multi-paragraph tweets.
• Tweet IDs or full URLs are accepted for quote/reply/delete.