From b597449bede6fe20abc1cd7cbcfda028b7176887 Mon Sep 17 00:00:00 2001
From: Resham Joshi <65915470+iamtoruk@users.noreply.github.com>
Date: Thu, 16 Jul 2026 17:07:02 -0700
Subject: [PATCH] docs(readme): four-surface hero grid with install shortcuts
(#715)
* docs(readme): four-surface hero grid with per-surface install shortcuts
Replace the single TUI screenshot and the scattered optimize, compare and
old menubar shots with one 2x2 grid under the badges: Desktop, Web,
Terminal, and macOS Menubar, each with its one-line way in (direct
download badges for the desktop builds, npx codeburn web, npx codeburn,
codeburn menubar). New screenshots downscaled to 1600px so the README
stays light.
* docs(readme): star and sponsor ask up top, consistency pass
Adds a one-line ask under the badges: star the repo if CodeBurn showed
you something the bill never did, sponsor to keep 36 integrations
honest. Caption line under the hero grid.
Consistency fixes from a full read: the sponsor section said 30
integrations while everything else says 36; dx is the Dioxus CLI, not a
package runner, so the install line now says pnpm dlx; the by-agent
command row was overstuffed for a table cell; Opus 4.6 in the signals
table aged into Opus 4.8; the License section ran MIT and the affiliation
note into one paragraph; two stray em dashes and a double blank line.
---
README.md | 69 +++++++++++++++++++++++++----------------
assets/desktop.jpg | Bin 0 -> 249226 bytes
assets/menubar-app.jpg | Bin 0 -> 317855 bytes
assets/web.jpg | Bin 0 -> 221519 bytes
4 files changed, 43 insertions(+), 26 deletions(-)
create mode 100644 assets/desktop.jpg
create mode 100644 assets/menubar-app.jpg
create mode 100644 assets/web.jpg
diff --git a/README.md b/README.md
index 639cabf..c5c98bb 100644
--- a/README.md
+++ b/README.md
@@ -18,6 +18,40 @@
If CodeBurn shows you something your bill never did, star the repo so other developers find it, and consider sponsoring to keep 36 integrations honest.
+ +|
+ Desktop + ![]() + |
+
+ Web + ![]() + npx codeburn web
+ |
+
|
+ Terminal + ![]() + npx codeburn
+ |
+
+ macOS Menubar + ![]() + codeburn menubar
+ |
+
Four surfaces, one source of truth: everything reads the session files already on your disk.
+ **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 +60,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. -
-
-
A week across every tool you use, in one screen.
-Quick start · Find waste · @@ -61,7 +90,7 @@ That opens the interactive dashboard (last 7 days by default). Arrow keys switch npm install -g codeburn ``` -Also runs via `bunx codeburn` or `dx codeburn`, or `brew install codeburn` on macOS. +Also runs via `bunx codeburn` or `pnpm dlx codeburn`, or `brew install codeburn` on macOS. **Menu bar app** for macOS, with your spend always in the menu bar: @@ -128,10 +157,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 -
-
-
-
-
-
-
e9C=%#o_ w=KSl#A*5gFgEKfB1PLI9tLhq#@`+YadDiE%@m`*EeR@1zHhHSq0zq@J>P
z)yw;4#7YP3)&Esm4_7XPP$_@VsGZ?{wx0#IER1-p%>sMW?{i`{&O?RAWR@pNzVzYa
z0N1lM8Mv(P$WI>~C+poA?-*^5rVT1)h;})WnJIk7mh{fc+rlvUfM14K;)%Nz!7nhX
zac!~@QCmR`b$;?={bM=%xpMQ*P7UBrq)_m7L7yL3HzZnPFhQ#>wKyjBxd8f%SpdhT
z!4WCrY9Ol)H*qnsrtK?Q?mUo~J}_JUwv*|?udmpbgN~Ep-OQdNh{7L}6&Lz@=qkU;
zOL_R)peW-TENu8?d*<#rVfhaUp>%H=qdww5fKnJhffp<9TbQ}q_nI`8;FBGk4^>qc
zRac9hdmX&wTr^_upl11sc#wwj54sA?+4576Sg%Lw}J3!^{mV&6mOhY^?h3R
zfCckpRreFaqM|24vvO0)nkH%V-q0e5mbcWiik+gAbbWnGu2 KAR=Me~wziY=Q^|>Jt-+hH$A#
z;_YEx-3WAKYr&h9BkN98E4zE=wKn_`fe9gn_%yP=E$fQF80!lA*iPTbqI1<3f&>kp
zkOfnsN9JcZfLu;>U6vvEOPIjV36-bmzTo&r(13M9rHvd&fa;=`>CZm5A1$Pt>@K$d
z5c7r8Dagr=A2VF^MBmrd4s~UsB-BMUwJh`?Ksy}GLAn&7%tub*1i=9g!Tl5CN;f1`
zEuZBLR9`|}CX>nwvMY+iq0feIeS|J9Dn-Bu&yog&aEnrAL6t*h-w=DeqEvH;Ia88=90XvCW-qtp$5#@t0HPd0EFxt@(dqx2gYbf;#!~OS@EGaRe
z!bHdMBG`NN{zBgN!)D-9&xB)V$Ii5sRWVYcSIFltwim-Sw%Yje{>kqpw|q$3AsT0z
zyFf;b>iB@M%K7-CX7LvJ7wUuEHjX^=?d`}adyQeDe;Ob_44PvV^>Z@Xzv2OXEqm-=
z+qs|#ul2t3YONyUo7_H_4;Ow;i8*p^y(Oy~YWUV$FGMQ_?@6?LH0FNo7*JP?h-V1pVT5ZahSE(J*
zPG%T%%Ro*jAGgH$yB#lty1G{Q=2Fz`4vs6O}@01vMKcwpziUZGr`SW_p#y-9;R
z5998CqjKI*{7IdF33r!9A>G;bIscK_Th)(F#0u#w=vXnu3EjMLL>7KMIKCd5=a#cf
zGu>2#3^+2MtYi^A-?yH%iDz9p%9l=;ZM+8;pRy0^W*p@Zv@e$AUAYtE{`u*NLtE1g
zZ
u9Jt~E1Be)
zON7}4^lfD6zE6EdU(IyqVbmrN2Ati|0R{h*agYoKX)xEC;I
zE_~CFa+oJt^c%?*&++lv&2~4D1c{^}d+aeoZ1+}L=y;nu;I{nCS*XHzr
zH=&1qhTi;}P|6xZ3V732KT=re+yqFKTOCOFYtR@44rb`e0)mU?Ft>IZocmITUrBZi
zSYa3jnmQGHOx}N)=DWmKaxX>*bj};7>}khxIKhy4THLY6D$`Q~)G17rz=+tCh8n!~
zrnleJeR;ydxwvqy;yABy`g)7XlK?AtA$5%uxShrIfsV<
a#_D707stf6{U`V}0^lGGC<=
zHKg|_WR(VgEgzMnB%(sB11%k4(A`@^7UIT#Je=X{+C