Tokens: developer tool for Hermes Agent

CLI and web leaderboard that tracks AI coding-assistant token usage across 41 clients

What Tokens does

The Tokens CLI reads the session files that AI coding clients already write to disk, totals them locally, and uploads only the totals: token counts, model names, client names and timestamps. According to the README, prompts, completions, file contents and paths never leave the machine, and tokens submit --dry-run prints the payload without sending it. The repository is public so that the per-client parsers and the submit path can be read.

The uploaded totals feed the public leaderboard at tokens.ci, which shows daily usage, the split across clients and models, and your rank. All 41 supported clients are detected automatically when they are installed and have written sessions; Hermes Agent is on that list next to OpenClaw, Claude Code and Codex CLI. An iOS app adds widgets and share cards, and a settings file can strip routing prefixes that a gateway adds to model IDs.

Key features

Detects 41 supported clients automatically, Hermes Agent among them, from the session files they write to disk
Uploads only totals (token counts, model names, client names, timestamps), not prompts or file contents
tokens submit --dry-run shows the exact upload payload without sending it
Public leaderboard at tokens.ci with usage split by client and model
iOS app with Home screen and Lock screen widgets for daily tokens, running total and rank
modelIdPrefixesToStrip setting in ~/.config/tokens/settings.json for gateways that add routing prefixes

When to use it

Seeing how many tokens Hermes Agent and your other coding agents use each day
Comparing usage across clients and models when you switch between several agents
Reading the parsers and upload path before deciding whether to run a usage tracker

Who it is for: Developers who run Hermes Agent next to other AI coding clients and want a combined token-usage view and public ranking.

How it fits with Hermes Agent

Tokens is a general usage tracker, not a Hermes-specific tool; Hermes Agent is one of the 41 clients it detects and counts.

How to install Tokens

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

bunx tokens-cli@latest login

Note: The project describes itself as a fork of junhoyeo/tokscale, and submitting usage uploads totals to the public tokens.ci leaderboard.

FAQ

What is Tokens?

Tokens is a command-line tool and public leaderboard at tokens.ci that totals your AI coding-assistant token usage. It is written in Rust and describes itself as a fork of junhoyeo/tokscale.

Does Tokens work with Hermes Agent?

Yes, Hermes Agent is one of the 41 clients Tokens detects automatically. If it is installed and has written sessions, its usage is counted.

What data does Tokens upload?

Only totals: token counts, model names, client names and timestamps. The README says prompts, completions, file contents and paths never leave your machine, and tokens submit --dry-run shows the payload first.