{"repo":"getagentseal/codeburn","free":true,"listed":false,"github":"https://github.com/getagentseal/codeburn","clone":"git clone https://github.com/getagentseal/codeburn.git","description":"Free, local tool to track AI coding token usage and cost across 37 tools and agents (Claude Code, Cursor, Codex, Gemini and more), by model, project, and task. npx codeburn","language":"TypeScript","stars":9425,"topics":["ai-coding","claude-code","cli","codex","cost-tracking","cursor-ide","developer-tools","menubar","observability","terminal-ui","token-usage","web-dashboard"],"license":"MIT","category":"dev_tool","readme_excerpt":"\n \n \n \n \n
\n \"Codex\n \n \"CodeBurn\n
\n\n

\n \"CodeBurn\"\n

\n\n

See where your AI spend goes.

\n\n

\n \"npm\n \"total\n \"license\"\n \"node\n \"Discord\"\n \"Follow\n \"Sponsor\"\n

\n\n

If CodeBurn shows you something your bill never did, star the repo so other developers find it, and consider sponsoring to keep 40 integrations honest.

\n\n\n \n \n \n \n \n \n \n \n
\n Desktop
\n \"CodeBurn
\n \"Download\n \"Download\n \"Get\n \"Download\n \"Download\n \"Download\n 		\n Web
\n \"CodeBurn
\n npx codeburn web\n
\n Terminal
\n \"CodeBurn
\n npx codeburn\n 		\n macOS Menubar
\n \"CodeBurn
\n codeburn menubar\n
\n\n

Four surfaces, one source of truth: everything reads the session files already on your disk.

\n\n**CodeBurn is a free, open-source, local-first tool that tracks AI coding token usage and cost across 40 tools and agents (Claude Code, Cursor, Codex, Gemini, Grok and more), broken down by model, project, and task.**\n\nYou 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.\n\nCodeBurn does. It reads the session files your tools already write to disk and breaks down every token and dollar by **task, model, tool, and project**, across **40 AI tools**.\n\nEverything runs locally. No wrapper, no proxy, no API keys, nothing leaves your machine. Pricing comes from [LiteLLM](https://github.com/BerriAI/litellm), refreshed daily.\n\n

\n Quick start ·\n Find waste ·\n Apply fixes ·\n Guard ·\n Compare models ·\n Track what shipped ·\n MCP ·\n Supported tools ·\n Commands ·\n Features ·\n How it reads data\n

\n\n## Quick start\n\n**Run it instantly**, no install needed:\n\n```bash\nnpx codeburn\n```\n\nThat opens the interactive dashboard (last 7 days by default). Arrow keys switch periods, `q` quits. That is the 30-second version. You now know where your AI budget goes.\n\n**Install it** for a permanent `codeburn` command:\n\n```bash\nnpm install -g codeburn\n```\n\nAlso runs via `bunx codeburn` or `pnpm dlx codeburn`, or `brew install codeburn` on macOS.\n\n**Menu bar app** for macOS, with your spend always in the menu bar:\n\n```bash\ncodeburn menubar\n```\n\nOn Linux, a GNOME Shell extension gives the same panel view; see [Linux (GNOME)](#linux-gnome).\n\nRequires **Node.js 22.13+** and at least one supported tool with session data on disk. For Cursor and OpenCode, `better-sqlite3` installs automatically.\n\n## Your month at a glance\n\n```bash\ncodeburn overview # this month, clean tables\ncodeburn overview --no-color # plain text, ready to paste\ncodeburn overview --from 2026-06-01 --to 2026-06-15 # any date range\ncodeburn overview -p all # last 6 months\ncodeburn overview -p lifetime # full history (uncapped)\ncodeburn overview --provider claude # one tool only\n```\n\n`codeburn overview` prints a copy-pasteable summary of where your AI spend went: totals (cost, tokens, cache hit), a breakdown by tool and by top model, your highest-value days, top projects, a per-day table, and activity and tool usage. Pipe it anywhere (into `pbcopy`, a PR, Slack, or a tweet); color drops automatically when the output is not a terminal, or pass `--no-color`.\n\n```text\nCodeBurn June 2026\n\nTotals\n Cost $2,795.10\n Tokens 3.49B in 23.9M / out 20.2M / cache-w 72.5M / cache-r 3.38B\n Calls 14,755 sessions 753\n Cache hit 99.3%\n\nBy tool\n┌──────────┬───────────┬────────┬───────┐\n│ Tool │ Cost │ Tokens │ Share │\n├──────────┼───────────┼────────┼───────┤\n│ claude │ $2,662.37 │ 3.34B │ 95% │\n│ codex │ $119.12 │ 128.1M │ 4% │\n└──────────┴───────────┴────────┴───────┘\n\n(plus Top models, Highest-value days, Top projects, a per-day table, By activity, and Tools)\n```\n\n## Find and fix waste\n\n```bash\ncodeburn optimize # scan the last 30 days\ncodeburn optimize -p today # today only\ncodeburn optimize -p week # last 7 days\ncodeburn optimize --provider claude # restrict to one provider\ncodeburn optimize --format json # setup health + findings as JSON\n```\n\n`codeburn optimize` scans your sessions and your `~/.claude/` setup for waste patterns:\n\n- Files Claude re-reads across sessions (same content, same context, over and over)\n- Low Read:Edit ratio (editing without reading leads to retries and wasted tokens)\n- Wasted bash output (uncapped `BASH_MAX_OUTPUT_LENGTH`, trailing noise)\n- Unused MCP servers still paying their tool-schema overhead every session\n- Ghost agents, skills, and slash commands defined in `~/.claude/` but never invoked\n- Bloated `CLAUDE.md` files (with `@-import` expansion counted)\n- Cache creation overhead and junk directory reads\n- Context-heavy sessions where effective input/cache tokens swamp output\n- Possibly low-worth expensive sessions with no edit turns or repeated retries\n when no `git`/`gh` delivery command is observed\n\nEach 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 a","default_branch":"main","files":766,"tree":[".github/FUNDING.yml",".github/PULL_REQUEST_TEMPLATE.md",".github/workflows/block-claude-coauthor.yml",".github/workflows/build-snap.yml",".github/workflows/build-windows-store.yml",".github/workflows/ci.yml",".github/workflows/firstlook.yml",".github/workflows/release-menubar.yml",".github/workflows/star-history.yml",".github/workflows/tests.yml",".gitignore",".gitleaks.toml",".nvmrc",".semgrep/rules/no-bracket-assign-hot-paths.yml","CHANGELOG.md","CONTRIBUTING.md","LICENSE","README.md","RELEASING.md","SECURITY.md","SUBMISSION.md","app/.gitignore","app/DISTRIBUTION.md","app/README.md","app/build/appx/Square150x150Logo.png","app/build/appx/Square44x44Logo.png","app/build/appx/StoreLogo.png","app/build/appx/Wide310x150Logo.png","app/build/icon.png","app/electron/cli.test.ts","app/electron/cli.ts","app/electron/main.test.ts","app/electron/main.ts","app/electron/preload.ts","app/electron/quota/claude.test.ts","app/electron/quota/claude.ts","app/electron/quota/codex.test.ts","app/electron/quota/codex.ts","app/electron/quota/index.test.ts","app/electron/quota/index.ts","app/electron/quota/security.test.ts","app/electron/quota/security.ts","app/electron/quota/types.ts","app/electron/telemetry.test.ts","app/electron/telemetry.ts","app/electron/updates.test.ts","app/electron/updates.ts","app/flathub/README.md","app/flathub/flathub.json","app/flathub/org.agentseal.CodeBurn.desktop","app/flathub/org.agentseal.CodeBurn.metainfo.xml","app/flathub/org.agentseal.CodeBurn.yaml","app/package-lock.json","app/package.json","app/renderer/App.test.tsx","app/renderer/App.tsx","app/renderer/assets/flame.png","app/renderer/assets/providers/antigravity.png","app/renderer/assets/providers/claude.svg","app/renderer/assets/providers/cline.svg","app/renderer/assets/providers/codewhale.svg","app/renderer/assets/providers/copilot-dark.svg","app/renderer/assets/providers/copilot-light.svg","app/renderer/assets/providers/crush.png","app/renderer/assets/providers/cursor-agent.jpg","app/renderer/assets/providers/cursor-dark.svg","app/renderer/assets/providers/cursor-light.svg","app/renderer/assets/providers/devin.png","app/renderer/assets/providers/droid.png","app/renderer/assets/providers/forge.png","app/renderer/assets/providers/gemini.svg","app/renderer/assets/providers/goose.png","app/renderer/assets/providers/grok-dark.svg","app/renderer/assets/providers/grok-light.svg","app/renderer/assets/providers/hermes.png","app/renderer/assets/providers/ibm-bob.svg","app/renderer/assets/providers/kilo-code.png","app/renderer/assets/providers/kimi.svg","app/renderer/assets/providers/kiro.png","app/renderer/assets/providers/mistral-vibe.svg","app/renderer/assets/providers/mux.png","app/renderer/assets/providers/openai-dark.svg","app/renderer/assets/providers/openai-light.svg","app/renderer/assets/providers/openclaw.jpg","app/renderer/assets/providers/opencode-dark.svg","app/renderer/assets/providers/opencode-light.svg","app/renderer/assets/providers/pi.png","app/renderer/assets/providers/qwen-dark.svg","app/renderer/assets/providers/qwen-light.svg","app/renderer/assets/providers/roo-code.png","app/renderer/assets/providers/vercel-gateway.png","app/renderer/assets/providers/warp.jpg","app/renderer/assets/providers/zcode.jpg","app/renderer/assets/providers/zed.jpg","app/renderer/assets/providers/zerostack.png","app/renderer/assets/splash-loader.webm","app/renderer/components/AboutModal.test.tsx","app/renderer/components/AboutModal.tsx","app/renderer/components/ActivityHeatmap.test.tsx","app/renderer/components/ActivityHeatmap.tsx","app/renderer/components/CliErrorPanel.tsx","app/renderer/components/ConnectAffordance.tsx","app/renderer/components/Dropdown.tsx","app/renderer/components/EmptyState.tsx","app/renderer/components/ErrorBoundary.test.tsx","app/renderer/components/ErrorBoundary.tsx","app/renderer/components/FlameMark.tsx","app/renderer/components/Hint.tsx","app/renderer/components/ListRow.tsx","app/renderer/components/Onboarding.test.tsx","app/renderer/components/Onboarding.tsx","app/renderer/components/Panel.tsx","app/renderer/components/ProviderLogo.test.tsx","app/renderer/components/ProviderLogo.tsx","app/renderer/components/ProviderPop.tsx","app/renderer/components/Punchcard.tsx","app/renderer/components/RangeCalendar.tsx","app/renderer/components/Sankey.tsx","app/renderer/components/SegTabs.tsx","app/renderer/components/Sidebar.test.tsx","app/renderer/components/Sidebar.tsx","app/renderer/components/Skeleton.test.tsx","app/renderer/components/Skeleton.tsx","app/renderer/components/Splash.test.tsx","app/renderer/components/Splash.tsx","app/renderer/components/StackedBars.test.tsx","app/renderer/components/StackedBars.tsx","app/renderer/components/StaleBanner.test.tsx","app/renderer/components/StaleBanner.tsx","app/renderer/components/Stat.tsx","app/renderer/components/ToastHost.test.tsx","app/renderer/components/ToastHost.tsx","app/renderer/components/TopBar.tsx","app/renderer/components/UpdateBanner.test.tsx","app/renderer/components/UpdateBanner.tsx","app/renderer/components/Window.tsx","app/renderer/hooks/usePolled.test.ts","app/renderer/hooks/usePolled.ts","app/renderer/hooks/useUpdateStatus.test.ts","app/renderer/hooks/useUpdateStatus.ts","app/renderer/index.html","app/renderer/lib/budget.ts","app/renderer/lib/build.ts","app/renderer/lib/format.test.ts","app/renderer/lib/format.ts","app/renderer/lib/ipc.ts","app/renderer/lib/modelSeries.ts","app/renderer/lib/motion.test.tsx","app/renderer/lib/motion.ts","app/renderer/lib/pageVisibility.test.ts","app/renderer/lib/pageVisibility.ts","app/renderer/lib/period.test.ts","app/renderer/lib/period.ts","app/renderer/lib/platform.ts","app/renderer/lib/refreshCadence.test.ts","app/renderer/lib/refreshCadence.tsx","app/renderer/lib/testMatchMedia.ts","app/renderer/lib/toast.ts","app/renderer/lib/types.ts","app/renderer/main.tsx","app/renderer/sections/Compare.test.tsx","app/renderer/sections/Compare.tsx","app/renderer/sections/Models.test.tsx","app/renderer/sections/Models.tsx","app/renderer/sections/Optimize.test.tsx","app/renderer/sections/Optimize.tsx","app/renderer/sections/Overview.test.tsx","app/renderer/sections/Overview.tsx","app/renderer/sections/Plans.test.tsx","app/renderer/sections/Plans.tsx","app/renderer/sections/PullRequests.test.tsx","app/renderer/sections/PullRequests.tsx","app/renderer/sections/Sessions.test.tsx","app/renderer/sections/Sessions.tsx","app/renderer/sections/Settings.test.tsx","app/renderer/sections/Settings.tsx","app/renderer/sections/Spend.test.tsx","app/renderer/sections/Spend.tsx","app/renderer/styles/indigo.css","app/renderer/styles/plain.css","app/renderer/test/setup.ts","app/renderer/vite-env.d.ts","app/scripts/after-pack.cjs","app/scripts/buildStamp.test.ts","app/scripts/buildStamp.ts","app/scripts/stage-cli.mjs","app/tsconfig.electron.json","app/tsconfig.json","app/vite.config.ts","app/vitest.config.ts","assets/codeburn-desktop-demo.gif","assets/compare.jpg","assets/dashboard.jpg","assets/desktop.jpg","assets/logo.ico","assets/logo.png","assets/menubar-0.7.2.png","assets/menubar-0.8.0.png","assets/menubar-0.9.11.png","assets/menubar-app.jpg","assets/menubar-logo.png","assets/open-source-recipient.png","assets/optimize.jpg","assets/providers.png","assets/providers/antigravity.png","assets/providers/claude.jpg","assets/providers/cline.svg","assets/providers/codewhale.svg","assets/providers/codex.png","assets/providers/copilot.jpg","assets/providers/crush.png","assets/providers/cursor-agent.jpg","assets/providers/cursor.jpg","assets/providers/devin.png","assets/providers/droid.png","assets/providers/forge.png","assets/providers/gemini.png","assets/providers/goose.png","assets/providers/grok.png","assets/providers/hermes.png","assets/providers/ibm-bob.svg","assets/providers/kilo-code.png","assets/providers/kimi.svg","assets/providers/kiro.png","assets/providers/mistral-vibe.svg","assets/providers/mux.png","assets/providers/omp.svg","assets/providers/openclaw.jpg","assets/providers/opencode.png","assets/providers/pi.png","assets/providers/qwen.png","assets/providers/roo-code.png","assets/providers/vercel-gateway.png","assets/providers/warp.jpg","assets/providers/zcode.jpg","assets/providers/zed.jpg","assets/providers/zerostack.png","assets/star-history/.star-history.sig","assets/star-history/star-history-dark.svg","assets/star-history/star-history-light.svg","assets/star-history/star-history.png","assets/web.jpg","codeburn-desktop-wireframes.html","dash/index.html","dash/package-lock.json","dash/package.json","dash/public/codeburn-logo.png","dash/src/App.tsx","dash/src/components/BarList.tsx","dash/src/components/ContextExplorer.tsx","dash/src/components/DataTable.tsx","dash/src/components/DeviceSearchModal.tsx","dash/src/components/MetricCard.tsx","dash/src/components/Punchcard.tsx","dash/src/components/UsageChart.tsx","dash/src/components/WorkflowPanel.tsx","dash/src/components/ui/card.tsx","dash/src/components/ui/skeleton.tsx","dash/src/index.css","dash/src/lib/api.ts","dash/src/lib/utils.ts","dash/src/main.tsx","dash/tsconfig.json","dash/vite.config.ts","docs/architecture.md","docs/design/codeburn-desktop-plan.md","docs/design/codeburn-desktop.md","docs/design/codeburn-mcp-plan.md","docs/design/codeburn-mcp.md","docs/providers/NEW_PROVIDER.md","docs/providers/README.md","docs/providers/antigravity.md","docs/providers/claude.md","docs/providers/cline-cli.md","docs/providers/cline.md","docs/providers/codewhale.md","docs/providers/codex.md","docs/providers/copilot.md","docs/providers/crush.md","docs/providers/cursor-agent.md","docs/providers/cursor.md","docs/providers/devin.md","docs/providers/droid.md","docs/providers/forge.md","docs/providers/gemini.md","docs/providers/goose.md","docs/providers/grok.md","docs/providers/hermes.md","docs/providers/ibm-bob.md","docs/providers/kilo-code.md","docs/providers/kimi.md","docs/providers/kimicode.md","docs/providers/kiro.md","docs/providers/lingtai-tui.md","docs/providers/mistral-vibe.md","docs/providers/mux.md","docs/providers/omp.md","docs/providers/openclaude.md","docs/providers/openclaw.md","docs/providers/opencode.md","docs/providers/pi.md","docs/providers/quickdesk.md","docs/providers/qwen.md","docs/providers/roo-code.md","docs/providers/vercel-gateway.md","docs/providers/vscode-cline-parser.md","docs/providers/warp.md","docs/providers/zcode.md","docs/providers/zed.md","docs/providers/zerostack.md","docs/sync/DEVELOPER.md","docs/sync/README.md","gnome/README.md","gnome/dataClient.js","gnome/extension.js","gnome/icons/codeburn-symbolic.svg","gnome/indicator.js","gnome/install.sh","gnome/metadata.json","gnome/prefs.js","gnome/schemas/org.gnome.shell.extensions.codeburn.gschema.xml","gnome/stylesheet.css","mac/.gitignore","mac/Package.swift","mac/README.md","mac/Scripts/build-local.sh","mac/Scripts/package-app.sh","mac/Sources/CodeBurnMenubar/AppStore.swift","mac/Sources/CodeBurnMenubar/AppVersion.swift","mac/Sources/CodeBurnMenubar/CodeBurnApp.swift","mac/Sources/CodeBurnMenubar/CurrencyState.swift","mac/Sources/CodeBurnMenubar/Data/CLIClaudeConfig.swift","mac/Sources/CodeBurnMenubar/Data/CapacityEstimator.swift","mac/Sources/CodeBurnMenubar/Data/ClaudeCredentialStore.swift","mac/Sources/CodeBurnMenubar/Data/ClaudeSubscriptionService.swift","mac/Sources/CodeBurnMenubar/Data/CodexCredentialStore.swift","mac/Sources/CodeBurnMenubar/Data/CodexSubscriptionService.swift","mac/Sources/CodeBurnMenubar/Data/CodexUsage.swift","mac/Sources/CodeBurnMenubar/Data/DataClient.swift","mac/Sources/CodeBurnMenubar/Data/KimiQuotaPresentation.swift","mac/Sources/CodeBurnMenubar/Data/KimiSubscriptionService.swift","mac/Sources/CodeBurnMenubar/Data/MenubarPayload.swift","mac/Sources/CodeBurnMenubar/Data/MenubarStatusCache.swift","mac/Sources/CodeBurnMenubar/Data/QuotaPace.swift","mac/Sources/CodeBurnMenubar/Data/QuotaSummary.swift","mac/Sources/CodeBurnMenubar/Data/ServeConnection.swift","mac/Sources/CodeBurnMenubar/Data/SubscriptionRefreshCadence.swift","mac/Sources/CodeBurnMenubar/Data/SubscriptionSnapshotStore.swift","mac/Sources/CodeBurnMenubar/Data/SubscriptionUsage.swift","mac/Sources/CodeBurnMenubar/Data/UpdateChecker.swift","mac/Sources/CodeBurnMenubar/Data/UsageDataChangeGuard.swift","mac/Sources/CodeBurnMenubar/Data/UsageRefreshCadence.swift","mac/Sources/CodeBurnMenubar/MenubarScope.swift","mac/Sources/CodeBurnMenubar/RefreshCadence.swift","mac/Sources/CodeBurnMenubar/Security/CodeburnCLI.swift","mac/Sources/CodeBurnMenubar/Security/PreferredTerminal.swift","mac/Sources/CodeBurnMenubar/Security/SafeFile.swift","mac/Sources/CodeBurnMenubar/Security/TerminalLauncher.swift","mac/Sources/CodeBurnMenubar/StatusItemContextMenuPolicy.swift","mac/Sources/CodeBurnMenubar/Theme/Theme.swift","mac/Sources/CodeBurnMenubar/Theme/ThemeState.swift","mac/Sources/CodeBurnMenubar/Views/ActivitySection.swift","mac/Sources/CodeBurnMenubar/Views/AgentTabStrip.swift","mac/Sources/CodeBurnMenubar/Views/FindingsSection.swift","mac/Sources/CodeBurnMenubar/Views/HeatmapSection.swift","mac/Sources/CodeBurnMenubar/Views/HeroSection.swift","mac/Sources/CodeBurnMenubar/Views/MenuBarContent.swift","mac/Sources/CodeBurnMenubar/Views/ModelsSection.swift","mac/Sources/CodeBurnMenubar/Views/PeriodSegmentedControl.swift","mac/Sources/CodeBurnMenubar/Views/PullRequestsSection.swift","mac/Sources/CodeBurnMenubar/Views/SectionCaption.swift","mac/Sources/CodeBurnMenubar/Views/SettingsView.swift","mac/Sources/CodeBurnMenubar/Views/SparklineView.swift","mac/Sources/CodeBurnMenubar/Views/ToolingSection.swift","mac/Tests/CodeBurnMenubarTests/AppStoreRefreshRecoveryTests.swift","mac/Tests/CodeBurnMenubarTests/AppVersionTests.swift","mac/Tests/CodeBurnMenubarTests/CLIDevinConfigTests.swift","mac/Tests/CodeBurnMenubarTests/CapacityEstimatorTests.swift","mac/Tests/CodeBurnMenubarTests/ClaudeRateLimitTests.swift","mac/Tests/CodeBurnMenubarTests/ClaudeSubscriptionParsingTests.swift","mac/Tests/CodeBurnMenubarTests/CodexPlanParsingTests.swift","mac/Tests/CodeBurnMenubarTests/CodexQuotaSummaryTests.swift","mac/Tests/CodeBurnMenubarTests/CodexResetCreditsTests.swift","mac/Tests/CodeBurnMenubarTests/CodexTerminalFailureTests.swift","mac/Tests/CodeBurnMenubarTests/ContributionHeatmapTests.swift","mac/Tests/CodeBurnMenubarTests/DataClientProcessTests.swift","mac/Tests/CodeBurnMenubarTests/KimiQuotaPresentationTests.swift","mac/Tests/CodeBurnMenubarTests/KimiUsageParsingTests.swift","mac/Tests/CodeBurnMenubarTests/MenubarPayloadCombinedTests.swift","mac/Tests/CodeBurnMenubarTests/MenubarPeriodSettingsTests.swift","mac/Tests/CodeBurnMenubarTests/MenubarStatusCacheTests.swift","mac/Tests/CodeBurnMenubarTests/QuotaPaceTests.swift","mac/Tests/CodeBurnMenubarTests/RefreshCadenceTests.swift","mac/Tests/CodeBurnMenubarTests/StatusItemContextMenuPolicyTests.swift","mac/Tests/CodeBurnMenubarTests/TerminalLauncherTests.swift","mac/Tests/CodeBurnMenubarTests/UpdateCheckerTests.swift","mac/Tests/CodeBurnMenubarTests/UsageDataChangeGuardTests.swift","package-lock.json","package.json","scripts/bundle-litellm.mjs"],"storefront":"/r/getagentseal","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/getagentseal/codeburn/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}