X Queue — Scheduled Tweet Posting

X Queue is a scheduled tweet posting engine. Add tweets with a future timestamp to a JSON queue file, run the script on a cron, it posts them when they're due and updates status.

Used by Varconi internally at @MarcoGTMAI — runs at 9 AM and 3 PM UTC daily.

Dead simple design: → Queue is a plain JSON array — any agent or script can append to it → Run queue.py on a cron — posts anything due, marks it posted → Failed tweets are marked with the error — never silently dropped → --list to see queue status at a glance → --add to add tweets from the CLI → --dry-run to preview without posting

The composability angle: pair with any LLM agent that generates tweet content. The agent writes to the queue file. X Queue handles the posting. Full autonomous content pipeline — zero manual steps.

---

What's included: → queue.py — posting engine + CLI (add/list/dry-run) → Queue format: id, text, status, scheduled, posted_at, tweet_id, url → Status tracking: pending → posted / failed → No config file needed — just x_api.json credentials

Requires: X API key (read + write only — no LLM needed)