English Français العربية

Tallybook

Community Developer tools

Local cost tracking for Claude Code and Codex sessions: spend by session, sub-agent and model, week-on-week comparisons, and findings with suggested patches.

Source code Documentation

Install

The installation steps are in the documentation below. Documentation

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Tallybook
  2. Install
  3. Use
  4. Docs
  5. License

Tallybook

Prices every Claude Code and Codex session on your disk, shows what each agent cost over any period, and tells you in plain English what would have been cheaper.

Documentation

No proxy, no API key, nothing leaves your machine. Run it as a CLI, open the same report in your browser with tallybook --serve, or add tallybook-mcp to Claude Code or Codex and ask the agent itself what it's spending and what would be cheaper.

In your browser · tallybook --serve

In your terminal · tallybook

More in the documentation.

Install

brew install --cask magna-nz/tap/tallybook

Also available via go install github.com/magna-nz/tallybook/cmd/tallybook@latest, or as a release download. Works on macOS, Linux and Windows.

Add the MCP server so your agent can check its own spend mid-session — tallybook-mcp ships alongside tallybook, so no separate install:

claude mcp add tallybook -- tallybook-mcp   # Claude Code

For Codex, add it to ~/.codex/config.toml:

[mcp_servers.tallybook]
command = "tallybook-mcp"

Use

tallybook                         # this period's report: the five biggest findings
tallybook --serve                 # the same report, findings and sessions in your browser, on localhost
tallybook findings                # every finding, grouped by what kind of change it asks for
tallybook --since 7d --compare    # this week against last week: spend, sessions, cache hit rate
tallybook finding 1               # finding #1 in full: what happened, why, what to change
tallybook finding 1 --evidence    # the same, with the sessions behind it
tallybook finding 1 --patch       # finding #1's fix, as an applyable diff
tallybook agents                  # spend by sub-agent type, with the model and effort each ran at
tallybook sessions --sort cost    # sessions ranked by what they cost
tallybook changes                 # did a past model swap actually save money?
tallybook setup hook              # record sessions automatically as they end

Docs

The command reference, the MCP server's tools, configuration, and the privacy model live on the documentation site.

License

MIT

Frequently asked questions

What is Tallybook?

Local cost tracking for Claude Code and Codex sessions: spend by session, sub-agent and model, week-on-week comparisons, and findings with suggested patches.

How do I install Tallybook?

Follow the installation steps in its documentation, shown on this page and in its repository.

Is Tallybook open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Tallybook?

It is published by magna-nz. AI.tn lists it but does not maintain or endorse it.

From the community awesome-mcp-servers lists and the project's GitHub repository. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.