showmytokens
v0.1.1
Published
Turn your Claude Code, Codex and OpenCode usage into a shareable receipt
Maintainers
Readme
showmytokens
Turn your AI coding usage into a shareable receipt at showmytokens.com.
npx showmytokens loginThat opens your browser to connect this machine, offers optional Claude Code hooks for automatic syncing, then uploads your usage. Claude Code is the only supported tool for now; Codex, OpenCode and others are coming later. Your card appears at showmytokens.com/<your-handle>.
Commands
| Command | What it does |
| --- | --- |
| login | Connect this machine (device login in your browser) and sync. |
| sync [--dry-run] | Upload everything now. --dry-run prints what would be sent and sends nothing. |
| status | Show what is connected. |
| logout | Remove the hooks and the saved login, and revoke this machine's token on the server. |
Automatic sync
If you say yes at login, two Claude Code hooks keep your card fresh: Stop (after Claude finishes a response, at most every 10 minutes) and SessionEnd (when a session ends). Routine syncs send only the last 7 days; login, sync and one sync a day send everything. Automatic sync is available for Claude Code only.
What it reads and what it sends
It reads your local Claude Code usage logs (~/.claude/projects, or CLAUDE_CONFIG_DIR). Codex and OpenCode readers exist but are experimental: they only run if you pass --source=codex,opencode.
It sends per-day counts only: messages, sessions, longest session length and token totals per model, plus a random id for this machine so several machines add up correctly.
It never sends prompts, replies, code, file names or project paths. Run sync --dry-run to see the exact payload. The whole script is one readable file.
Several machines
Each machine keeps its own numbers on the server and they add up, so using a laptop and a desktop on one account gives you the combined total. The machine id lives in ~/.showmytokens/device-id and survives logout.
Environment
SHOWMYTOKENS_ORIGIN: point at a self-hosted deployment.CLAUDE_CONFIG_DIR,CODEX_HOME,OPENCODE_DATA_DIR: non-default log locations.
Requires Node 18 or newer. Independent project, not affiliated with Anthropic.
MIT
