Tools/damejan80/tokentab

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.

1.1kemergingPythonMIT Licensenew this week

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 free

Free (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 -today and -month scoping 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
Self-hosting ops:trivial

Get tools like this every Wednesday

One featured tool, three on the radar. No fluff.

Score
68/100 · B
Adoption13/30
Maintenance25/25
Community5/20
License15/15
Analysis10/10

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