Understand your AI agents’ token usage.
TokenAtlas shows usage, cost and efficiency across Claude Code, Codex, OpenCode and Pi. Runs locally on macOS, Linux and Windows with Python 3.10 or later.
Last verified release · v1.22.0- Track tokens and API-equivalent list-price estimates by day, project, session and model—not what you actually paid. See shares of 5-hour and weekly limits when data is available (Codex logs; Claude status line or calibration).
- Explore concentration, context volume, delegation and changes across periods. These are signals to investigate, not proof of waste or quality.
- Facts: cost facts are calculated from saved observations with assumptions and data coverage shown.
- Scenario: assume 20% of 100,000 input tokens in a selected group were removed. The arithmetic gives 20,000 fewer tokens—hypothetical, not measured savings or a forecast.
- TokenAtlas counts; your agent can interpret the evidence and suggest workflow changes, and you judge the quality. Analysis and reports run locally without agent configuration. PyPI is contacted when you explicitly run the upgrade command.
Last verified release · v1.22.0: Upgrade safely from the command line
Showing saved release information. Last known release:
Release notes are shown in their original language, English.
- Check the latest compatible stable version with tokenatlas upgrade --check.
- Upgrade pipx, uv tool or dedicated virtual environment installs; choose a version for a deliberate rollback.
- Confirm the update. The installation is backed up; history, configuration and schedules are preserved.
Read the release notes on GitHub
Version history
The five latest releases. Read the full release notes on GitHub.
- v1.22.0 CLI upgrades with a compatibility check and preserved history.
- v1.21.0 Token-efficiency facts, hypothetical scenarios and JSON evidence for agents.
- v1.20.0 7- or 30-day analytics with token history and breakdowns by model and agent.
- v1.19.0 Hypothetical cloud-price comparison for local inference.
- v1.18.0 Opt-in scheduled collection and a clearer cost overview.
Install
pipx install tokenatlas
tokenatlas --version
tokenatlas open Rebuild an older report from saved history without collecting new logs: tokenatlas open --no-refresh
Update safely
tokenatlas upgrade --check
tokenatlas upgrade The update asks before changing the installation. Older releases must first be upgraded with their package manager, such as pipx upgrade tokenatlas or uv tool upgrade tokenatlas.
Choose an exact version (optional): tokenatlas upgrade --version 1.22.0
Only for automation that should approve the update: tokenatlas upgrade --yes
v1.22.0 upgrade guide (pipx, uv, Windows and backups).
The agents delete their own logs. For a history that stays, schedule tokenatlas collect – see the README.
Open source (MIT). Version 1.22.0.