Context & efficiencyToken-optimization tools

05 — Current objective comparison

Objective comparison of Caveman, Headroom, RTK, and lean-ctx by reach, workload, safety, evidence, and composition.

Summary

No current tool dominates every boundary: Caveman best addresses visible output, RTK shell observations, Headroom broad reversible compression, and lean-ctx integrated retrieval and memory. Cutoff: 2026-08-12. This comparison uses only the current stable releases: Caveman v2.0.0, Headroom v0.34.0, RTK v0.45.0, and lean-ctx v3.9.18. It does not carry benchmark outcomes from superseded versions into current verdicts.

Question and scope

Which current tool best fits each interception boundary, and where does no tool have adequate outcome evidence?

Method

The comparison holds releases to the shared cutoff and scores interception boundary, reversibility, recovery, evidence quality, self-cost, and operational ownership without importing older benchmark results.

Findings

One-screen matrix

AxisCaveman v2.0.0Headroom v0.34.0RTK v0.45.0lean-ctx v3.9.18
Product classOutput skill + input stackBroad compression pipelineShell-output command proxyIntegrated context runtime
Output brevityYes, first-class skillOptional verbosity steeringNoLearned verbosity inside runtime; not a general response-style skill
Input compressionType-routed engine/proxy/MCPType-routed + Kompress modelSupported shell commands onlyReads, shell, search, history proxy
Prevents broad readsPartial through MCP/search pathsPartialNoYes: maps, signatures, graph, search, cached handles
Deterministic coreYesTyped paths yes; Kompress path noYes, entirelyYes by default; optional adaptive/model surfaces
Exact recoveryCCR referenceCCR reference / lossless seamRaw rerun; no general content storeArchive expansion / raw or bounded read
Cache postureSkill neutral; input mode dependentLibrary/MCP narrower risk; proxy mode dependentWrite-time safe by constructionMCP/hook safer; proxy mode dependent
Native agent file toolsOnly when routed through its surfacesVisible on wire/MCPBuilt-in Read/Grep/Glob bypass hookCentral use case
HistoryProxy pathYesNoProxy + memory
Model in hot compression pathNoKompress path yesNoNo by default
Operational footprintSkill small; full v2 stack adds proxy/MCP/storePython/Rust/model/proxy/MCP/wrappersSmallest: binary + hookLargest: daemon, DBs, MCP, hooks, proxy, dashboard
License todayMIT interfaces; BSL-1.1 engine-sideApache-2.0Apache-2.0Apache-2.0
Current independent release-specific A/BNone foundNone foundNone foundNone found
Strongest current evidenceFirst-party v2 fixture benchmarkCurrent mechanism/release evidenceCurrent mechanism/release evidenceObservational field report, exact version undisclosed

Reach determines benefit

A tool can remove 90% of a payload and still save almost nothing if that payload is a small share of task tokens.

net accepted-task effect
  = reachable token share
  × compression on that share
  − fixed prompt/schema/runtime overhead
  − extra turns, retries, raw recoveries, and cache loss
  ± quality-driven downstream work

This equation explains the objective ranking: there is no defensible tool order without a workload trace.

Best tool by measured bottleneck

Visible narration dominates

Start with the Caveman skill, not the full v2 stack. It directly changes the output register and adds the least machinery. Success means visible output falls while clarity, task acceptance, and user correction rate remain unchanged.

Large JSON, logs, RAG, or history dominate

Start with Headroom when content-aware transforms and exact recovery matter. Its mature typed routing and CCR are better matched than RTK's shell boundary. Prefer selected library/MCP calls before a whole-request proxy.

Supported shell output dominates fresh input

Start with RTK. It has the smallest trusted base and no model/schema overhead. First prove the agent actually uses eligible shell calls; native agent reads/search are outside current automatic reach.

Repository traversal and repeated reads dominate

Start with lean-ctx or a narrower retrieval tool. Its maps, signatures, graph, search, and cached handles can prevent the broad read. This is a stronger architectural match than compressing a full file after reading it.

Mixed tool output needs a new local deterministic engine

Trial Caveman v2 against Headroom on the local payload mix. Caveman is newer, deterministic, and recoverable; Headroom is more mature and has wider deployment history. The current public evidence cannot choose for every workload.

Safety comparison

RiskCavemanHeadroomRTKlean-ctx
Omitted exact identifierSkill prose guards; v2 CCRCCR retrievalRaw rerunExpand/raw read
Silent parse/transform failurev2 passes throughMultiple policy/shorter checksPer-filter isolation; command remains realRaw/error escalation and mode controls
Cache disruptionInput proxy path must be testedProxy path must be testedLow: write-time observationProxy path must be tested
Hook conflictCurrent wrappers/hooksCurrent wrappers and adjacent installsCore installation surfaceMany integrations and policies
Supply-chain/runtime breadthSplit-license monorepoPython/Rust/model artifactsSmallestBroadest
Security-sensitive exact workDisable brevity/compression or recover rawRecover rawRerun rawFull/bounded read + normal verification

No lossy summary is authoritative. Tests prove system behavior; raw source proves exact text; compression counters prove neither.

Objective strengths

Caveman

  • Best output-control surface.
  • New deterministic, type-aware input engine.
  • Current shorter-only and recovery design is strong.
  • Weakest point: v2 maturity and split BSL licensing.

Headroom

  • Best mature broad reversible input pipeline.
  • Strongest deployment flexibility and typed payload coverage.
  • Weakest point: runtime/installation complexity and absent current independent A/B.

RTK

  • Best minimal deterministic shell filter.
  • Lowest machinery and clearest cache behavior.
  • Weakest point: strict reach ceiling; current task-level benefit unproven.

lean-ctx

  • Best integrated repository-context and read-prevention system.
  • Unique combination of graph, memory, recovery, policy, and ledger.
  • Weakest point: largest operational surface and difficult attribution.

What “good” means for each

ToolKeep it only if…Reject it if…
Caveman skillOutput drops and human clarity stays intactCorrections/re-explanations erase the saving
Caveman v2Fresh input per accepted task falls and CCR recovery worksWrapper/proxy overhead or recovery turns erase benefit
HeadroomStructured/history input falls after cache effects at unchanged qualityLatency, model/store overhead, or extra retrieval dominates
RTKEligible shell output is material and turns/rereads do not riseNative tools or quiet commands dominate
lean-ctxRaw reads fall and edit correctness stays unchangedSetup/runtime overhead exceeds avoided context

Implications for jackin

Composition verdict

Use one output layer plus, at most, one measured input/retrieval layer. Caveman's skill is orthogonal to input tools. Caveman v2, Headroom, RTK, and lean-ctx overlap on observations. Blindly stacking them makes failures harder to recover and savings impossible to attribute.

Current recommendation:

  1. retrieval or precise reads before lossy compression;
  2. deterministic write-time compression before a global proxy;
  3. reversible broad compression when the payload demands it;
  4. output brevity as a separate, independently measured choice.

Next: 06 — Current rising tools and composition.

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