The donmai CLI ships as a single Go binary named donmai. It handles every operator task: running the local daemon, dispatching agents, querying Linear, and inspecting fleet health.

Homebrew (macOS and Linux, recommended)

Add the tap and install:

brew tap RenseiAI/homebrew-tap
brew install donmai

Verify the installation:

donmai --version

Set up the daemon (macOS)

The daemon registers as a launchd service with the label dev.donmai.daemon. Install it once and it survives reboots automatically:

# Register and start the daemon service
donmai daemon install

# Confirm it is running
donmai daemon status

# Stop the daemon
donmai daemon stop

# Pause / resume without stopping
donmai daemon pause
donmai daemon resume

The daemon reads its configuration from ~/.donmai/daemon.yaml. Run donmai daemon setup for an interactive first-time configuration wizard, or edit the file directly. See the configuration reference.

go install (requires Go 1.25 or later)

go install github.com/RenseiAI/donmai/cmd/donmai@latest

The binary is installed to $(go env GOPATH)/bin/donmai. Add that directory to your $PATH if it is not already present.

Pre-built release binaries

Binaries for macOS (arm64, amd64) and Linux (arm64, amd64) are attached to every GitHub release:

Example for macOS arm64. Replace 0.9.4 with the version you want to install (GoReleaser includes the version in the archive name):

curl -fsSL https://github.com/RenseiAI/donmai/releases/download/v0.9.4/donmai_0.9.4_darwin_arm64.tar.gz \
  | tar -xz -C /usr/local/bin donmai

See the releases page for all assets.

Build from source

git clone https://github.com/RenseiAI/donmai
cd donmai
make build        # produces bin/donmai

Move the binary onto your $PATH:

mv bin/donmai /usr/local/bin/

Full build instructions, including cross-compilation targets and release flags, are in the source repository.

Next steps

• Configure the daemon: Configuration reference
• Start dispatching agents: Quick start