🎧 LISTEN TO THIS ARTICLE

X-Manager is a self-hosted X/Twitter management platform built for people who want full control over their social presence — and for AI agents that need to publish autonomously. Version 0.2.0 ships five new capability sprints that turn it from a simple scheduler into a complete command center.

What's New in v0.2.0

Agent Autonomy Foundation (Sprint 1)

Agents no longer need to poll. X-Manager now emits real-time events via Server-Sent Events (SSE) at /api/events/stream, so your bots can subscribe and react instantly to post completions, failures, new inbox items, and campaign progress. Bulk engagement actions let agents like, dismiss, reply, and repost up to 25 items in a single API call. An auto-scheduling endpoint picks the optimal posting time from your analytics data — no guesswork needed.

Webhook delivery got reliable too: retries with exponential backoff, delivery logs, and a test endpoint so you can verify your integration before going live.

Content Management (Sprint 2)

A proper media library for uploading, tagging, and reusing images across posts. No more re-uploading the same header image every time. Recurring and evergreen schedules let you set content on daily, weekly, monthly, or custom cron cycles — with content pool rotation so your audience doesn't see the same tweet twice.

Automation Engine (Sprint 3)

Event-driven workflows without writing code. Define rules with triggers (system events, cron schedules, or inbox keywords), add conditions (equals, contains, regex, greater-than, less-than), and attach actions (like, reply, repost, schedule post, send DM, tag, webhook, dismiss). The rule engine hooks directly into the event system, so automations fire in real time.

RSS feed monitoring auto-posts from your favorite feeds with configurable templates. Keyword monitoring watches for conversations matching your saved searches and can auto-engage or notify you.

Analytics & Tracking (Sprint 4)

A built-in URL shortener with click tracking and UTM parameter support. Every shortened link gets daily click breakdowns with privacy-preserving IP hashing. Follower growth tracking snapshots your count daily so you can chart trends over time. Full CSV and JSON export of all your post metrics for offline analysis or agent consumption.

UX Polish (Sprint 5)

Draft management UI for saving, editing, and scheduling drafts from a dedicated view. Tweet preview rendering with syntax-highlighted @mentions, #hashtags, and URLs — plus weighted character counting that correctly handles t.co URL wrapping. Content tagging on scheduled posts with tag-based filtering. Per-post approval workflows so sensitive content gets human sign-off before publishing. And global search across posts, inbox, campaigns, drafts, and templates.

Architecture

X-Manager runs as a single Next.js 15 application backed by SQLite. No external databases, no Redis, no message queues. Everything — the web UI, the scheduler, the automation engine, the API — runs in one process. Credentials are encrypted at rest with AES-256-GCM. The whole thing runs comfortably on a $5 VPS.

The Bridge API lets external bots publish through your connected X accounts with token auth, optional HMAC signing, and rate limiting. The agent manifest at /api/system/agent documents all 50+ endpoints with curl examples, so any LLM agent can discover and use the full API surface.

Why Self-Hosted?

Your API keys and OAuth tokens never leave your machine. No third-party SaaS sees your data. You own everything. In an era where platforms change their API terms monthly, that matters.

Get Started

git clone https://github.com/tylerbuilds/x-manager.git
cd x-manager
npm install
npm run dev

Open http://localhost:3999, paste your X API credentials in the setup panel, connect your account, and you're live.

GitHub: github.com/tylerbuilds/x-manager