# Toll

> Track and display token usage statistics and estimated USD costs from Claude Code and Codex CLI sessions

- Skill: `dvcrn/toll` (Agent Skill)
- Install (CLI): `npx skillmds@latest add dvcrn/toll`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/toll/raw
- Safety review: pending (external: skill-scanner WARNING, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/toll

---


# 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:

```bash
# 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).