trove Install

Updated November 2026 · Trove v0.4.0

Measured results.

How much of a coding-agent bill Trove saves on scripted sessions replayed through the real engine, and what it costs in quality.

Install
brew install usetrove/trove/trove

Free and open source. Nothing leaves your machine. Run trove on your own sessions and see your own numbers.

The headline numbers

72.0%estimated

Median saving on 7 scripted workflows for an agent or script that sends no cache markers (range 51.6% to 79.8%). Trove switches prompt caching on for it.

19.3%estimated

Median on 3 scripted output-heavy sessions (range 2.5% to 50.7%). A monorepo test loop reaches 50.7%.

698 of 698measured

Failure and error lines still visible to the model after trimming.

Scripted sessions, replayed through the real engine with no API calls. They are not a forecast of anyone's bill. Claude Code already caches its own prompt, so the no-cache figure does not apply to it.

Does it cost quality?

Every check below is measured, not estimated.

698 of 698measured

Failure and error lines still visible to the model.

400 of 400measured

Requests kept the cached prefix byte-identical. 0 broken invariants; repeat runs byte-identical.

90 of 90measured

Aider tasks passed with Trove's optimizers on and with them off.

2.54 msmeasured

Engine time per request at p50 (p99 17.09 ms), measured in-process on one machine, excluding the gateway's forwarding time.

You don't have to take our word for it

Benchmarks say what Trove does on these sessions. Your sessions are what matter. So every fix starts in shadow mode, where it runs on a copy of your requests and records what it would have saved, minus its own overhead. It turns on only when that evidence is there, only between sessions, and it rolls itself back if the net saving goes negative.

Share of the bill saved

Trove shrinks repeated and noisy tool output without disturbing the part of the prompt your provider already has cached, and switches prompt caching on for agents that do not use it.

  • No cache markers (7 workflows)72.0% est.
  • Output-heavy (3 workflows)19.3% est.
  • Everyday (7 workflows), median3.7% est.
  • Everyday: 94-turn feature session8.6% est.

Median per kind of session. Everyday sessions already run on a cached prompt, so they leave the least to trim. The 94-turn feature session saves 8.6%, the most of any everyday workflow.

Scripted everyday sessions, replayed through the real engine

Short benchmark tasks cannot show a long working day, so trove bench workflows replays hand-scripted Claude Code sessions through the real optimizer engine, offline: no API call, no spend. How often a file is re-read, how noisy a shell is and how long a session runs are assumptions, so these figures say what the optimizers do on these patterns. They are not a forecast of anyone's bill. Model claude-sonnet-5-5, list prices as of 2026-11-08.

Kind of sessionMedian saving (range)Label
Everyday: fix a failing test, rename across a codebase, debug with logs, explore a repo, a ~90-turn feature session (7 workflows)3.7% (0.0% to 8.6%)estimated
Output-heavy: a verbose test loop, a failing container build, incident logs (3 workflows)19.3% (2.5% to 50.7%)estimated
A custom agent or script that sends no cache markers (the 7 everyday workflows again)72.0% (51.6% to 79.8%)estimated

Saving per workflow (estimated)

Everyday

  • quick-question0.0% est.
  • fix-failing-test0.0% est.
  • debug-with-logs3.7% est.
  • dependency-upgrade5.1% est.
  • rename-across-codebase0.0% est.
  • explore-and-review7.0% est.
  • long-feature-session8.6% est.

Output-heavy

  • ci-failure-triage50.7% est.
  • container-build-debug19.3% est.
  • incident-log-forensics2.5% est.

Custom agent, no cache markers

  • quick-question (no caching)51.6% est.
  • fix-failing-test (no caching)70.9% est.
  • debug-with-logs (no caching)79.0% est.
  • dependency-upgrade (no caching)67.3% est.
  • rename-across-codebase (no caching)78.3% est.
  • explore-and-review (no caching)72.0% est.
  • long-feature-session (no caching)79.8% est.
