v0.2.0

v0.2.0 — the receipt is in

Since v0.1.2: opencode + Gemini integration, the compression receipt, replay, artifact paths, savings reports, and a GC that finally agrees with itself. 20+ tests.

What's new since v0.1.2

• opencode + Gemini integration — costmaxx install --target opencode registers the MCP server in opencode.jsonc (with backup). A companion plugin (~/.config/opencode/plugins/costmaxx.ts) auto-compresses bash tool results above a threshold (default 20k chars) into the same cmx://artifact/<id> envelopes. The MCP server also serves Gemini CLI.
• Compression receipt — every envelope now carries a machine-parseable Receipt: line: kept X/Y lines | dropped N B | tests failed: A, B, +N more (failing IDs capped at 5, deduped). Agents act on the receipt without fetching the artifact.
• costmaxx replay <id> — re-runs the stored command in its stored working directory, propagating the original exit code.
• costmaxx artifact path <id> — prints the on-disk storage path of any artifact.
• Savings reports — costmaxx report <session> for per-session metrics, costmaxx savings --since 168h for aggregate window reports (a daily launchd job logs one automatically).
• GC consistency + concurrency fixes — costmaxx gc --older-than=… now removes files and metadata atomically; artifact writes are safe under concurrent sessions.
• 20+ tests — run them: go test -buildvcs=false -count=1 ./...

Install

go install github.com/derinbarutcu17/costmaxx/cmd/costmax@latest

# Codex
costmaxx install
# opencode
costmaxx install --target opencode
# verify
costmaxx doctor

Or grab a release binary (all platforms): see the assets below.

The numbers, as always

Live self-measured, one week on the author's daily stack (opencode + Codex, deepseek-v4-flash): 392,748 raw input tokens → 51,820 model-visible (86.8%), 1.04 MB of evidence dropped from context — all stored losslessly. Deterministic eval: 60.6% less model-visible output (20 fixtures × 3 reps), 60/60 answer-signal retention, audited from raw transcripts.

We don't claim billed-dollar savings. These are measured token reductions, and you can re-measure them yourself: costmaxx savings. Full honesty notes: HONEST-NUMBERS.md · setup: docs/INSTALL.md · benchmark methodology: docs/benchmark-methodology.md

v0.1.2

Changelog

• 6d34524 fix: bind cobra version after build-info resolution

v0.1.1

Changelog

• 4ce2e0e fix: report version from build info when installed via go install

v0.1.0

Changelog

• 7fe6804 feat: costmaxx v1 — live-proven MCP output reduction + repo polish