# Install codeburn with Homebrew See where your AI coding tokens go - by task, tool, model, and project. Version 0.9.19 via Homebrew; verified 2026-07-21. ## Install ```sh sudo av install brew:codeburn ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install codeburn ``` Evidence: local Homebrew formula metadata ## Package facts - **Package key:** brew:codeburn - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.9.19 - **Source summary:** See where your AI coding tokens go - by task, tool, model, and project - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Last updated:** 2026-07-21T19:01:49Z - **Generated:** 2026-07-25T07:20:51+00:00 ## Executables - codeburn (cli) - codeburn (alias) ## Dependencies - node ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-25 - Package-manager version: 0.9.19 - Package-manager updated: 2026-07-21 - Local data: ok - Upstream repository: https://codeburn.app/ - info: Release/tag comparison is only available for GitHub repositories. ## Project history and usage CodeBurn is a local-first CLI, TUI, web dashboard, and macOS menubar tool for analyzing token usage and cost across AI coding tools. It reads session files already written on disk and reports spend by tool, model, task, and project. ### Project history The GitHub repository was created on 2026-04-13. Its README describes the project as a free, open-source, local tool for tracking AI coding token usage and cost across Claude Code, Cursor, Codex, Gemini, Grok, and other tools. Early releases moved quickly in April 2026, with the release metadata showing v0.7.0 adding `codeburn optimize` and adjacent macOS menubar releases appearing the same week. ### Adoption history The README documents `npx codeburn`, global npm installation, Bun/Deno-style runners, and `brew install codeburn` on macOS. The input package facts currently list Homebrew packaging. Because CodeBurn targets local files created by other AI coding tools, its adoption story is tied to the spread of agentic coding CLIs and editors rather than to one language ecosystem. ### How it is used Users run `npx codeburn` or `codeburn` to open an interactive dashboard, `codeburn overview` for reports, `codeburn optimize` for waste findings, `codeburn compare` for model comparisons, `codeburn yield` to correlate sessions with git commits, and `codeburn web` for a localhost dashboard. The README stresses local operation: no wrapper, proxy, or API keys, with pricing sourced from LiteLLM and refreshed daily. ### Why package nerds care CodeBurn is notable as packaging infrastructure for the AI-coding era: it treats token logs and session files like operational telemetry and ships through npm-style runners and Homebrew. For package nerds, the interesting part is how a Node CLI, local dashboard, native menubar app, and Homebrew formula package one local observability workflow. ### Timeline - 2026-04-13: GitHub repository created. - 2026-04-16: v0.7.0 release metadata names `codeburn optimize`. - 2026-04-18 to 2026-04-19: Multiple macOS menubar releases published. - 2026: README documents npm, npx, Bun/Deno-style runners, and Homebrew installation. ### Related projects - The README names Claude Code, Cursor, Codex, Gemini, Grok, and LiteLLM in the supported-tooling story. The macOS menubar app lives in the same repository under `mac/` according to the README. ### Sources - ## Security Notes No matching local secret-handling manifest was found for codeburn. Nucleus package metadata is still published here so future coverage has a stable package URL. ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** codeburn - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Related links - [MCP tool packages](https://www.automicvault.com/pkg/mcp-tools/) - Mentions MCP or Model Context Protocol. - [AI and agent packages](https://www.automicvault.com/pkg/ai-agent-tools/) - Matched AI model, agent, coding-agent, orchestration, or MCP metadata. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata. - [node](https://www.automicvault.com/pkg/brew/node/) - Runtime dependency declared by Homebrew. - [splitrail](https://www.automicvault.com/pkg/brew/splitrail/) - Shares av.db curated category or tags: ai, ai-coding, cli, coding-agents, token-usage. - [ccusage](https://www.automicvault.com/pkg/brew/ccusage/) - Shares av.db curated category or tags: ai, cli, coding-agents, token-usage. - [codex-acp](https://www.automicvault.com/pkg/brew/codex-acp/) - Shares av.db curated category or tags: ai, ai-coding, cli, coding-agents. - [ctx7](https://www.automicvault.com/pkg/brew/ctx7/) - Shares av.db curated category or tags: ai, ai-coding, cli, coding-agents. - [happy-coder](https://www.automicvault.com/pkg/brew/happy-coder/) - Shares av.db curated category or tags: ai, ai-coding, cli, coding-agents. - [pixtuoid](https://www.automicvault.com/pkg/brew/pixtuoid/) - Shares av.db curated category or tags: ai, cli, coding-agents, tui. - [rtk](https://www.automicvault.com/pkg/brew/rtk/) - Shares av.db curated category or tags: ai, ai-coding, cli, coding-agents. - [specify](https://www.automicvault.com/pkg/brew/specify/) - Shares av.db curated category or tags: ai, ai-coding, cli, coding-agents. ## Combined YAML source View the package source record on GitHub. [combined/codeburn.yml](https://github.com/automic-vault/db/blob/main/combined/codeburn.yml) ## Sources - Nucleus package database - package-page enrichment - curated package history - package version freshness - av.db category and tag curation - package relationship graph - cross-ecosystem install command graph