# tokendoctor

> tokendoctor is a Claude Code plugin that audits a setup for settings that waste tokens or
> silently do nothing, and applies fixes only after showing the exact change. It checks
> configuration against documented Claude Code behaviour with 27 rules; it does not measure
> savings. It adds no hooks and no MCP servers, and about 46 tokens to a session.

## Install

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

## Use

- `/tokendoctor:audit` lists findings by severity, each with a link to the documentation page it rests on. Read-only.
- `/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-audit [--project <dir>] [--json]` and `tokendoctor-apply <finding-id> [--scope user|project|local] [--write]`.

## Links

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