Question 1

What is Token Telemetry?

Accepted Answer

Token Telemetry (also written TokenTelemetry, sometimes misspelled as 'token telementry' or 'tokentelementry') is a free, open-source, 100% local observability dashboard for AI coding agents like Claude Code, Codex, Gemini CLI, Cursor, and GitHub Copilot. It tracks tokens, cost, tool calls, and reasoning by reading the log files those agents already write — no SDK, no signup, no cloud.

Question 2

How do I track Claude Code token usage?

Accepted Answer

Install TokenTelemetry, run Claude Code normally, and open http://localhost:13000. TokenTelemetry auto-detects Claude Code sessions from ~/.claude/ logs — no instrumentation, no SDK, no config.

Question 3

How do I monitor Google Antigravity, Codex, and Gemini CLI costs?

Accepted Answer

TokenTelemetry auto-reads logs from Google Antigravity, OpenAI Codex CLI, Gemini CLI, Cursor, GitHub Copilot, Qwen CLI, OpenCode, Vibe, Grok Build, Cline, SmallCode, Pi, Meta Muse Code, Prime Agent, DeepSeek Harness, Qoder, and ZCode. Token counts and dollar costs appear in the local dashboard automatically when each agent records them.

Question 4

Can I see how much of my Claude Code or Codex plan is left?

Accepted Answer

Yes. TokenTelemetry reads live plan limits from the coding-agent logins already on your machine and shows the session, weekly and monthly windows with their reset times — Claude Code's 5-hour and 7-day windows, Codex's session and weekly plus credits, GitHub Copilot's chat and completion allowances, OpenCode's rolling, weekly and monthly windows, and Grok's weekly credit pool. The numbers come from each provider, so they match that provider's own usage screen rather than being estimated from your history. A gauge in the sidebar colours as a window fills, and an agent with no live number says why instead of showing a guess.

Question 5

Is there a free tool to monitor AI coding agent token usage?

Accepted Answer

Yes — TokenTelemetry is free, open-source (MIT), and runs 100% locally. No account, no signup, no cloud.

Question 6

Does TokenTelemetry send my data to the cloud?

Accepted Answer

Your logs, sessions, prompts, tokens, and costs never leave your computer — the dashboard reads local files and serves a UI on localhost. The app does send anonymous, content-free usage stats (which pages and features you use — never your code, prompts, paths, or costs) so we know what to improve; it's on by default and you can see the exact payload and turn it off in Settings → Usage & privacy, or with DO_NOT_TRACK=1. There's also an optional GitHub update check (no usage data); disable with TT_NO_UPDATE_CHECK=1.

Question 7

How does TokenTelemetry compare to Langfuse or Helicone?

Accepted Answer

TokenTelemetry is purpose-built for AI coding agents and is zero-config — no SDK instrumentation. Langfuse and Helicone are general LLM-app observability platforms that require code changes and (typically) a cloud account.

Question 8

Which agents does it support?

Accepted Answer

Twenty coding agents (Claude Code, OpenAI Codex, Gemini CLI, Cursor, GitHub Copilot, Qwen CLI, OpenCode, Vibe, Antigravity, Grok Build, Cline, SmallCode, Pi, Oh My Pi, Meta Muse Code, Prime Agent, DeepSeek Harness, Qoder, ZCode, and Kimi Code) plus Hermes Agent — Nous Research's autonomous agent, which gets its own dedicated dashboard at /hermes with gateway health, scheduled-job monitoring, skills + memory observability, and 38 source platforms (CLI / Telegram / Discord / Feishu / DingTalk / cron / webhook / …).

Question 9

Why does Hermes Agent get its own page?

Accepted Answer

Hermes is structurally different from coding agents — it runs across messaging platforms (Telegram / Discord / Slack / WhatsApp / Signal / Matrix / Feishu / DingTalk / WeChat), supports persistent skills and memory, delegates to subagents, and runs scheduled cron jobs. Forcing it into the same UI as Claude Code would hide most of what it does, so it gets a dedicated surface that respects its shape.

Question 10

Can I use TokenTelemetry from inside Hermes Dashboard?

Accepted Answer

Yes — there's a Hermes Dashboard plugin that registers a 'TokenTelemetry' tab inside Hermes's web UI at port 9119. It's a thin launcher: deep-link cards open the relevant TokenTelemetry page (Hermes Overview, Skills, Memory, Analytics, Projects) in a new browser tab, so you don't have to remember a second port. Install with `./scripts/install-hermes-plugin.sh` from the TokenTelemetry repo, then run `hermes dashboard`.

Resources