Claude Code Metrics
Claude Companion
A pixel familiar that watches your Claude Code and reacts in real time — while twelve tiles show fleet, tokens, cost, burn rate and activity, all read locally.
0
API calls · 100% local
On your Stream Deck
A little pixel creature lives on a key and reacts to your coding fleet in real time.
RUN The fleet is running — everything at a glance.
The companion reacts
a session is running
a session needs you
work shipped
all quiet
The 12 tiles
Your reactive pixel familiar, 12 skins.
Live counts of every session in one tile: RUN, INPUT, END.
How many sessions are in a given state: RUN, INPUT or END.
One specific session, focused on its context %.
Streak and a 12-week heatmap.
Token usage by hour, your peak.
Today, lifetime, or a 24h sparkline.
API-equivalent spend, today to lifetime.
Spend per project and per model.
Tokens per minute over the last hour.
A daily or weekly counter: permission prompts, runs, or sub-agents.
A shareable recap of your stats.
Local-first & privacy
Claude Companion is built to be boringly safe with your data.
- ›Reads your local Claude Code files under ~/.claude, read-only.
- ›Makes no network calls and talks to no API. No account, no key.
- ›Sends no telemetry. Nothing about you is collected, stored remotely, or shared.
- ›Cost figures are an API-rate-equivalent estimate, not a bill, and never leave your machine.
Install
Install Claude Companion from the Elgato Marketplace, then drag any tile onto a key. Tokens, cost, project cost and activity work right away.
Live sessions: why it needs a hook
Some tiles need to know whether a session is working, waiting, or done — state Claude Code stores nowhere. A small hook captures it.
-
With nothing
Tokens, cost, project cost and activity already work: Claude Code writes the transcripts.
-
What’s missing
Live state —
working,waiting,done— lives in no file. -
The hook
A plugin listens to Claude Code’s events and writes the state to
~/.claude/deck-state, read by the Stream Deck.
In Claude Code — enabling it installs the hooks automatically:
One command at a time: copy, paste, run, then the next.
- 1
/plugin marketplace add https://github.com/denisvinciguerra/claude-companion-hooks - 2
/plugin install claude-companion@claude-companion - 3
/reload-plugins
FAQ
Do I need a Claude or Anthropic API key? +
No. Claude Companion only reads the files Claude Code already writes on your machine. There is no API call and no key to enter.
Is the cost figure my real bill? +
No. On a flat subscription there is no per-token bill, so the cost tile shows an API-rate-equivalent estimate, labelled as such.
A tile shows a dash or zero. +
There is no local data yet for that metric. The tile fills in as you use Claude Code.
The companion is always asleep, or my Fleet / Session tiles are empty. +
Those live tiles need the optional plugin for Claude Code (see Install). Tokens, cost and activity work without it.
Editions
macOS
Coming soonGitHub
Coming soonWindows
Coming soonGitHub
Coming soon