
tokentab
A CLI that reads Claude Code, Codex, and Gemini CLI session logs and works out how much they cost, by model, project, and day.
The Lens
By Erik Loyd, SaaS CEO and former COO/CFO of an AWS Premier Partner.
Updated Sep 2026
tokentab answers the question every AI coding CLI dodges: what did this actually cost me. It reads the session logs Claude Code, Codex and Gemini CLI already write to disk, adds up tokens and dollars, and breaks the total down by model, by project, by day, and by the kind of work each session was doing. Nothing leaves your machine, there is no account, and no API key is involved. MIT licensed.
There is nothing to operate. Clone it, `pip install .`, and run `tokentab` for the last seven days across every tool you use. Flags narrow it to today or the current calendar month. Tools you do not have installed are simply skipped, so you only ever see what you actually run. There is a small web dashboard if you want the charts rather than the table.
Free, complete, no paid tier. Solo developers on usage-based API billing get the most out of it, because it turns a surprise invoice into a per-project number you can act on. Teams can run it per-machine, though there is no central rollup.
The catch is that it reads logs, which means it reports what those logs contain. The Cursor integration is a stub that is wired up but unfinished, subscription-based usage gets priced at list rates rather than what you were actually charged, and a cleared log directory is history you cannot get back.
Free vs Self-Hosted vs Paid
fully freeFree (Open Source)
- MIT licensed Python CLI, installed with
pip install .from the repo - Parses Claude Code (
~/.claude/projects/**/*.jsonl), Codex (~/.codex/sessions/**/rollout-*.jsonl) and Gemini CLI (~/.gemini/tmp/**/session-*.json) - Cost broken out by model, project, day, and type of work
- Local web dashboard, plus
-todayand-monthscoping flags - Fully offline: no account, no API key, no telemetry
Paid
None. There is no hosted version and no pro tier.
Self-Hosted Costs
$0. It is a local CLI reading files that already exist on disk. No server, no database, no network calls.
When to Pay
Nothing to buy. The value is upstream: knowing which project is burning your API budget is what saves the money.
Completely free and open source. It reads logs already on your disk and never phones home.
What to do by team size
- Solo
- free; the fastest way to see which project is eating your API budget
- Small team
- free, run it per-machine
- Medium team
- free, but there is no central rollup across developers
- Large team
- free; expect to build your own aggregation on top
Get tools like this every Wednesday
One featured tool, three on the radar. No fluff.
A low score is not a verdict on quality. Young and niche tools start low by design. How we calculate scores
License: MIT License
Use freely, including commercial. Just keep the license.
Commercial use: ✓ Yes
About
- Owner
- Dame (User)
- Stars
- 1,141
- Forks
- 210
Explore Further
More tools in the directory
openclaw
Your own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞
388.4k ★everything-claude-code
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
245.9k ★hermes-agent
The agent that grows with you
239.6k ★