Expected topology
Run the server on a VPS, homelab host, or private cloud node. Place it behind WireGuard when possible. Install collectors on Windows, macOS, Linux, and remote development boxes that use Claude Code.
Planned components
- FastAPI ingest and analytics service.
- Postgres for durable normalized telemetry.
- SQLite queue on each collector machine.
- Vue dashboard served by the tokemetry server.
- Optional alert delivery through ntfy, Telegram, SMTP, or custom webhooks.
Packaging roadmap
Docker Compose, service units, and collector install guides are planned after core ingest, analytics, and dashboard behavior are stable.