Install

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, recommended)

Install from the official tap:

brew install RenseiAI/homebrew-tap/donmai

Verify the installation:

donmai --version

Set up the host daemon (macOS)

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

# Configure this machine
donmai host setup

# Register and start the daemon service
donmai host install

# Confirm it is running
donmai host status
donmai host doctor

The daemon reads its configuration from ~/.donmai/daemon.yaml. Run donmai host setup for an interactive first-time configuration wizard, or edit the file directly. See the configuration reference. For later maintenance, donmai host pause and donmai host resume control admission, donmai host stop stops the service, and donmai host update triggers a manual update check.

go install (requires Go 1.26.6 or later)

go install github.com/RenseiAI/donmai/cmd/donmai@v0.72.52

Use the explicit release pin: the public Go proxy currently resolves @latest to the historical v1.0.0 module. This source-install command records the pinned module version in Go build information and reports dev for donmai --version.

By default, 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, pinned to the current release. Replace 0.72.52 with the version you want to install (GoReleaser includes the version in the archive name; CI checks this pinned version against the latest GitHub release so the example cannot go stale):

curl -fsSLO https://github.com/RenseiAI/donmai/releases/download/v0.72.52/donmai_0.72.52_darwin_arm64.tar.gz
printf '%s  %s\n' 'a35b17a7e8653aec4af1036413ba4e6c4e40fb99ea9a2462bc9e79c462b826d3' 'donmai_0.72.52_darwin_arm64.tar.gz' \
  | shasum -a 256 -c - && \
  tar -xzf donmai_0.72.52_darwin_arm64.tar.gz -C /usr/local/bin donmai

The published SHA-256 hashes for the other archives are:

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