Tokimeter: model tool for Hermes Agent

Local-first usage and cost meter for AI coding agents including Claude Code, Codex and Hermes

What Tokimeter does

Tokimeter reads the usage metadata that coding agents already keep on disk and turns it into one local report. Running npx tokimeter report prints total spend, call counts, token totals, estimated savings from prompt caching, and breakdowns by tool, model, project and day. The flags --days=7, --tool claude|codex and --json are supported.

A full install adds budgets, limit warnings and live status-line displays. The limits command groups observed usage into 5-hour and 7-day windows measured against budgets you set. Tokimeter reads usage metadata rather than prompts or responses, and its local features need no account, provider API key, proxy or telemetry. Hermes appears in the repository description and topics next to Claude Code, Codex, Cursor, Grok Build, opencode, Cline and Copilot CLI.

Key features

One report across several coding agents, broken down by tool, model, project and day
Estimated API-equivalent cost and prompt-cache savings
Budgets and limit warnings over 5-hour and 7-day windows
Live status-line displays after a full install
Reads usage metadata only, with no prompts or responses
JSON output for scripting

When to use it

Seeing how much a Hermes session costs next to Claude Code and Codex work
Checking whether you are close to a usage limit before starting a long task
Producing a private weekly cost report without sending data to a service

Who it is for: Developers who run several AI coding agents and want one private view of usage and cost.

How it fits with Hermes Agent

It is a general tool that lists Hermes among the agents whose local usage data it can report, alongside Claude Code, Codex and others.

How to install Tokimeter

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

npx tokimeter report
npx tokimeter install

Requirements: Node.js 18+ (includes npm and npx)

FAQ

What is Tokimeter?

Tokimeter is a local-first meter that summarises usage, limits and API-equivalent cost across AI coding agents. It works from usage metadata already on your machine and needs no account.

Does Tokimeter work with Hermes Agent?

Yes, the repository description and topics list Hermes among the supported agents. The README also says the author uses Hermes alongside Claude Code, Codex, Cursor and others.

How do I install Tokimeter?

Run npx tokimeter report for a one-off report with no install, or npx tokimeter install to set up the full local meter. Both need Node.js 18 or newer.