CodeBurn
Getting StartedGuidesProvidersReferenceCommunity

Installation

Multiple ways to install CodeBurn on macOS, Linux, and Windows.

Desktop app

On Windows, install the signed app from the Microsoft Store. The Store also delivers future updates automatically.

npm (recommended)

npm install -g codeburn

Homebrew

brew tap getagentseal/codeburn
brew install codeburn

Run Without Installing

Use any of these to run CodeBurn directly without a global install:

npx codeburn
bunx codeburn
dx codeburn

Requirements

  • Node.js 20+ (check with node --version)
  • At least one supported AI coding tool with session data on disk
  • For Cursor and OpenCode support, better-sqlite3 is installed automatically as an optional dependency

Verify Installation

codeburn --version
codeburn status

If codeburn is not found after install, make sure your npm global bin directory is in your PATH.

Updating

npm update -g codeburn
# or
brew upgrade codeburn
Getting StartedDashboard