AIMeter

Track your Claude AI token usage across every surface — CLI, VS Code, Desktop App — in one dashboard.

Why

Anthropic doesn't show per-session or per-project token usage. If you use Claude Code across multiple tools, you have no idea where your tokens are going.

AIMeter watches Claude's transcript files locally, extracts token counts, and sends them to your dashboard at getaimeter.com. No proxy, no code changes, no config files.

Quick Start

npx aimeter setup

The wizard will:

1. Ask for your API key (get one free at getaimeter.com)
2. Detect your Claude installations
3. Install a background service that auto-starts on login

That's it. Use Claude normally — your dashboard updates in real time.

What Gets Tracked

| Source | How | |--------|-----| | Claude Code CLI | File watcher on ~/.claude/projects/ | | VS Code Extension | File watcher on ~/.claude/projects/ | | Desktop App (Agent Mode) | File watcher on local-agent-mode sessions | | claude.ai (Web/Desktop Chat) | Browser extension (optional) |

Only token counts are sent — no prompts, no responses, no code. Your conversations stay on your machine.

Commands

aimeter setup       Full onboarding wizard (recommended)
aimeter status      Check configuration and service status
aimeter watch       Run watcher in foreground (for testing)
aimeter install     Install as background service
aimeter uninstall   Remove background service
aimeter start       Start the background service
aimeter stop        Stop the background service
aimeter logs        Tail the watcher log
aimeter key         Print your API key

How It Works

Claude Code (CLI, VS Code, Desktop Agent Mode) writes JSONL transcript files with full token usage data. AIMeter watches these files using fs.watch, reads only new bytes via offset tracking, and POSTs token counts to your dashboard.

• Zero dependencies — pure Node.js, no native modules
• Minimal overhead — file watcher + byte offset reads, ~5MB memory
• Deduplication — MD5 hashing prevents double-counting
• Crash-safe — state persisted to disk every 30 seconds

Privacy

AIMeter sends only:

• Token counts (input, output, thinking, cache)
• Model name (e.g., claude-sonnet-4-20250514)
• Source type (CLI, VS Code, Desktop)

It never sends your prompts, responses, code, or file contents.

Requirements

• Node.js 18+
• Claude Code (CLI, VS Code extension, or Desktop App)

Links

• Dashboard: getaimeter.com
• Issues: github.com/Khavel/AIMeter

License

MIT