Claudlytics: Self-Hosted Dashboard for Tracking Claude Code Token Usage and Costs
What Claudlytics Does
Claudlytics is a self-hosted dashboard that tracks Claude Code token usage and costs in real time. It's specifically useful for developers running Claude Code headlessly on remote VPS or servers where the desktop app's local machine tracking isn't sufficient.
How It Works
Claude Code writes every conversation to ~/.claude/projects/**/*.jsonl files. Claudlytics reads these files, parses the token usage, and calculates costs using Sonnet 4.6 pricing. No Claude API calls are needed for basic usage — everything is processed locally.
Dashboard Features
- Current session token counts and cost
- Rolling 5-hour window usage with reset countdown (aligns with Claude Pro/Max session limits)
- Today / Last 7 days / Billing cycle breakdowns
- Session and weekly message counts
Setup and Installation
Setup requires three commands:
git clone https://github.com/iansugerman/Claudlytics.git
cd Claudlytics
node server.jsAfter running these commands, open http://localhost:3031 in your browser.
Security and Remote Access
The server binds to 127.0.0.1 only, so it's never publicly exposed. For remote server access, use an SSH tunnel:
ssh -L 3031:localhost:3031 user@your-serverThen browse to localhost:3031 on your local machine.
Production Deployment
Claudlytics can run as a systemd service for background availability. Full instructions are available in the GitHub repository's README.
📖 Read the full source: r/ClaudeAI
👀 See Also
HomeButler: MCP Server for Managing Homelab Servers from Claude Without API Keys
HomeButler is an MCP server that lets Claude install, monitor, and manage self-hosted apps on homelab servers without requiring API keys. It runs locally, keeps everything on your network, and was built with Claude Code.
Hollow Agent OS: Local AI workers call Claude as senior architect when stuck
Hollow Agent OS uses local Qwen models that run 24/7, but when they hit logic errors or need major changes, they trigger a Claude call via MCP. Claude reorganizes file structures, reviews code, and acts as a manager for autonomous local workers.
Reflect MCP Server Implements Reflexion Paper for Persistent Coding Agent Memory
A developer implemented the Reflexion paper (Shinn et al., NeurIPS 2023) as an MCP server to give local coding agents persistent memory of their mistakes. The system uses regex-based pattern matching on error messages and stores lessons in SQLite with FTS5.
Tessera: Open-Source GUI Workspace for Managing Multiple Claude Code Sessions
Tessera is an open-source GUI that lets you run multiple Claude Code sessions side by side with Git worktree isolation, Kanban task tracking, live diffs, and agent activity inspection.