v4.5.0

Highlights

Three new capabilities, all opt-in and additive:

• Cross-session memory — tokensave_record_decision, tokensave_record_code_area, tokensave_session_recall. Agents persist design choices and worked-on paths to FTS5-backed tables in the per-project DB. Recall across sessions.
• Savings ledger + tokensave gain CLI — every MCP tool call appends to ~/.tokensave/global.db. tokensave gain [--all] [--history] [--range 7d] [--json] reports tokens saved + USD estimates (Sonnet input pricing via LiteLLM).
• tokensave bench reproducible retrieval benchmark — runs a fixed query set through tokensave_context and reports retrieval savings vs a full-file baseline. 10-query generic default embedded in the binary; pass --queries <file> for a custom set.

Measured against tokensave's own repo with the embedded generic queries: 93% mean retrieval savings (180K → 3.4K tokens across 10 queries).

Schema migration

DB version bumped from v7 to v8. Existing user DBs auto-upgrade idempotently on first use of v4.5.0. Fresh installs get the full schema directly. No breaking changes.

Tool count

52 → 55 MCP tools.

Full changelog

See CHANGELOG.md.