supbuddy

Run multiple Supabase projects at once on custom local domains with HTTPS. The headless CLI and daemon for Supbuddy: a Caddy proxy, local DNS, Supabase and Docker Compose lifecycle, and an MCP server for AI agents. Works on macOS and Linux.

supabase start only runs one project at a time and collides on ports 54321/2/3. Supbuddy keeps every project's full stack running at once, each reachable on its own domain like api.acme.local.

Install

npx supbuddy@latest

That prompts to install the CLI globally (the supbuddy command, with sup as a short alias). The CLI is independent of the desktop app, so you can install the app later, or not at all. To install without the prompt:

npm install -g supbuddy

Usage

supbuddy daemon --detach     # start the background daemon (proxy, DNS, MCP)
supbuddy status              # daemon + proxy health
supbuddy project ls          # registered projects
supbuddy supabase start acme --follow   # start a project's Supabase, stream progress
supbuddy map ls              # domain → port mappings
supbuddy mcp add claude-code # register Supbuddy with an AI coding agent
supbuddy tui                 # full-screen dashboard (alias: sup dash)
supbuddy help                # the full command reference

Commands attach to the daemon over a local control port, discovered through a 0600 daemon.json, so you never pass ports or tokens by hand. Add --json to any command for machine-readable output.

Run on login:

supbuddy service install     # launchd on macOS, systemd-user on Linux

The desktop app

The macOS desktop app ships the same daemon with a GUI, the local Certificate Authority installer, and a request monitor. The CLI and the app share one state directory and the same daemon, so they manage the same projects. Get the app at supbuddy.app.

Docs

Full documentation: supbuddy.app/docs.

License

MIT