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.js

After 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-server

Then 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.