Case studyShadow / observeSnapshot 2026-08-09 10:10 UTC

Token capacity from tool-result reduction.

A counterfactual replay of 61 eligible sessions from an anonymized two-user software organization, measured over a rolling 15-day workload.

Window
Rolling 15 days · from 2026-07-25 10:10 UTC
Organization
Anonymized two-user software organization
Operating mode
Shadow / observe
Metric
Text tool-result tokens · no dollar conversion

Executive result

676,061

of 4,106,180 text tool-result tokens removed

16.46%

text tool-result reduction

19.71%

equivalent tool-result capacity increase

Replaying the current ReclaimLLM implementation over the organization's eligible captured sessions reduced the replayed stream to 3,430,119 tokens without re-running historical commands or calling a model.

Every 1 million text tool-result tokens in this workload would require about 835,400 tokens after reduction. The remaining budget could carry roughly 197,100 additional tokens of equivalent original tool-result workload.

Capacity calculation

676,061 / 3,430,119 = 19.71%
This is a measured counterfactual from shadow data, not realized production savings. It does not mean total model input, total billing, or total organizational AI usage would improve by 16.46% or 19.71%.

Organization workload

A small organization with one heavy user.

One user generated 99.99% of captured token volume. This is operationally a single-heavy-user case study, not evidence about adoption across a broad workforce.

MeasureFifteen-day value
Users2
Sessions183
Tool calls19,765
Captured input tokens680,199,930
Captured output tokens15,149,757
Captured total tokens695,349,687

The captured-token total describes the organization; it is not Replay's denominator. Prompt caching, provider reporting coverage, and different accounting paths make it unsuitable for converting Replay directly into a total-bill reduction.

Replay evidence

Current implementation, real tokenizer, bounded eligibility.

Replay used o200k_base and runtime implementation 0.1.27. It evaluated range caching, shell compaction, and hash deduplication.

The 5-turn and 5-tool-call thresholds match the earlier session analysis. They are below the documented 10/10 evidence floor and are disclosed rather than treated as equivalent evidence.

Eligibility stageSessions
Considered97
Eligible and replayed61
Excluded36

Of 36 exclusions, 29 lacked enough replay-eligible calls, 3 exceeded the allowable unresolvable share, and 4 lacked enough text-result tokens. Eligible share: 62.89%. Replay classified sample confidence as full.

SourceOriginal tokensTokens removedReductionCapacity increase
Codex937,064375,75040.10%66.94%
Claude2,701,205266,3039.86%10.94%
Unattributed396,65332,3798.16%8.89%
Gemini71,2581,6292.29%2.34%
Total4,106,180676,06116.46%19.71%

Provider spread reflects workload mix, not inherent provider compressibility. Codex sessions contained more repeated reads and long shell/search outputs; Claude carried most original volume with a lower reducible share.

rg

180,616 removed tokens

sed

136,785 removed tokens

cd-prefixed shell

136,688 removed tokens

Together these command families represented 67.17% of the replayed reduction.

Capacity projection

A straight-line illustration, not a forecast.

If workload mix and volume remained unchanged, the replay result scales to the following direct text tool-result reduction.

PeriodOriginal tool-result tokensTokens removedReduced tool-result tokens
Observed 15 days4,106,180676,0613,430,119
Illustrative 30 days8,212,3601,352,1226,860,238
Illustrative 365 days99,917,04716,450,81883,466,229

The 30-day and annual figures do not account for team growth, workload changes, seasonality, or agent behavior under enforcement.

Shadow telemetry cross-check

Independent evidence, kept separate.

Live session rows provide an independent shadow-era measurement. They are not added to or averaged with Replay.

Runtime telemetry measureValue
Sessions with mechanism telemetry63 of 183
Sessions with a measured non-zero reduction49 of 183
Measured projected reduction4,807,340 tokens

One search-shaping event contributed 4,082,635 tokens, or 84.93% of the runtime total. Removing it leaves 724,705 tokens across the rest of the telemetry cohort. One observation should not set the expected organization-wide rate.

Runtime telemetry uses the labeled chars_div_4_v1estimator; Replay uses a real tokenizer. Replay reported that the estimator undercounted comparable measurements by 13.56%. Different corpus, coverage, attribution, and outlier distributions keep these totals separate.

The organization confirms the rollout remained in shadow mode. No runtime total is presented as realized production savings.

Interpretation

Supported

On 61 eligible sessions from a 15-day captured workload, Replay of the current implementation removed 676,061 of 4,106,180 text tool-result tokens (16.46%). Within that portion of context, the same token budget could carry 19.71% more equivalent workload.

Not supported

  • Total organizational model tokens would fall by 16.46%.
  • The organization would receive 19.71% more completed tasks.
  • Provider bills would fall by the same percentage.
  • Output quality and task correctness would remain unchanged under enforcement.

Replay never invokes a model. It cannot observe path changes, retries, or turn-count effects, which may make real-world impact lower—or negative. Prompt caching can also change billable tokens without changing the raw context reduction measured here.

Recommended next measurement

Prove reduction under enforcement without degrading the work.

Enable the current implementation for a bounded cohort and compare it with the shadow baseline. Keep provider/model groups separate and measure input tokens, cache reads and writes, turns, retries, task completion, and mechanism adoption. Success requires the reduction to persist without materially increasing turns, retries, or failed tasks.

Explore token reduction →View rclm on PyPI ↗

Until then, 16.46% reduction and 19.71% equivalent capacity increase are the defensible case-study figures.