Post, schedule, and track X (Twitter) engagement straight from your terminal — real API v2, zero pip dependencies, no monthly SaaS fee.
No purchase needed. These are real, usable guides — not a teaser.
| File | Description |
|---|---|
lite/x-twitter-auto-mini-guide.md |
Condensed strategy guide — what the tool does, core auth/scheduling/analytics concepts, and how to get value in 5 minutes |
lite/5-ai-prompts.md |
5 copy-paste AI prompts for hooks, threads, replies, repurposing, and content calendars |
lite/quick-start-checklist.md |
Step-by-step checklist to get your X account and API access automation-ready |
The full product is a complete, zero-dependency Python CLI that automates posting, scheduling, and analytics against Twitter's real API v2 — plus an AI-assistant integration (SKILL.md) so tools like Claude or Hermes Agent can run it via natural language.
| Component | Why it matters |
|---|---|
| Post + Media Tweets — text, images, video, replies, quote tweets | Full posting capability, not just plain text |
Built-in Scheduler — cron-style schedule add/list/run plus a daemon mode |
Queue tweets for specific times; no external scheduling SaaS needed |
| Analytics Dashboard — likes, retweets, replies, quotes, impressions, engagement rate | See what's working without opening the X app |
| Timeline + Search — view your recent tweets with stats, search by keyword | Monitor your presence and find conversations worth joining |
| Profile + User Lookup — your profile, any user's public stats | Fast lookups without switching context |
| Engagement Tracking — see exactly who liked and retweeted each tweet | Identify your most engaged followers |
| SKILL.md — AI Assistant Integration | Tell your AI assistant "post this thread" and it executes via the CLI |
Zero dependencies — Python stdlib only (urllib, hmac, hashlib) |
No tweepy, no requests, no supply-chain risk |
| OAuth 1.0a + OAuth 2.0 Bearer Token | Proper cryptographic auth — tokens don't expire like cookie-based bots |
Runs on Windows, macOS, or Linux — laptop or VPS. Works entirely on Twitter's free API tier (500 posts/month, $0/month).
Get the full product: aiinvention.gumroad.com/l/x-twitter-auto
- Solo creators who want to post and track X engagement from their terminal instead of a browser tab
- Developers who prefer CLI tools over another SaaS dashboard subscription
- AI assistant users (Claude, Hermes Agent, etc.) who want their assistant to manage X posting on command
- Anyone tired of cookie-based "automation" tools that break every time X changes its UI
It's not built for agencies running 10+ accounts at high volume — that use case needs Twitter's Enterprise API with a multi-tenant setup.
This lite version is a living resource. What's missing? What would make the checklist or prompts more useful for your workflow? Open an issue or a discussion — real feedback shapes what goes into the next update of both the free and full versions.
If the lite guide, checklist, or prompts saved you time, a star on this repo helps other creators find it. It also tells us to keep improving the free tier.
Built by AI Invention