wzchav

Tokentab — AI skill for Claude Code

AI community

A CLI that reads Claude Code, Codex, and Gemini CLI session logs and works out how much they cost, by model, project, and day.

How to install Tokentab

This entry records only its repository, not the path inside it, so there is no exact command to give. Open wzchav/tokentab and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Tokentab does

A CLI that reads Claude Code, Codex, and Gemini CLI session logs and works out how much they cost, by model, project, and day.

Alternatives in AI

AIHawk — Open-source AI browser agent: describe any task in plain language and it autonomously browses, clicks, types a 30.3k ★
Codeburn — Free, local tool to track AI coding token usage and cost across 37 tools and agents (Claude Code, Cursor, Code 9.7k ★
CLI Continues — resume any AI coding session in another tool — Claude Code, Copilot, Gemini, Codex, Cursor 1.5k ★

README

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.