dvcrn toll — Token Usage Tracker
toll is a CLI tool that aggregates token usage logs from Claude Code and Codex CLI and displays session counts, token totals, cache hit rates, and estimated USD costs.
Installation
If toll is not installed, install it first:
# Quick install (Linux/macOS)
curl -fsSL https://raw.githubusercontent.com/Fullstop000/toll/refs/heads/master/install.sh | sh
# Or via cargo
cargo install toll
Usage
When the user invokes /toll, run the appropriate toll command based on their intent:
| User Intent | Command |
|---|---|
| All-time summary (default) | toll |
| Today's usage only | toll --today |
| Last N days | toll --days <N> |
| Daily breakdown | toll --by-day |
| Claude Code only | toll --claude |
| Codex CLI only | toll --codex |
| Full token counts | toll --detail |
| JSON output | toll --json |
| CSV output | toll --csv |
| List model prices | toll --list-prices |
Flags can be combined, e.g. toll --by-day --days 7 --claude.
Behavior
- Check if
tollis installed by runningtoll --version. If it fails, prompt the user to install it using the command above. - Parse the user's request to determine which flags to pass.
- Run
tollwith the appropriate flags and present the output to the user. - Explain the output if the user seems unfamiliar with the metrics:
- Sessions: number of AI coding sessions tracked
- Input: total input tokens sent to the model
- Cached: tokens served from the prompt cache (cheaper)
- Hit Rate: percentage of input tokens that were cached
- Net Input: non-cached input tokens (full price)
- Output: tokens generated by the model
- Cost: estimated USD cost based on per-model pricing
Example Interactions
User: /toll
→ Run toll and show all-time summary
User: /toll today
→ Run toll --today
User: /toll last 7 days
→ Run toll --days 7
User: /toll daily breakdown this week
→ Run toll --by-day --days 7
User: /toll how much have I spent on Claude?
→ Run toll --claude and highlight the Cost column
User: /toll export csv
→ Run toll --csv and offer to save the output to a file
Notes
- Cost estimates marked with
*include models whose pricing is approximate or inferred by prefix matching. - Token counts use compact notation:
1.2m= 1,200,000 tokens,45.6k= 45,600 tokens. - Logs are read from
~/.claude/projects/**/*.jsonl(Claude Code) and~/.codex/sessions/(Codex CLI).