Tokentab

tokentab

tokentab reads the session logs that Claude Code, Codex, Cursor and Gemini CLI already leave on disk and adds up token usage and cost - broken down by model, by project, by day, and by the kind of work each session was doing. It runs entirely locally: no account, no API key, nothing leaves your machine.

Installing

Clone the repo and install it into your environment:

git clone https://github.com/wzchav/tokentab
cd tokentab
pip install .
tokentab

That puts a `tokentab` command on your path. You can also run it without installing at all - see [From source](#from-source).

What it reads

It understands three tools out of the box, plus a Cursor slot that's wired up but not finished (more on that below).

Tool	Where its logs live
Claude Code	~/.claude/projects/**/*.jsonl
Codex	~/.codex/sessions/**/rollout-*.jsonl
Gemini CLI	~/.gemini/tmp/**/session-*.json
Cursor	(stub - see below)

If a tool isn't installed, it's just skipped. You'll only ever see the tools you actually use.

Using it

The bare command gives you the last 7 days across everything:

tokentab

Some other things it does:

tokentab today                     # just today
tokentab month                     # this calendar month
tokentab -p all                    # everything you've ever run
tokentab --provider claude         # one tool only
tokentab --project myapp           # one project
tokentab --from 2026-06-01 --to 2026-06-15   # a specific window
tokentab --json | jq .             # machine-readable, pipe it wherever
tokentab web                       # the same thing, in a browser, with charts

Colour drops automatically when you pipe the output somewhere, so pasting into a PR or a chat doesn't drag a load of escape codes along with it.

The web dashboard

tokentab web

Opens `http://localhost:4747` and