Context & efficiencyToken-optimization tools

07 — Current evidence and evaluation

Evidence ledger, claim-quality rules, counterfactual limits, and neutral evaluation protocol for token-optimization tools.

Summary

Current tool claims support mechanism comparisons, not universal savings: accepted-task A/B evidence remains sparse and version-specific. Cutoff: 2026-08-12. This ledger admits tool outcome evidence only when it tests the current stable release or clearly states that the exact version is undisclosed. Older-version outcomes are not treated as current tool evidence.

Question and scope

What current outcome evidence supports each tool, and which claims remain mechanism demonstrations rather than accepted-task proof?

Method

The ledger accepts current-release outcome evidence or explicitly version-undisclosed field evidence, grades source independence and counterfactual quality, and rejects payload ratios as task savings.

Findings

Current evidence ledger

ToolCurrent stableCurrent outcome evidence foundTierObjective conclusion
Cavemanv2.0.0Current first-party six-fixture wrap benchmark: pinned setup, three reps, exact-answer checks, 33.2% reported input reductionT4 outcome; T1 mechanismUseful reproducible fixture evidence; no independent current accepted-task A/B
Headroomv0.34.0Current release tests, payload benchmarks, counters, and a competitor-owned arm in Caveman's current benchmarkT4 outcome; T1 mechanismBroad mechanism established; no independent v0.34.0 end-to-end result found
RTKv0.45.0Current command examples and gross gain counterT4 outcome; T1 mechanismFiltering works; no independent v0.45.0 accepted-task result found
lean-ctxv3.9.18Current public field report is observational and does not name exact versionT3, version-unspecifiedSupports discovery/raw-verification workflow; does not prove v3.9.18 causality
pxpipev0.13.1Current repository counters and vendor testsT4 outcome; T1 mechanismModality mechanism is inspectable; current independent task proof absent
Context Modev1.0.169Current repository claims/countersT4 outcome; T1 mechanismSandbox/retrieval mechanism is clear; current independent release-specific proof absent
Paritokv1.3.3 tagCurrent first-party model card/SWE-bench compression resultT4Reports both compression and quality loss; independent replication absent
jCodeMunchv1.108.271Current release's Codex net-token benchmark is negative/inconclusiveT4, negativeDo not convert payload-retrieval ratios into current task savings

“No current independent benchmark found” is a research result. It is more accurate than borrowing a result from superseded code.

Current general evidence

Two recent papers remain relevant because they test mechanisms, not old releases:

  • CAVEWOMAN separates linguistic input and output compression across eight models, five datasets, and five reduction levels. Output compression usually reduced realized cost; linguistic input compression increased mean net cost and damaged accuracy. This supports treating Caveman's output skill and v2 input engine as different interventions. It does not test tool-aware recoverable coding-agent compression.
  • Notation Matters tests TOON/TRON in four agentic benchmarks and five open models. Token reductions came with accuracy loss, and multi-turn parse failures could cascade. This is directly relevant to any current product enabling compact notation, but does not prove a specific implementation unsafe.

Claim hygiene

Every percentage must name five things:

  1. version — exact tool build;
  2. denominator — payload, fresh input, total tokens, bill, quota, or accepted task;
  3. coverage — which traffic the tool could touch;
  4. quality gate — tests, correctness, human review, or non-inferiority bound;
  5. counterfactual — same task/model/cache/repository state without the tool.

Without all five, the number is discovery evidence only.

Why tool counters are insufficient

Local counters usually compute something like:

raw payload estimate − emitted payload estimate = gross saved

They cannot see the alternative future. A shorter result may cause extra searches, raw reruns, longer reasoning, changed cache reads, or a wrong edit. A correct task may finish sooner. Only paired task runs measure that net path.

Current neutral bake-off

Use the exact latest releases in the current register. Pin the agent, model, effort, repository commit, tool configuration, timeouts, and provider cache policy.

Arms

A  no optimization tool
B  Caveman skill only
C  Caveman v2 input only
D  Headroom selected-input mode
E  RTK
F  lean-ctx selected-read mode
G  one rising tool justified by the traced bottleneck

Do not test stacked tools until individual arms establish benefit.

Workload

  • Real tasks sampled across small fixes, repository discovery, test/build failure, refactor, docs, structured-data inspection, and long-session continuation.
  • Same starting repository state per run.
  • Randomized arm order and multiple repetitions.
  • Network and tool permissions identical.
  • Predeclared acceptance tests plus review of exact diff behavior.

Measurements

ClassRequired measurement
QualityAccepted-task rate, tests, review, regression severity
TokensFresh input, cache write, cache read, reasoning, visible output
BehaviorTurns, tool calls, raw recoveries, rereads, retries, compactions
RuntimeWall time, compressor latency, local CPU/GPU/RAM, store growth
Self-costSkill prompt, MCP schema, injected metadata, daemon/proxy traffic
ReliabilityBypass success, failure passthrough, exact recovery, hook conflicts
StatisticsPaired median delta, dispersion/confidence interval, failure examples

Decision metric

Keep a tool only when:

tokens or subscription quota per accepted task decreases
AND quality is non-inferior
AND failure recovery and operational policy pass

Payload ratios, GitHub stars, and gross self-counters are not substitutes.

Implications for jackin

Current evidence verdict

The latest releases are moving faster than independent evaluation. Caveman v2 has the clearest current reproducible fixture benchmark; lean-ctx has the strongest current public field observation, but no exact version; Headroom and RTK have well-inspected current mechanisms without independent latest-release task evidence. Therefore the objective answer remains conditional: trace, isolate one layer, run a current-version A/B, keep only measured net benefit.

Next: 08 — Current release register.

Limitations and unknowns

Tool behavior, releases, licenses, and outcome evidence can change; reverify the current version and integration boundary before adoption.

Sources

Evidence and repository references are cited inline beside the claims they support.

On this page