TOKENHAWKGitHub
Your agents are working. Tokenhawk is watching.

Keep an eye on
every token.

A live, local monitor for your AI coding sessions. See usage, cache efficiency, subagents, and cost across every tool, without your data leaving the machine.

Install Tokenhawk → View source ↗
go install github.com/polera/tokenhawk@latest
01 / VISIBILITY

One terminal.
The whole flight path.

Tokenhawk indexes the session metadata your tools already keep and turns it into a clear, live picture.

tokenhawk: all sessions LIVE
Tokenhawk dashboard listing token usage, costs, and subagents across coding-agent sessions
5

Agent providers, one interface

2s

Default reconciliation interval

SESSION DETAILParent + subagents
Tokenhawk session detail showing parent and subagent token usage
RESPONSIVEBuilt for narrow terminals
Tokenhawk compact dashboard in a narrow terminal

Native visibility across the tools you already use

Claude Code Codex Gemini CLI Pi OpenCode
02 / SIGNAL

Read the room.
In real time.

Tokenhawk surfaces the numbers that matter while work is happening, and keeps the raw context where it belongs.

01
↗

Watch usage live

Follow input, cached input, output, reasoning, tool tokens, and normalized I:O ratios as sessions update.

02
⌁

See every agent

Separate parent and subagent usage, including which agents are running and what each one costs.

03
△

Catch cache misses

A clear low-cache warning flags high-input sessions before unnecessary spend disappears into the scrollback.

04
{ }

Take the data with you

Export visible sessions as structured JSON or CSV, with model-level and subagent detail intact.

03 / PRIVACY

Your work stays
under your wing.

Tokenhawk runs on your machine and reads only the usage metadata your coding tools already store. No account. No telemetry. No cloud dashboard.

Read the privacy model →
TOKENHAWKsession token monitor
100%LOCAL
  • PromptsNever read
  • ResponsesNever read
  • CredentialsNever read
  • Tool argumentsNever read
04 / IN THE LOOP

Metrics where
you’re already looking.

Add a compact status line to Claude Code, or run Codex, Gemini, Pi, and OpenCode through a tmux-backed wrapper.

Set up live status →
~/src/payments-core

❯ codex

Working ▋

TOKENHAWKcodexin 11.80Mcache 96.6%out 76.4k$4.28002/4 agents
Open source. Local first.

Fly smarter.
Spend sharper.

Install Tokenhawk and get eyes on your agent usage in under a minute.

$ go install github.com/polera/tokenhawk@latest