Skip to content
budi / getbudi.dev
Docs menu

Getting started

One paste installs budi and starts the daemon. Then four steps to verify everything works.

Install

The command below installs budi and runs budi init — the daemon is up and the autostart service is wired. 

brew install siropkin/budi/budi && budi init

Installs latest release from GitHub Releases. One command. macOS / Linux / Windows. No account needed.

Four steps to verify

If anything looks wrong, budi doctor is the source of truth. For a live session health read, run budi sessions <id>.

  1. budi init

    Starts the daemon on port 7878 and installs the platform-native autostart service. The hero install runs this for you — listed here so you know what just happened.

  2. budi integrations install

    Wires the Claude Code statusline and offers the VS Code / Cursor extension if either editor is detected. Restart Claude Code afterwards so it picks up the new statusLine command.

  3. budi doctor

    End-to-end verifier: daemon, tailers, schema, transcript visibility, and attribution health. When "All checks passed." you are done.

  4. budi status

    Today’s-cost snapshot: daemon state and today’s spend. For the full breakdown, use budi stats projects / branches / tickets.

Editor extension

Adds the budi status bar to VS Code, Cursor, or a JetBrains IDE. budi init offers VS Code / Cursor automatically. Pick your editor:

Other install methods

Bundled extension via budi CLI

Same path budi init uses. Picks the right editor automatically. 

budi integrations install --with cursor-extension

Daemon from source (Rust toolchain) 

git clone https://github.com/siropkin/budi.git && cd budi && ./scripts/install.sh

Updating

Re-run the same install command for your platform — it fetches the latest release and replaces the binaries in place. Run budi doctor afterwards to verify. 

brew upgrade budi

Uninstalling

Remove editor integrations first, then the binary.

Step 1 — remove editor wiring (all platforms) 

budi integrations uninstall

Step 2 — remove the binary 

brew uninstall budi