Homebrew Tap for Budi

Budi is a local-first cost analytics layer for AI coding agents. It tails the JSONL transcripts that Claude Code, Codex, Cursor, and Copilot CLI write to disk, capturing every request in real time so you can see session cost, today's spend, and historical trends — without any prompts, code, or responses leaving your machine.

This repository is the Homebrew tap for distributing Budi on macOS and Linux.

Install

brew install siropkin/budi/budi
budi init

budi init creates the data dir, starts the daemon, registers a platform autostart service (launchd on macOS, systemd user unit on Linux), and wires recommended integrations (Claude Code statusline, Cursor / VS Code extension). Capture is JSONL-tailing only — no shell or editor patching.

What you get

• budi status — quick overview: daemon, today's cost
• budi stats — usage analytics by agent, project, branch, model, or tag
• budi sessions — per-session breakdown with health signals
• budi health — session vitals: prompt growth, cache reuse, retry loops, cost acceleration
• budi doctor — health check for daemon, database, and autostart
• budi import — import historical transcripts (Claude Code, Codex CLI, Copilot CLI, Cursor)

Optional cloud dashboard

An optional, opt-in cloud dashboard at app.getbudi.dev gives solo developers and teams cost visibility across users, repos, models, and branches. Only aggregated daily rollups and session summaries leave the machine — prompts, code, responses, file paths, and email addresses are never uploaded. See ADR-0083 for the full privacy contract. Cloud sync is disabled by default.

Update

brew upgrade budi

Uninstall

brew uninstall budi
budi uninstall   # removes local config and autostart service (keeps the binaries managed by brew)

Platforms

OS	Architectures
macOS	arm64, x86_64
Linux	arm64, x86_64

For Windows, download the .zip from the GitHub Releases page.

Formula

The Formula/budi.rb file in this tap is auto-generated by the Budi release workflow on every stable vX.Y.Z tag. Do not edit it manually — changes are overwritten on the next release.

Prerelease tags in the main repo (vX.Y.Z-rc.N, -beta.N, …) do not bump this tap — the GitHub release is published as a "Pre-release" with full platform artifacts for direct download/testing, but brew upgrade siropkin/budi/budi stays on the latest stable. Maintainers promote an rc by re-tagging the same SHA as the clean vX.Y.Z; the tap auto-bumps then.

Links

• Project: github.com/siropkin/budi
• Cursor / VS Code extension: github.com/siropkin/budi-cursor
• JetBrains plugin: github.com/siropkin/budi-jetbrains
• Cloud dashboard: github.com/siropkin/budi-cloud · app.getbudi.dev
• Marketing site: github.com/siropkin/getbudi.dev · getbudi.dev

License

MIT — same as the main Budi repo.