v0.9.19

One version across every surface: CLI, macOS menubar, and the desktop app all ship as 0.9.19.

Accuracy

• Every surface now shows the same numbers. CLI, TUI, menubar, desktop app, and web dashboard totals all come from one durable aggregation path and match exactly, including history whose session logs have since been deleted; the terminal overview notes how much was preserved from expired logs. (#755, #760, #759)
• Never lose history again. The daily cache carries forward every (day, provider) slice a re-parse can no longer derive, and adopts days from older cache generations instead of wiping them on schema changes. (#755)
• True Lifetime period on the CLI, dashboard, desktop app, and menubar. The desktop tab formerly labeled "All time" showed a 6-month window; it now says "Last 6 months", and Lifetime is the real all-time view. (#753, #759)
• Yield repo grouping is case-correct on macOS/Windows; skills usage is attributed regardless of turn category; daily-activity history scans are bounded. (#751, #745, #727)
• Days before recorded history render as "No data recorded", never as a currency zero, in the desktop heatmap, daily charts, and web dashboard. Genuinely idle days keep their true zeros. (#765)
• Incremental append parsing falls back to a full re-parse when a streamed assistant message restates across the append boundary, fixing a rare over-count on image-heavy sessions. (#772)
• Turn-level stats (edit turns, one-shot, category counts) attribute to exactly one provider slice, so per-provider sums always equal day totals. (#762, thanks @ozymandiashh)
• Workflow-intelligence accuracy pass from review: corrections count only follow-up prompts, file-churn paths are separator-normalized so the payload's basename privacy redaction works on Windows, pricing coverage excludes deliberately-free local models and reports null (never a fabricated 100%) when not computable, and time-to-first-edit is null rather than mismeasured on unparseable timestamps. (#763, review by @ozymandiashh)
• Daily-history retention extended from 2 to 10 years so carried days can never age out of the durable record; quota pace guards non-finite inputs; the exchange-rate cache honors CODEBURN_CACHE_DIR. (#764, #766)

Added (CLI)

• Quick Desktop provider — Amazon Quick Desktop usage from ~/.quickwork, with real metered costs and multi-profile discovery. (#735, thanks @gjmveloso, @Enclavet)
• Kimi Code provider — Kimi Code CLI (kimi-k3) wire sessions from ~/.kimi-code. (#750, #747)
• Workflow intelligence in optimize and the payload: user-correction rate, median time to first edit, most-reworked files, pricing coverage, and coaching notes. (#756)
• Richer session capture: git branch, lines added/removed (counted from diffs, never stored as text), interruptions, tool errors, session titles, and PR links now land in the local cache for upcoming per-branch and code-impact reports. (#758)
• Provider-agnostic quota window model with provenance; doctor warns when transcript retention is about to expire history. (#740, #757)

Performance

• Large-line session parsing is ~2x faster (single-pass field extraction), and files that grew by append are parsed incrementally from the cached offset instead of from byte 0. (#752, #749)
• Concurrent CLI, menubar, and MCP processes can no longer clobber each other's cache work: the warm session-cache refresh runs under a strict cross-process gate with heartbeat, staleness takeover, and a publication fence; a timed-out waiter serves the prior complete snapshot read-only instead of racing. (#743, thanks @avs-io)

Desktop app

• Windows fixed: the CLI is now found on every Windows install (path handling was POSIX-only, breaking 100% of Windows installs). (#733)
• In-app update notifications and an About-dialog update check; this is the first release existing 0.9.17 installs will be notified about. (#722, #738)
• Faster and calmer on data-heavy machines: CLI spawns are capped and prioritized so clicks never queue behind background work, provider prefetch is paced, and the default period is Today. (#748)
• Telemetry (opt-in, anonymous) reports per-provider spend buckets, richer error detail with a per-kind daily cap, and a reliable session-close beat. (#736, #742, #746)

Menubar

• Codex quota windows show linear pace: deficit/reserve, projection, and run-out ETA. (#728, #726)

0.9.15 - 2026-07-02

Added (CLI)

• codeburn context. See what fills a session's context window, by role

Contributors

Thanks to everyone who shipped in this release:

• @ozymandiashh — single-slice turn attribution, and the deep review passes across the accuracy work
• @avs-io — the cross-process cache refresh gate, the quota window model, and the menubar quota pace
• @0monish — the Lifetime period
• @ihearttokyo — bounded Daily Activity scans
• @gjmveloso and @Enclavet — the Quick Desktop provider

Menubar v0.9.19

Install with:

npm install -g codeburn
codeburn menubar

That command drops the app into ~/Applications, records the persistent
codeburn CLI path used by the menubar, verifies the downloaded checksum,
clears quarantine after bundle verification, and launches it. If you download
the zip from this page directly and macOS shows "cannot verify developer",
right-click the app in Finder and pick Open to whitelist it once.

Desktop v0.9.19

One version across every surface: CLI, macOS menubar, and the desktop app all ship as 0.9.19.

Accuracy

• Every surface now shows the same numbers. CLI, TUI, menubar, desktop app, and web dashboard totals all come from one durable aggregation path and match exactly, including history whose session logs have since been deleted; the terminal overview notes how much was preserved from expired logs. (#755, #760, #759)
• Never lose history again. The daily cache carries forward every (day, provider) slice a re-parse can no longer derive, and adopts days from older cache generations instead of wiping them on schema changes. (#755)
• True Lifetime period on the CLI, dashboard, desktop app, and menubar. The desktop tab formerly labeled "All time" showed a 6-month window; it now says "Last 6 months", and Lifetime is the real all-time view. (#753, #759)
• Yield repo grouping is case-correct on macOS/Windows; skills usage is attributed regardless of turn category; daily-activity history scans are bounded. (#751, #745, #727)
• Days before recorded history render as "No data recorded", never as a currency zero, in the desktop heatmap, daily charts, and web dashboard. Genuinely idle days keep their true zeros. (#765)
• Incremental append parsing falls back to a full re-parse when a streamed assistant message restates across the append boundary, fixing a rare over-count on image-heavy sessions. (#772)
• Turn-level stats (edit turns, one-shot, category counts) attribute to exactly one provider slice, so per-provider sums always equal day totals. (#762, thanks @ozymandiashh)
• Workflow-intelligence accuracy pass from review: corrections count only follow-up prompts, file-churn paths are separator-normalized so the payload's basename privacy redaction works on Windows, pricing coverage excludes deliberately-free local models and reports null (never a fabricated 100%) when not computable, and time-to-first-edit is null rather than mismeasured on unparseable timestamps. (#763, review by @ozymandiashh)
• Daily-history retention extended from 2 to 10 years so carried days can never age out of the durable record; quota pace guards non-finite inputs; the exchange-rate cache honors CODEBURN_CACHE_DIR. (#764, #766)

Added (CLI)

• Quick Desktop provider — Amazon Quick Desktop usage from ~/.quickwork, with real metered costs and multi-profile discovery. (#735, thanks @gjmveloso, @Enclavet)
• Kimi Code provider — Kimi Code CLI (kimi-k3) wire sessions from ~/.kimi-code. (#750, #747)
• Workflow intelligence in optimize and the payload: user-correction rate, median time to first edit, most-reworked files, pricing coverage, and coaching notes. (#756)
• Richer session capture: git branch, lines added/removed (counted from diffs, never stored as text), interruptions, tool errors, session titles, and PR links now land in the local cache for upcoming per-branch and code-impact reports. (#758)
• Provider-agnostic quota window model with provenance; doctor warns when transcript retention is about to expire history. (#740, #757)

Performance

• Large-line session parsing is ~2x faster (single-pass field extraction), and files that grew by append are parsed incrementally from the cached offset instead of from byte 0. (#752, #749)
• Concurrent CLI, menubar, and MCP processes can no longer clobber each other's cache work: the warm session-cache refresh runs under a strict cross-process gate with heartbeat, staleness takeover, and a publication fence; a timed-out waiter serves the prior complete snapshot read-only instead of racing. (#743, thanks @avs-io)

Desktop app

• Windows fixed: the CLI is now found on every Windows install (path handling was POSIX-only, breaking 100% of Windows installs). (#733)
• In-app update notifications and an About-dialog update check; this is the first release existing 0.9.17 installs will be notified about. (#722, #738)
• Faster and calmer on data-heavy machines: CLI spawns are capped and prioritized so clicks never queue behind background work, provider prefetch is paced, and the default period is Today. (#748)
• Telemetry (opt-in, anonymous) reports per-provider spend buckets, richer error detail with a per-kind daily cap, and a reliable session-close beat. (#736, #742, #746)

Menubar

• Codex quota windows show linear pace: deficit/reserve, projection, and run-out ETA. (#728, #726)

0.9.15 - 2026-07-02

Added (CLI)

• codeburn context. See what fills a session's context window, by role

Contributors

Thanks to everyone who shipped in this release:

• @ozymandiashh — single-slice turn attribution, and the deep review passes across the accuracy work
• @avs-io — the cross-process cache refresh gate, the quota window model, and the menubar quota pace
• @0monish — the Lifetime period
• @ihearttokyo — bounded Daily Activity scans
• @gjmveloso and @Enclavet — the Quick Desktop provider

v0.9.16

What's New

The biggest release yet: roughly sixty merged changes since v0.9.15, every one re-verified against the release tree before shipping.

Added (CLI)

• codeburn doctor. Per-provider detection diagnostics: the exact paths probed (with any env override shown), sessions found, parse health, and a one-line verdict, so an empty or wrong number explains itself. Fully offline and read-only. (#685, from @avs-io's audit in #642)
• Spend budgets. codeburn budget sets daily, weekly, or monthly caps, the overview shows progress with a projection, and budget --check exits nonzero when over, ready for scripts and CI. (#562 by @ozymandiashh)
• codeburn models --by-agent. Which agent drove which model's spend, one row per (provider, model, agent), in table, markdown, CSV, and JSON. Per-record exports now carry subagentType and model so you can build any cross yourself. (#710, #712 by @ozymandiashh, requested by @alexandrekm in #708)
• act apply-model + quality tripwire. Apply a per-project model default recommended from your own compare data; act report watches the one-shot rate afterwards and tells you to undo if quality regressed. (#616 by @ozymandiashh)
• MCP tool-deferral coverage. optimize now detects setups paying tool-schema tax with deferral inactive, and --apply restores or tunes native deferral through the journaled act engine, measured at ~31 percent on tool-heavy sessions. (#631 by @AVSRPA1KR, design in #614)
• Estimated costs are marked. Every surface distinguishes measured money from estimated: a tilde on estimated rows with a legend, in report, overview, dashboards, MCP, menubar, and exports. Totals unchanged. (#688, from @avs-io's audit in #639)

Added (apps)

• CodeBurn Desktop. A full desktop app for macOS, Windows, and Linux with the CLI bundled inside: overview, spend, optimize, models, compare, plans, and settings. (#679, #680)
• Granular dashboard timelines. The web dashboard charts cost and tokens at 15-minute, hourly, or daily resolution with per-session and per-model lines. (#673 by @ozymandiashh)
• Scrollable daily history in the TUI: the Daily Activity panel now scrolls through your full history in place. (#672 by @ihearttokyo)
• Team sync (preview). codeburn sync pushes usage totals (never prompts or code) to a self-hosted endpoint with OIDC login. (#660 by @Enclavet)

Providers

• CodeWhale support, with exact stored cost preferred over estimates. (#674 by @ozymandiashh)
• Kiro v2: the IDE's new event-sourced session store, priced from metered credits. (#665, #618 by @Enclavet, #624 by @leonardo-claudio)
• Copilot: CLI sessions now bill real input and cache tokens from the session.shutdown rollup instead of undercounting to output only (#684, reported by @fgapito in #676); skill invocations populate Skills & Agents (#697, reported by @rfsmart-mmann in #654); JetBrains IDE tracking via the plugin's Nitrite store (#608 by @NihalJain)
• Claude: /advisor escalations are billed under the advisor model they actually ran on (#659); Windows Desktop sessions resolve via APPDATA (#615 by @ozymandiashh, reported by @seb937 in #611)
• Codex: archived sessions counted (#667 by @ozymandiashh with @gt-zhangshihao03, #663); CLI-wrapped MCP calls attributed (#656)
• OpenCode: custom data dirs and DB prefixes for forks (#620, reported by @chimon2000 and in #617), legacy file sessions merged with the SQLite store (#622)
• Antigravity: timestamps survive database rewrites, with real created_at decoded from the trajectory protos (#612 by @Battiatus)
• Cursor project names from file URIs (#599 by @Enclavet), locale-safe number grouping (#609 by @NihalJain), RON currency (#600)

Fixed

• Honest yield attribution: a commit is credited to at most one session, parallel sessions that lost a commit land in a new ambiguous bucket, and the report says the method is heuristic. (#692, from @avs-io's audit in #641)
• Zero-edit low-worth sessions no longer claim their full cost as recoverable savings. (#691, from @avs-io's audit in #640)
• A young project's founding session is no longer flagged as a cost outlier. (#666 by @ozymandiashh)
• Shell wrapper commands (sudo, npx, time) attribute to the real tool. (#658, reported by @morpheus9393 in #657)
• Menubar: Claude quota 429s honor Retry-After with real backoff (#702, reported in #701), unchanged data skips background refreshes and idle cadence eases to 120s on AC (#704, from #703), Codex plan retry routes to the right provider (#687 by @ozymandiashh, diagnosed by @avs-io in #678)
• Durable provider caches survive parse-version upgrades: pruned-source history is carried forward instead of erased. (#684)
• One shared token-estimation heuristic across all providers. (#677 by @avs-io, #644)

Thanks

@ozymandiashh, @avs-io, @Enclavet, @NihalJain, @AVSRPA1KR, @Battiatus, @ihearttokyo, @leonardo-claudio, @morpheus9393, @gt-zhangshihao03, @wanghao20, @ZacharyHu0, @41fred, and everyone who filed the issues that drove this release.

Menubar v0.9.16

Install with:

npm install -g codeburn
codeburn menubar

That command drops the app into ~/Applications, records the persistent
codeburn CLI path used by the menubar, verifies the downloaded checksum,
clears quarantine after bundle verification, and launches it. If you download
the zip from this page directly and macOS shows "cannot verify developer",
right-click the app in Finder and pick Open to whitelist it once.

CodeBurn Desktop 0.9.17

Desktop patch. The codeburn CLI ships inside.

• Windows: fixed the bundled-CLI 'not found' that broke every Windows install (path resolution).
• Unified solid-flame brand across the app, dock, and website.
• Richer error diagnostics in anonymous telemetry.

macOS first open (unsigned): System Settings > Privacy & Security > Open Anyway, or run xattr -cr /Applications/CodeBurn.app once; grant Full Disk Access for a prompt-free first scan. Windows: SmartScreen > More info > Run anyway. Linux: .deb installs to your app menu; the AppImage needs chmod +x and libfuse2.

CodeBurn Desktop 0.9.16

DEPRECATED. This build predates the durable-history engine and the accuracy fixes; its installers have been removed. Download the current release instead: https://github.com/getagentseal/codeburn/releases/tag/desktop-v0.9.19

---

CodeBurn Desktop for macOS, Windows, and Linux. Nothing else to install: the codeburn CLI ships inside.

macOS first open (unsigned): System Settings > Privacy & Security > Open Anyway, or run xattr -cr /Applications/CodeBurn.app once. Grant Full Disk Access for a prompt-free first scan. Windows: SmartScreen > More info > Run anyway. Linux: install the .deb (Debian/Ubuntu: sudo apt install ./codeburn-desktop_0.9.16_amd64.deb) or .rpm (Fedora: sudo dnf install ./codeburn-desktop-0.9.16.x86_64.rpm) and it lands in your app menu. Prefer the AppImage? chmod +x it first, and if it needs FUSE on Ubuntu 22.04+/Debian 12: sudo apt install libfuse2 (or run with --appimage-extract-and-run).

This build: bundled CLI, one-time indexing with per-provider progress, instant warm launches and provider switching, configurable refresh cadence, onboarding with optional anonymous telemetry, and exact chart-to-headline reconciliation.

Desktop v0.9.15

DEPRECATED. This build predates the durable-history engine and the accuracy fixes; its installers have been removed. Download the current release instead: https://github.com/getagentseal/codeburn/releases/tag/desktop-v0.9.19

---

CodeBurn Desktop for macOS, Windows, and Linux. Nothing else to install: the codeburn CLI ships inside.

macOS first open (unsigned): System Settings > Privacy & Security > Open Anyway, or run xattr -cr /Applications/CodeBurn.app once. Grant Full Disk Access for a prompt-free first scan. Windows: SmartScreen > More info > Run anyway. Linux: chmod +x the AppImage.

This build: bundled CLI, one-time indexing with per-provider progress, instant warm launches and provider switching, configurable refresh cadence, onboarding with optional anonymous telemetry, and exact chart-to-headline reconciliation.

v0.9.15

What's New

Highlights since v0.9.14:

Added (CLI)

• codeburn context. See what fills a session's context window, by role, block type, and tool: an interactive terminal browser over your Claude Code and Codex sessions, separating the live window from compacted history and anchoring estimates to the exact API-reported context size. Also a Context page in the browser dashboard, and scriptable via codeburn context <id> --json. (#592)
• Zed provider. Zed's built-in agent is now tracked: per-request token usage with full cache fields, topped up to each thread's exact cumulative counter and validated token-for-token against a real store. (#594, format documented by @chatzinikolakisk in #480)
• codeburn audit. Per provider-and-model table of where every number comes from: calls, input, output, reasoning, cache read/write, cost. (#578)
• User price overrides for any model via codeburn price-override. (#560, thanks @ozymandiashh)
• open-design provider for per-model usage tracking. (#559, thanks @ozymandiashh)
• Browser dashboard is now fully mobile responsive (#582, thanks @ele-yufo; #589) and paints instantly with the local payload inlined, defaulting to today with fast-fail for offline paired devices. (#573)

Fixed (CLI)

• Cursor tokens are now Cursor's own numbers. Input comes from the per-conversation context meter instead of text-length guesses, credited once per conversation on a stable anchor so daily history stays consistent across re-scans; tools and shell commands come from the agent stream; Composer house models price at Cursor's published rates; figures are flagged estimated where they are. Fixes the class of report in #574 and closes #326. (#575)
• Copilot Chat users no longer see $0.00: VS Code core chatSessions journals are read for token counts. (#563, thanks @ozymandiashh)
• Codex sessions up to 4GB are parsed (streaming cap raised). (#569)
• Devin: ATIF v1.7 support (#570, thanks @tvcsantos) and friendly GPT model names with effort tiers. (#585)
• OpenCode skills and subagents breakdowns populated. (#557, thanks @KevNev19)
• Pi native skill loads classify as Skill, not Read. (#590)
• Cache read/write scoped to the selected period in web and devices CLI. (#586, thanks @ozymandiashh)
• Invalid dashboard periods return an error instead of exiting the web server. (#554, thanks @ozymandiashh)
• LiteLLM pricing snapshot refreshed; MiniMax-M3 follows MiniMax's new tiered pricing (standard tier $0.30/$1.20 per M). Daily cache bumped to v10 so history re-hydrates under the new Cursor accounting and pricing.

macOS menubar

• Local/Combined usage toggle backed by combined multi-device data in menubar-json. (#567, #568, thanks @ozymandiashh)
• The update dialog now detects a codeburn CLI too old to install menubar updates and shows the exact CLI upgrade command first. (#593)

Thanks to @ozymandiashh, @tvcsantos, @KevNev19, @ele-yufo, and @chatzinikolakisk for contributions this release.

The macOS menubar app is published separately as mac-v0.9.15.

What's Changed

• docs(changelog): credit @vaibhavarora14 for #486 by @iamtoruk in #552
• Raise streaming session cap to 4GB so large Codex sessions are counted by @iamtoruk in #569
• docs(readme): lead with a one-line definition for SEO/AI-answer consistency by @iamtoruk in #571
• fix(devin): add missing support for ATIF v1.7 by @tvcsantos in #570
• feat(pricing): add user price overrides for models by @ozymandiashh in #560
• feat(providers): add open-design provider by @ozymandiashh in #559
• fix(web): reject invalid dashboard periods without exiting by @ozymandiashh in #554
• Populate OpenCode skills and subagents breakdowns by @KevNev19 in #557
• fix(copilot): read VS Code chatSessions so Copilot Chat users see cost (#555) by @ozymandiashh in #563
• feat(menubar): expose combined multi-device usage in menubar-json (#566) by @ozymandiashh in #567
• feat(menubar): Local/Combined usage toggle — Swift, stacked on #567 (#566) by @ozymandiashh in #568
• perf(web): instant dashboard load, default to today, fast-fail offline peers by @iamtoruk in #573
• Clarify CodeBurn's open-source project status by @iamtoruk in #580
• feat: add codeburn audit token-source view by @iamtoruk in #578
• feat(web): mobile responsive web dashboard by @ele-yufo in #582
• Complete mobile responsiveness (header overflow + a11y) by @iamtoruk in #589
• fix: scope cache read/write to the selected period (web + devices CLI) (#583) by @ozymandiashh in #586
• fix(pi): classify native skill loads as Skill, not Read (#588) by @ozymandiashh in #590
• fix(devin): report friendly GPT model names with effort tier by @ozymandiashh in #585
• fix(cursor): use Cursor's real context tokens for input (#574) by @iamtoruk in #575
• feat(context): per-session context token tree across CLI, TUI, and dashboard by @iamtoruk in #592
• fix(menubar): refuse menubar updates from CLIs older than 0.9.9 by @iamtoruk in #593
• feat(providers): add Zed agent provider by @iamtoruk in #594
• release: 0.9.15 by @iamtoruk in #595

New Contributors

• @KevNev19 made their first contribution in #557
• @ele-yufo made their first contribution in #582

Full Changelog: v0.9.14...v0.9.15

Menubar v0.9.15

Install with:

npm install -g codeburn
codeburn menubar

That command drops the app into ~/Applications, records the persistent
codeburn CLI path used by the menubar, verifies the downloaded checksum,
clears quarantine after bundle verification, and launches it. If you download
the zip from this page directly and macOS shows "cannot verify developer",
right-click the app in Finder and pick Open to whitelist it once.

Changes in 0.9.15:

• The update dialog detects a codeburn CLI too old to install menubar updates (pre-0.9.9) and shows the exact CLI upgrade command first. (#593)
• Local/Combined usage toggle backed by combined multi-device data. (#567, #568, thanks @ozymandiashh)

CLI release: v0.9.15

sha256: bf9dbaff413057142d5a872d76a9e52c09c15fe565300ec3296683c3b88e93da