# tokenmaxxing

> tokenmaxxing measures AI coding-agent token usage from local logs (Claude Code, Codex, Gemini CLI), prices it at API list rates, and shows how much value a subscription delivered. Publishing to the public leaderboard is optional.

Everything runs locally through `npx tokenmaxxing-cli` (Node 20+, zero dependencies). It reads only the log files the user's agents already write, never reads credentials, uploads nothing until the user runs `link` and `push`, and never edits tool configuration unless the user asks for hooks.

## Set up a user (paste-ready prompt)

```
Set up tokenmaxxing for me: run `npx tokenmaxxing-cli@latest init`, show me the report it prints,
and if I like it run `npx tokenmaxxing-cli link` and open the URL it prints.
Don't edit any of my tool config files unless I say so.
```

## Install commands

```bash
npx tokenmaxxing-cli@latest init
npx tokenmaxxing-cli plan add <provider> <plan> [xN]   # optional; ask which plans (and how many) the user has
npx tokenmaxxing-cli link
npx tokenmaxxing-cli granularity set hour|day|week
npx tokenmaxxing-cli push
```

Show the user the report `init` prints. Ask before setting plans (never guess), before linking, before choosing a granularity, and before pushing. Do not open the link URL yourself unless asked.

## Docs

- [Agent skill](https://tokenmaxxing.fyi/skill.md): the full procedure and rules, as a SKILL.md
- [Setup](https://tokenmaxxing.fyi/setup.md): what gets uploaded, granularity, hooks, uninstall
- [API](https://tokenmaxxing.fyi/api.md): every public endpoint, badges, cards and embeds
- [Privacy policy](https://tokenmaxxing.fyi/privacy)
- [Terms](https://tokenmaxxing.fyi/terms)

Pages also answer in markdown: send `Accept: text/markdown` or add `?format=md` to https://tokenmaxxing.fyi/, /setup, /leaderboard, /u/{handle}, /privacy and /terms.