TokenTelemetry CLI
Local dashboard for tokens, cost and tool calls across Claude Code, Codex, Gemini CLI and many other coding agents.
- 387 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The dashboard reads logs of every agent with code and prompts, and takes plan quotas from agent logins already stored on the computer.
- The `curl | bash` installer runs code fetched from a remote address.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/tokentelemetryDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The dashboard reads logs of every agent with code and prompts, and takes plan quotas from agent logins already stored on the computer.
- The `curl | bash` installer runs code fetched from a remote address.
This is third-party code. Review the repository files before installing.
What it does
TokenTelemetry reads coding-agent session logs on your computer and gathers them into one web dashboard at `http://localhost:13000`. For each session, project and model it shows input and output tokens, cost, traces of tool calls and reasoning, and plans captured from planning mode. Agents are detected automatically from their default log paths, so no setup is needed. Budgets can be set per project and per agent: an alert arrives at 80 and 100 percent, but the budget never interrupts the agent. A separate `/hermes` section covers Hermes Agent: source platforms, API call latency, cron jobs and gateway health.
Who it is for. People who pay for the tokens of several agents and want to see spend by project and model without cloud services.
Good fit when
- The monthly bill went up and you need to find which project and model burned the tokens.
- You use several agents, such as Claude Code, Codex and Cursor, and have no combined statistics.
- An agent did something other than its plan promised and you inspect its call trace.
- A monthly spend limit with an alert is set on a project.
- Hermes Agent runs through Telegram and cron and you watch the gateway health.
Not a fit when
- A hard spend cap: budgets only alert and never block an agent run.
- Hermes Agent on another machine: the dashboard reads its data locally only, with no remote mode yet.
- A shared team dashboard: the data stays on your computer.
Example request
Install TokenTelemetry and show how many tokens and how much money each project used over the last week.Limitations
Node.js 18 or newer and Python 3.9 or newer are required. The dashboard reads logs on the same machine only. Budgets alert at 80 and 100 percent and do not stop the agent. Anonymous product-usage statistics are on by default and switch off with one toggle, while session logs stay on the computer. For Qoder the dashboard counts credits, because that agent records no tokens. The installer runs through `curl` and `bash`, so read the script before you run it.
How to disable. Stop the running dashboard process and delete the folder it was installed into. The program only reads agent logs, so they stay untouched.
FAQ
How do I install TokenTelemetry?
On macOS and Linux use `curl -fsSL https://raw.githubusercontent.com/VasiHemanth/tokentelemetry/main/install.sh | bash`, on Windows the `install.ps1` script in PowerShell. Manually: clone the repository, run `./start.sh` or `node bin/cli.js` and open `http://localhost:13000`.
Which agents are supported?
Claude Code, Codex, Gemini CLI, Cursor, GitHub Copilot, OpenCode, Cline, Qwen, Kimi Code, Muse Code and about ten more, plus Hermes Agent with its own dashboard. Logs are found automatically.
Do logs go to the cloud?
No. Logs, tokens, cost and prompt text stay on the computer. Only anonymous product-usage statistics go out, and one toggle switches them off.
Do budgets block an agent?
No. An alert arrives at 80 and 100 percent of the limit, and agent runs continue.
How do I connect the dashboard to Hermes Agent?
Run `hermes plugins install VasiHemanth/tokentelemetry-hermes-plugin` and start `hermes dashboard`. TokenTelemetry appears as a tab inside the Hermes dashboard.
Discussion
No questions or reviews yet.
Related
CLI toolsA local Splunk dashboard shows tokens and cost for Claude Code, Codex and Cursor sessions, and an MCP server answers questions.
Reads local logs of Claude Code, Codex, Cursor and other agents and shows token spend, time and failures in a TUI
Local code search for agents: finds the files and fragments that matter and keeps context within a set token budget
A terminal and browser viewer for coding agent spend: sessions by turn, subagent and context window, with API price estimates.
Token-Saver compresses terminal output for Claude Code: diff, pytest, npm, terraform, kubectl, docker. Compression runs locally.
agentburn reads local logs of Claude Code, Codex and other agents and shows which windows and tasks consume tokens and money.
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| TokenTelemetry (this card) | no | 387 | |
| ccusage | no | 19,415 | reports spend in the console, while TokenTelemetry keeps a persistent web dashboard with budgets and call traces |
| Tokscale | no | 5,844 | a terminal spend tracker, while TokenTelemetry adds a web dashboard, budgets and a separate Hermes Agent section |
README in short
The author stresses that the dashboard is free, open source and needs no sign-up or cloud. The Hermes Agent tab installs as a plugin through `hermes plugins install` and sits on port 9119 next to 13000.