tokentop CLI
htop for AI costs: a terminal dashboard shows tokens and spending across 11 providers and 8 coding agents in real time.
- 77 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- Reads local agent logs and counts spending.
- Contacts models.dev for prices and keeps a local cache.
Install
- Works in
Manual install
brew install tokentopapp/tap/tokentopThe first README option for macOS and Linux; a script, Scoop and binaries also exist.
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- Reads local agent logs and counts spending.
- Contacts models.dev for prices and keeps a local cache.
This is third-party code. Review the repository files before installing.
What it does
tokentop shows a live picture of spending in the terminal: tokens, cost, burn rate and per-session activity. It watches 11 providers, including Anthropic, OpenAI, Google Gemini, GitHub Copilot and Codex, and 8 coding agents: Claude Code, OpenCode, Cursor, Copilot CLI, Gemini CLI, Antigravity, Windsurf and Pi. The dashboard has daily, weekly and monthly budget limits with warnings, a breakdown of spending by model, project and agent, 7, 30 and 90 day trends and efficiency indicators such as cache use and cost per request. Prices come from models.dev and are cached locally. Plugins add custom providers, agents, themes and notifications.
Who it is for. Developers who work with coding agents all day and want token spending and limits in one terminal window.
Good fit when
- Several agents burn tokens at once and you need one picture instead of separate provider dashboards.
- You need a daily or monthly limit with a warning before it is exceeded.
- You must find which project or model costs the most.
- You want to view spending locally without sending data outside.
Not a fit when
- You need exact invoice amounts: prices come from a public reference and usage is counted from local logs.
- The agent is not on the supported list and has no plugin.
- You want a browser dashboard: tokentop works only in the terminal.
Example request
Run `ttop`, show which project and model used the most tokens this week and suggest a daily limit.Limitations
The README marks the project as an early release, so bugs are possible. Usage is counted from local agent logs and models.dev prices, so the total can differ from the provider invoice. Running through npm needs Bun, and prebuilt binaries exist for macOS on Apple Silicon, Linux x64 and ARM64, and Windows x64. The author states that usage data stays on the machine. Installing with the `curl | sh` script means reading the script first.
How to disable. Remove the `ttop` binary or run `brew uninstall tokentop` or `bun remove -g @tokentop/ttop`. Configuration and the price cache live in the user home directory.
FAQ
How do I install tokentop?
With Homebrew: `brew install tokentopapp/tap/tokentop`. There is an install script, Scoop for Windows, prebuilt binaries and `bunx @tokentop/ttop` when Bun is installed.
Which agents and providers are supported?
11 providers, including Anthropic, OpenAI, Gemini, Copilot, Codex and Perplexity, and 8 agents: Claude Code, OpenCode, Cursor, Copilot CLI, Gemini CLI, Antigravity, Windsurf and Pi.
Does data leave the machine?
The author says it runs locally and usage data never leaves the machine. Prices are fetched from models.dev and cached.
Can I cap the budget?
Yes, set a daily, weekly or monthly limit and the dashboard warns at the percentages you choose.
How do I extend the agent list?
Through the plugin system: it adds providers, agents, themes and notifications. Documentation is at tokentop.app.
Discussion
No questions or reviews yet.
Related
CLI toolsTokdash shows token usage and session cost for Claude Code, Codex, Gemini CLI and a dozen more agents locally
TokenTracker counts tokens and spend across Claude Code, Codex, Cursor, Gemini CLI and other agents from local logs and shows them on a local dashboard
A fast Rust tracker of tokens and costs across Claude Code, Codex, Gemini CLI and others that keeps history beyond 30 days.
A desktop widget with quota balances and token use across Claude, Codex, Kimi, GLM and other agents in one window.
Counts token use and cost of Claude Code and Codex sessions from local logs and shows remaining limits in the status line
Token and cost reports for Claude Code, Codex, Gemini CLI and other agents from local logs, by day, month and session
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| tokentop (this card) | no | 77 | |
| Tokscale | no | 5,844 | also terminal token accounting for agents; tokentop adds budget limits, a view of 11 providers and a plugin system |
| ccusage | no | 19,415 | reports from local logs by day and session; tokentop works as a live dashboard with warnings |
README in short
The text explains why a dashboard is useful, lists features and install options, the agents and providers, the plugin system, themes and period reports.