What problem does it solve?
It eliminates the manual, error-prone process of composing actions on X (Twitter) by providing a simple local CLI workflow for posting, quoting, replying, and deleting tweets.
Core Features & Use Cases
- Tweet posting with validation: Enforces the 280-character limit before sending a request to the X API.
- Quote and reply automation: Supports quoting or replying to a tweet using either a tweet ID or a full status URL.
- Optional media uploads: Attaches one or more images by specifying repeated --media file paths.
- Use case: When you need to publish frequent updates (including threads with follow-up replies and occasional quote posts) and want consistent formatting, media attachment, and repeatable execution from your environment.
Quick Start
Set your X API keys as environment variables (X_API_KEY, X_API_KEY_SECRET, X_ACCESS_TOKEN, X_ACCESS_TOKEN_SECRET), then run the post command to publish your tweet text.