Real-time token cost meter for AI coding agents. Watch your tokens burn as it happens.
Your AI agent is running. You want to know right now how many tokens each command costs, not after the session ends.
npx token-meterA live dashboard that shows:
- Real-time token consumption per conversation turn
- Timestamps next to every message — when it happened, how long it took
- Cost accumulation as it happens
- Tool call tracking — which tools are being called and when
# Install globally
npm install -g token-meter
# Full dashboard mode (takes over the terminal)
token-meter
# Status bar mode (lightweight, bottom of terminal) ← Recommended
token-meter --bar
# Watch specific agent
token-meter --bar -a kimi-code
token-meter -a claude-code
token-meter -a codex
# Refresh every 500ms
token-meter --bar -i 500The status bar mode shows a single line at the bottom of your terminal:
│ ⚡ 18:30:22 │ T:1.5M │ $4.54 │ M:7 │ TL:9 │ S:252 │ YOU: 请帮我检查一下项目... │
- T:1.5M — Total tokens consumed
- $4.54 — Estimated cost
- M:7 — Messages in current session
- TL:9 — Tool calls made
- S:252 — Sessions detected
- YOU/AI/TL — Last event (user message, AI response, or tool call)
Perfect for running alongside your AI agent without blocking your view.
⚡ token-meter — Real-time Token Cost Monitor
─────────────────────────────────────────────────
Watching for AI agent activity... (Ctrl+C to exit)
────────────────────────────────────────────────────────────────────
Sessions: 64 │ Tokens: 2.3B │ Cost: $4681.95 │ Msgs: 3256 │ Tools: 11570 │ 14:23:45
────────────────────────────────────────────────────────────────────
YOU 请帮我检查一下项目结构 [14:23:42]
AI 我来检查一下你的项目... [14:23:43]
TL Bash ls -la [14:23:44]
📊 +1.2Kin / +89out [14:23:44]
AI 项目结构如下... [14:23:46]
YOU 看看有没有安全问题 [14:23:50]
TL Grep pattern: eval|exec|child_process [14:23:51]
📊 +3.4Kin / +234out [14:23:51]
Every line has a timestamp on the right. You can see exactly when each message happened and how long the AI took to respond.
token-meter [options]
Options:
-a, --agent <type> Agent type (kimi-code, claude-code, codex, opencode)
-i, --interval <ms> Refresh interval in milliseconds (default: 1000)
-s, --session <id> Watch specific session ID
--bar Status bar mode (lightweight, bottom of terminal)
--no-banner Hide the banner (full mode only)
-h, --help Display help
-V, --version Display version
| Agent | Status |
|---|---|
| Kimi Code | ✅ Supported |
| Claude Code | ✅ Supported |
| Codex | ✅ Supported |
| OpenCode | ✅ Supported |
- Watches local session files in real-time (no network requests)
- Parses new content as it's written to disk
- Extracts tokens, messages, tool calls from each line
- Displays live in your terminal with timestamps
- ✅ 100% local — no data leaves your machine
- ✅ Read-only — never modifies session files
- ✅ No API keys — no external services
- agent-trace — Post-session analysis tool (cost breakdown, tool health, anomaly detection)