llms.txt@site/public git:20261025.99a4e60A

Immutable. This exact content never changes and is served at /api/v1/blob/d34c2d8e90d8bade.

# tokendoctor

> tokendoctor is a Claude Code plugin that shows where tokens actually go (from local session
> transcripts, with a daily trend), audits a setup with 31 checks tied to the Claude Code docs, and
> changes a setting only after the person approves the exact diff. Everything runs locally; it reads
> usage figures and file paths, never message text.

## Install

- `claude plugin marketplace add rsaryev/tokendoctor`
- `claude plugin install tokendoctor@tokendoctor`

## Use

- `/tokendoctor:sessions [days]` measures spend from local transcripts: main thread against subagents, spend with a very full context, subagent types, cache rebuilds. `tokendoctor-sessions --by day|week` shows the trend.
- `/tokendoctor:audit` lists findings by severity, each with a link to the documentation page it rests on. Read-only.
- `/tokendoctor:optimize [focus]` proposes setting changes backed by the measurements and applies the ones the person picks, each through a dialog that shows the change.
- `/tokendoctor:apply <finding-id>` shows a dry run, asks for confirmation, then writes. An existing file is copied to `<file>.tokendoctor-<timestamp>.bak` first.
- From a shell: `tokendoctor-sessions`, `tokendoctor-audit`, `tokendoctor-set`, `tokendoctor-apply`.

## Links

- Source and the full rule list: https://github.com/rsaryev/tokendoctor