git:20261025.93927ad to git:20261101.f416dd5

10 added, 4 removed. Audit A to A.

---

name: sessions

description: Measure where tokens actually went in recent Claude Code sessions, from the local transcripts.

disable-model-invocation: true

- allowed-tools: Bash(tokendoctor-sessions *)

+ allowed-tools: Bash(tokendoctor-sessions *), Bash(tokendoctor-replay *)

argument-hint: [days]

---

Measure token spend from this machine's session transcripts over the last `$ARGUMENTS` days (30 if

none given).

- 1. Run `tokendoctor-sessions --json --days <n>`. It is read-only and reads only usage figures,

- timestamps, tool names and file paths from the transcripts, never message text.

+ 1. Run `tokendoctor-sessions --json --days <n>` and `tokendoctor-replay --json --days <n>`. Both

+ are read-only and read only usage figures, timestamps, tool names and file paths from the

+ transcripts, never message text.

2. Costs are in input-token equivalents: relative API prices, with no per-model price applied.

Present them as shares (percent), never as dollars.

- 3. Lead with the two or three largest shares: main thread against subagents, the share spent with

+ 3. Open with the person's own number: what share of the period's cost a smaller compaction window

+ would have saved, from the replay (the 400K row, and 200K or 300K where they save much more).

+ Call it an upper bound: the replay cannot see the work a model does again after a summary. If

+ the window is already at or under 400K, or almost no session passed it, say the window would

+ change little for them, rather than leading with a small number.

+ Then lead with the two or three largest shares: main thread against subagents, the share spent with

more than 400K tokens in context, and the subagent types that cost the most. Then present each

finding in one or two plain sentences with its doc link.

4. Connect findings to settings where they apply: `late-compaction` to `autoCompactWindow`,

`subagents-on-top-model` to `CLAUDE_CODE_SUBAGENT_MODEL` and the Explore override. Offer

`/tokendoctor:audit` to check and fix them. Never edit files from this skill.

5. When asked about a trend or whether a change helped, run `tokendoctor-sessions --by day` (or

`--by week`, with `--days <n>`) and compare the periods before and after. Days older than the

transcripts come from the history the plugin's SessionStart hook records.

6. Say what this cannot see: per-model prices, sessions on other machines, and transcripts Claude

Code has already cleaned up.