diff --git a/README.md b/README.md index 639cabf..d1f599a 100644 --- a/README.md +++ b/README.md @@ -18,6 +18,36 @@ Sponsor

+ + + + + + + + + +
+ Desktop
+ CodeBurn Desktop
+ Download for macOS (Apple Silicon) + Download for macOS (Intel) + Download for Linux + Download for Windows + 		+ Web
+ CodeBurn Web dashboard
+ npx codeburn web +
+ Terminal
+ CodeBurn TUI dashboard
+ npx codeburn + 		+ macOS Menubar
+ CodeBurn macOS menubar
+ codeburn menubar +
+ **CodeBurn is a free, open-source, local-first tool that tracks AI coding token usage and cost across 36 tools and agents (Claude Code, Cursor, Codex, Gemini, Grok and more), broken down by model, project, and task.** You pay for Claude, Codex, Cursor, and a stack of other AI tools. The bill tells you the total. It never tells you that half of it went to conversation instead of code, or that an expensive model burned your budget on work a cheaper one would have one-shot. @@ -26,11 +56,6 @@ CodeBurn does. It reads the session files your tools already write to disk and b Everything runs locally. No wrapper, no proxy, no API keys, nothing leaves your machine. Pricing comes from [LiteLLM](https://github.com/BerriAI/litellm), refreshed daily. -

- CodeBurn TUI dashboard -

-

A week across every tool you use, in one screen.

-

Quick start · Find waste · @@ -128,10 +153,6 @@ codeburn optimize --format json # setup health + findings as JSON - Possibly low-worth expensive sessions with no edit turns or repeated retries when no `git`/`gh` delivery command is observed -

- CodeBurn optimize -

- Each finding shows the estimated token and dollar savings plus a ready-to-paste fix: a `CLAUDE.md` line, an environment variable, or a `mv` command to archive unused items. Findings are ranked by urgency (impact weighted against observed waste) and rolled up into an A to F setup health grade. Repeat runs classify each finding as new, improving, or resolved against a 48-hour recent window. You can also open it inline from the dashboard: press `o` when a finding count appears in the status bar, `b` to return. @@ -180,10 +201,6 @@ codeburn compare --provider claude # Claude Code sessions only Which model is actually better for *your* work? Press `c` in the dashboard, or run `codeburn compare`. Arrow keys switch periods, `b` to return. -

- CodeBurn compare -

- | Section | Metric | What it measures | |---------|--------|-----------------| | Performance | One-shot rate | Edits that succeed without retries | @@ -256,10 +273,6 @@ codeburn menubar One command: downloads the latest `.app`, installs into `~/Applications`, and launches it. Re-run with `--force` to reinstall. Native Swift and SwiftUI app lives in `mac/` (see `mac/README.md` for build details). -

- CodeBurn macOS menubar -

- The menubar icon shows the spend period selected in Settings (Today by default; Week, Month, and 6 Months are also available). Non-today periods add a short suffix such as `$42 / mo` so the menu bar value stays clear. Click to open a popover with agent tabs, period switcher (Today, 7 Days, 30 Days, Month, All), Trend, Forecast, Pulse, Stats, and Plan insights, activity and model breakdowns, optimize findings, and CSV/JSON export. Refreshes every 30 seconds. You can also set the menubar status period from Terminal: diff --git a/assets/desktop.jpg b/assets/desktop.jpg new file mode 100644 index 0000000..a3c6257 Binary files /dev/null and b/assets/desktop.jpg differ diff --git a/assets/menubar-app.jpg b/assets/menubar-app.jpg new file mode 100644 index 0000000..c400ce6 Binary files /dev/null and b/assets/menubar-app.jpg differ diff --git a/assets/web.jpg b/assets/web.jpg new file mode 100644 index 0000000..b409c13 Binary files /dev/null and b/assets/web.jpg differ