Install the gateway with Homebrew

The gateway is available from the systempromptio/tap Homebrew tap. A dedicated tap gives faster release cadence than homebrew/core and avoids the core review queue. The formula installs systemprompt and systemprompt-mcp-agent to $(brew --prefix)/bin.

Pick Homebrew when you run the gateway on a macOS server or workstation, or on Linux via Linuxbrew, and want brew upgrade and brew services to manage it.

Install

brew tap systempromptio/tap
brew trust systempromptio/tap   # newer brew gates third-party taps; skip on older versions
brew install gateway

Configuration

Before starting, export the required environment or set it in $(brew --prefix)/etc/systemprompt.env:

DATABASE_URL=postgres://user:pw@host:5432/systemprompt
ANTHROPIC_API_KEY=sk-ant-...

If you do not already run Postgres, install it with Homebrew too:

brew install postgresql@16
brew services start postgresql@16
createdb systemprompt

Run as a service

brew services start gateway

The API serves on port 8080. Logs land at ~/Library/Logs/Homebrew/gateway.log on macOS or $(brew --prefix)/var/log/gateway.log on Linuxbrew. Stop with brew services stop gateway.

Upgrade

brew update
brew upgrade gateway

Where to go next

For the full formula details, service paths, and Linuxbrew notes, see the full Homebrew recipe in the template repository. For Homebrew itself (taps, formulae, services), see the Homebrew documentation.