v0.2.0

The first public release. Trimloop reads the session logs Claude Code keeps on your machine, works out where your tokens went, and tells you which changes to how you work would save the most. It sends nothing anywhere. It is an early prototype: it recommends, and changes nothing for you.

What's in it

• A report of where the spend went and what to do first, as a short summary, full text, a web page (trimloop --open) or JSON. --since shows whether a change worked, and weekly figures are kept between runs.
• Nine kinds of waste: long sessions, long breaks, cache lost during short waits, tool output, what every request carries, model choice, effort level, model switches and replies cut off.
• Usage limits for Pro and Max subscribers: your plan, how often you hit a limit, and savings as a share of your weekly limit once the status line is set up.
• Live nudges in Claude Code: a status line and two hooks, added by trimloop setup.
• A Claude Code plugin: ask "where did my tokens go?" and Claude runs trimloop and explains the result.

Install

brew install --cask chrisadkin8/tap/trimloop

Or download an archive, .deb or .rpm below (macOS and Linux, amd64 and arm64). The README has the detail.

Good to know

• Costs are estimates at Anthropic's list prices, not your bill.
• The macOS binaries are not yet notarised by Apple. The Homebrew cask clears the quarantine flag for you; for a download, see "Checking a download" in the README.
• Feedback is welcome in Discussions and issues.

All 34 commits

• Add a Claude Code plugin with a trimloop skill (ADR 0049)
• Add the concepts deck's source in docs/deck
• Add the second gap analysis's findings to the report (ADR 0050)
• Build the whole report in one call to report.Analyse
• Check the report end to end against an independent recount
• Count sed's first file only; say "1 time" everywhere
• Fix first-time-user problems; pin compaction weeks and bad lines
• Fix re-read counting, project attribution and setup bugs
• Fix the findings of a repo review: a crash, temp files, links, wording
• Fix the findings of a second review: names, likely savings, live input
• Fix the findings of a third review (ADR 0052)
• Fix the findings of a third review: sub-agent projects, model ids, limits
• Fix the findings of a three-part review (ADR 0051)
• Follow cd in shell views; fix median, labels and "1 times"
• Harden log text, report writes and setup backups; fix compaction counts
• Keep Claude Code's details in its reader, out of internal/sessions
• Move session building from main into internal/sessions
• One cache-write rule in code, doc and recount; band means on priced turns
• Prepare v0.2.0, the first public release
• README: add clone commands, say where weekly figures show, and when the countdown appears
• README: an Install section, shorter sections, terms explained; example report
• README: badges, and a corrected architecture diagram sized for GitHub
• README: correct four statements, move download checks into Install
• README: fix a wrong figure, explain terms, move release steps out
• README: make "install trimloop first" stand out in the plugin section
• README: name a security channel, explain the licence, tighten wording
• README: replace the licence description with a link to LICENSE.md
• README: say how to check the Claude Code plugin works
• Record projects by conversation and the ranking exception (ADR 0053)
• Refresh the example report and the README sample from a run to 10 Nov
• Relicense the repository under Apache-2.0 (ADR 0054)
• Say "1 turn" on the model and effort cards; drop two unused page fields
• Share the cache clock and the carried-until-compaction walk
• Strengthen the end-to-end test: zones, strict tolerance, price content

Verify a download: see "Checking a download" in the README.
Licence: Apache-2.0.