Tallybook

Precifica suas sessões do Claude Code e Codex a partir dos transcrições em disco, mostra quanto cada agente custou em qualquer período e informa em inglês simples o que teria sido mais barato. CLI, interface de navegador e servidor MCP.

Documentação

Tallybook logo

Tallybook

Precifica cada sessão do Claude Code e do Codex no seu disco, mostra quanto cada agente custou em qualquer período e informa em linguagem simples o que teria sido mais barato.

CI Latest release MCP server MIT License Glama Quality

Documentação


Sem proxy, sem chave de API, nada sai da sua máquina. Execute como CLI, abra o mesmo relatório no seu navegador com tallybook --serve, ou adicione tallybook-mcp ao Claude Code ou Codex e pergunte ao agente quanto ele está gastando e o que seria mais barato.

tallybook --serve: the same report in your browser
No seu navegador · tallybook --serve

tallybook in the terminal: the report, a week-on-week comparison, and spend by sub-agent
No seu terminal · tallybook

Mais na documentação.

Instalação

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

Também disponível via go install github.com/magna-nz/tallybook/cmd/tallybook@latest, ou como um download de release. Funciona em macOS, Linux e Windows.

Adicione o servidor MCP para que seu agente possa verificar seus próprios gastos durante a sessão — tallybook-mcp acompanha o tallybook, então não é necessária instalação separada:

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

Para Codex, adicione-o ao ~/.codex/config.toml:

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

Uso

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

Documentação

A referência de comandos, as ferramentas do servidor MCP, a configuração e o modelo de privacidade estão no site de documentação.

Licença

MIT