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

1. Check if toll is installed by running toll --version. If it fails, prompt the user to install it using the command above.
2. Parse the user's request to determine which flags to pass.
3. Run toll with the appropriate flags and present the output to the user.
4. 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).