Commands

CLI reference for the budi daemon and its sub-commands. Run budi --help for the full flag list.

budi init

              budi init

Starts the daemon on port 7878 and installs the platform-native autostart service (launchd on macOS, systemd on Linux, Startup folder on Windows). Run once after install.

budi status

              budi status

Today-cost snapshot: daemon state, active tailers, and today's spend across all providers.

budi stats

              budi stats [projects | branches | tickets]

Cost breakdown with multiple sub-commands for different attribution levels. Default window is 7 days.

budi stats projects

Cost grouped by repository. Shows today, 7d, and 30d totals.

budi stats branches

Cost grouped by branch. Useful for comparing feature work.

budi stats tickets

Cost grouped by ticket ID extracted from branch names (e.g. PROJ-1234).

budi sessions

              budi sessions [<id>]

Lists recent sessions or shows detail for a specific session. Session detail includes context growth, cache reuse, cost acceleration, retry loops, and vitals.

budi doctor

              budi doctor

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

budi integrations install

              budi integrations install [--with cursor-extension]

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.

budi integrations uninstall

              budi integrations uninstall

Removes all editor integrations (statusline config, VS Code/Cursor extension).

budi cloud join

              budi cloud join <invite-token>

Joins a cloud workspace using an invite token. Creates the cloud config file and enables sync. Off by default — nothing syncs until you run this.

Session detail example

Running budi sessions <id> shows session health in plain English:

~ budi sessions <id>

  Session 2968337c-1e4
  ──────────────────────────────────────────────────
  Agent      claude_code
  Models     claude-opus-4-7
  Started    2026-05-06T02:22:27.194+00:00
  Duration   2m22s
  Repos      github.com/siropkin/budi-cloud
  Branches   151-repos-companion-tables, main
  Outcome    no_commit
             …explanation…

  Messages   22
  Input      32
  Output     10.8K
  Est. cost  $1.70

  Tags
    file_path: src/lib/dal.ts
    …

  🟢 Vitals: GREEN

Project stats example

budi stats project gives you the big picture:

~ budi stats project

Today                          7d        30d
──────────────────────────────────────────────────
$ 4.92 session  🟢 healthy  $ 38.10  $ 162.44

Top repos (last 7d)            cost      msgs
──────────────────────────────────────────────────
siropkin/budi               $ 18.40    21,402
acme/web                    $ 11.05     9,118
acme/infra                  $  6.32     2,845
personal/notes              $  2.33       661

Top models (last 7d)           cost     share
──────────────────────────────────────────────────
claude-opus-4-7             $ 22.18    58.2 %
claude-sonnet-4-6           $  9.41    24.7 %
claude-haiku-4-5            $  4.02    10.6 %
gpt-5-codex                 $  2.49     6.5 %

Branch hot list                cost    ticket
──────────────────────────────────────────────────
budi/feat/cloud-ingest      $  6.91   BUD-214
acme/web/fix/checkout-retry $  4.38   WEB-1180
acme/web/feat/analytics-v3  $  3.12   WEB-1199