Full per-workflow table
WorkflowTierTurnsCost off (est.)Cost on (est.)Saving (est.)Key lines keptPrefix kept
quick-questioneveryday3$0.0635$0.06350.0%0/03/3
fix-failing-testeveryday12$0.1418$0.14180.0%10/1012/12
debug-with-logseveryday12$0.2730$0.26283.7%70/7012/12
dependency-upgradeeveryday10$0.1594$0.15135.1%10/1010/10
rename-across-codebaseeveryday28$0.5567$0.55660.0%8/828/28
explore-and-revieweveryday20$0.4750$0.44167.0%0/020/20
long-feature-sessioneveryday94$3.5912$3.28068.6%80/8094/94
ci-failure-triageheavy15$0.4420$0.218150.7%4/415/15
container-build-debugheavy14$0.2675$0.215919.3%66/6614/14
incident-log-forensicsheavy13$0.4405$0.42952.5%276/27613/13
quick-question (no caching)custom agent3$0.1234$0.059751.6%0/03/3
fix-failing-test (no caching)custom agent12$0.6819$0.198670.9%10/1012/12
debug-with-logs (no caching)custom agent12$0.7231$0.151779.0%57/5712/12
dependency-upgrade (no caching)custom agent10$0.4826$0.157767.3%10/1010/10
rename-across-codebase (no caching)custom agent28$2.2186$0.481478.3%8/828/28
explore-and-review (no caching)custom agent20$1.4643$0.409772.0%0/020/20
long-feature-session (no caching)custom agent94$16.4598$3.332179.8%89/8994/94

How it was measured

Hand-scripted Claude Code sessions were replayed offline through the real optimizer engine, with no API calls. Two pre-registered studies ran the gateway on real tasks (Aider polyglot and SWE-bench Verified).

Where things stand. Scripted sessions show Trove helping where there is real waste: output-heavy work and agents that do not cache. On short real tasks, two pre-registered studies found no saving that can be told apart from noise. Trove makes no savings promise.

Real-task studies, decision rule and caveats

Real tasks, two pre-registered studies

Does the gateway with its safe optimizers on cost less than the same gateway with every optimizer off? Costs are estimated (list price on the token counts the agent reports). Pass or fail is measured.

MeasureAider polyglot, 30 tasksSWE-bench Verified, 35 tasks
Studygateway-cost-2swebench-gateway-2
Model, agentclaude-haiku-5-5, Claude Code 2.1.318claude-sonnet-5-5, Claude Code 2.1.319
Runs180 (90 pairs)140 (35 pairs per comparison)
Median paired cost change, all_safe vs passthrough (estimated)−3.0% (95% interval −9.5% to +3.7%)+4.4% (95% interval −7.0% to +13.8%)
Success (measured)90 of 90 under both28 of 35 vs 29 of 35
Mean cost per run (estimated)about $0.0026about $0.02 to $0.03

The two studies point in opposite directions, which shows how wide the noise is. In the SWE-bench study the two single optimizers were also within noise: noise_normalizer 0.0% (−11.0% to +20.0%) and duplicate_result_collapser +1.9% (−11.6% to +26.0%). The gateway's own records say the optimizers had almost nothing to remove: the median SWE-bench session was 5 turns, and all_safe removed about 0.2% of input tokens (estimated). A saving of that size cannot move a bill.

Decision rule

Trove recommends an optimizer for automatic use only if its cost reduction is at least 5% and the whole 95% interval lies at or below −5%, with the success rate not falling by more than 5 points and at least 30 pairs. Neither real-task study met that bar, so Trove does not claim a saving on real tasks yet. A result is never rounded up.

Caveats

  • Two models and two Claude Code versions across the real-task studies; results may differ for other models, versions or longer sessions.
  • Costs are list-price estimates, never an invoice.
  • Token counts in the scripted runs use the engine's bytes-per-token ratio, not provider counts.
  • The heavy tier was written to be waste-rich.
  • The SWE-bench study ran on a separate machine and its result files are not yet in the repository.

Reproduce

python -m trovebench fetch polyglot -n 30 --seed 20261108
python -m trovebench run --study studies/gateway-cost-2.yaml --tasks <that folder> --batch <folder> --yes
bash bench/scripts/95_workflows.sh

Read the methodology and the published workflow reports.

Open source. Runs on your machine. trove uninstall puts everything back.