Install

brew tap RenseiAI/homebrew-tap
brew install donmai

Configure the daemon

Run the interactive setup wizard. It writes ~/.donmai/daemon.yaml:

donmai daemon setup

The wizard asks for:

• Your orchestrator URL (the donmai platform endpoint your org provides)
• An auth token (DONMAI_DAEMON_TOKEN or paste it at the prompt)
• Which repositories (projects) this machine is allowed to run sessions for

You can also edit ~/.donmai/daemon.yaml directly. See the full configuration reference.

Install the daemon service

donmai daemon install

This registers a launchd service (macOS) or systemd unit (Linux) that keeps the daemon running across reboots.

donmai daemon status

Expected output:

daemon  running   pid=12345   sessions=0/8   uptime=3s

Dispatch agents

Use the built-in orchestrator to pick up Linear issues and dispatch agents:

# Process the backlog for a Linear project
donmai orchestrator --project MyProjectName

# Process a single known issue
donmai orchestrator --single PROJ-123

Agents run inside the daemon's session pool. Watch activity in real time:

# Live fleet status
donmai status

# List running sessions
donmai agent list

# Tail logs
donmai daemon logs

Stop the daemon

# Drain active sessions first, then stop
donmai daemon drain

# Or stop immediately
donmai daemon stop