# caveman v2.1.0

- Product: caveman (https://whatsnew.fyi/product/caveman)
- Vendor: Julius Brussee
- Date: 2026-08-16
- Version: v2.1.0
- Original notes: https://github.com/JuliusBrussee/caveman/releases/tag/v2.1.0
- Permalink: https://whatsnew.fyi/product/caveman/releases/v2.1.0

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

---

- **added** — Context-depth report showing each session's peak context-window share, bucketed, with over-30% and over-50% counts
- **added** — Report UI with TLDR summary, two-card savings display showing proxy-measured saved-so-far and replay could-have-saved, and 30-day list-price cost illustration
- **added** — Persisted shortcut and token telemetry in CLI
- **added** — New twenty-chapter technical manual under docs/technical/
- **changed** — README rewritten as a landing page with proxy-first install, caveman learn showcase with real report screenshot, and skills-as-images
- **changed** — Skill forbids caveman phrasing that adds tokens and names defect/ticket text
- **changed** — Hooks resolve punctuated /caveman levels and stop prose firing mode triggers
- **fixed** — Hooks degrade instead of crashing when a sibling hook file is missing
- **fixed** — Compress: indented fence markers no longer break inline-code validation
- **changed** — Installer installs Cursor skills globally
- **fixed** — SSRF block errors now name the allowlist escape hatch
- **changed** — Opencode agents drop provider-less model values

##### Caveman 2.1.0

###### caveman learn
- Context-depth report: each session's peak context-window share, bucketed, with over-30%/over-50% counts.
- Report UI: TLDR summary, two-card savings (proxy-measured saved-so-far + replay could-have-saved), 30-day list-price cost illustration.

###### CLI
- Persisted shortcut and token telemetry (feat/cli).

###### Skill and hooks
- Skill forbids caveman phrasing that adds tokens; names defect/ticket text.
- Hooks resolve punctuated /caveman levels and stop prose firing mode triggers; degrade instead of crashing when a sibling hook file is missing.
- Compress: indented fence markers no longer break inline-code validation.
- Installer installs Cursor skills globally; SSRF block errors name the allowlist escape hatch; opencode agents drop provider-less model values.

###### Docs
- New twenty-chapter technical manual under docs/technical/.
- README rewritten as a landing page: proxy-first install, caveman learn showcase with a real report screenshot, skills-as-images.

All local numbers remain `inferred`; benchmark numbers remain `benchmark_counterfactual`. Installer pins bumped to v2.1.0.