Titen
titen (Javanese): to watch closely, to observe with care.
Self-hosted Threads management platform. Post, schedule, and analyze Threads content from your own infrastructure.
Why Titen?
Threads has no native post scheduling. Existing tools are SaaS products where your API tokens live on someone else's server. Titen runs on your box, talks directly to the Threads Graph API, and stores everything in a single SQLite file.
No subscription. No vendor lock-in. Your tokens stay on your machine, encrypted at rest with AES-256-GCM.
Features
| Capability | Details | |---|---| | Multi-account | Manage multiple Threads accounts in one instance | | Post scheduling | Cron-based scheduler for automated posting that Threads itself does not offer | | Comment fetching | Pull comments from the Threads API, store locally | | Sentiment analysis | Pluggable engine trait (stub default; ONNX/LLM/custom API extensible) | | Analytics | Time-series snapshots per post | | Media storage | S3-compatible via swappable storage trait | | MCP server | JSON-RPC 2.0 over stdio, compatible with Claude Desktop, Cursor, etc. | | CLI | Full CRUD from the terminal | | Docker | Single container, minimal footprint |
Architecture
Detailed docs: Deployment Guide · Usage Guide · Architecture Overview · Auth Flow · Changelog
4 crates, one binary each:
| Crate | Purpose | |---|---| | titen-core | Domain logic: models, SQLite store, Threads API client, sentiment trait, scheduler, S3 storage, AES-256-GCM encryption | | titen-api | Axum HTTP server: REST API, API key auth, CORS, rate limiting | | titen-cli | Clap CLI: all operations via the HTTP API | | titen-mcp | MCP stdio server: 29 tools for AI agent integration |
11 SQLite tables: accounts, posts, schedules, comments, analyticssnap, mediaassets, ratetracking, encryptionmeta, mentions, appsettings, sessions.
14 migrations: 001initial (schema), 002droprefreshtoken, 003addappsecret, 004encrypttokens (encrypts existing plaintext tokens on startup), 005hitlscheduling, 006mentionstable, 007mediaurlsdoc, 008commentreplystatus, 009appsettings, 010locationtagging, 011sessionstable, 012postpermalink, 013normalizetimestamps, 014schedulereplyto.
Quick Start
Install (pre-built binary)
curl -sSL https://github.com/codecoradev/titen/releases/latest/download/install.sh | sh