Quick start

Donmai offers two local paths. donmai host manages a persistent daemon on this machine. The standalone donmai orchestrator starts an installed Claude or Codex CLI directly, without the daemon.

Install

On macOS:

brew install RenseiAI/homebrew-tap/donmai

On Linux, use the Go or release-archive instructions in Install, then continue below.

Run a persistent host

The interactive setup wizard writes ~/.donmai/daemon.yaml. Install the service after configuring this machine:

donmai host setup
donmai host install
donmai host status
donmai host doctor

The service uses launchd on macOS or a systemd user unit on Linux. host status reads its local control API; host doctor checks the installed service. You can also edit daemon.yaml directly; see the configuration reference.

Read host activity with:

donmai host stats
donmai host logs

Dispatch directly without a daemon

In a Git checkout, set LINEAR_API_KEY, choose a real Linear project, and install a Claude or Codex CLI. The standalone orchestrator selects backlog issues and starts the provider process directly. Preview first:

donmai orchestrator --project MyProjectName --dry-run
donmai orchestrator --project MyProjectName

For a specific known issue, use donmai orchestrator --single PROJ-123 with a real issue identifier. This path does not use the daemon's session pool.

Stop a persistent host

# Drain active sessions first, then stop
donmai host drain

# Or stop immediately
donmai host stop

Next steps

• Configuration reference - full daemon.yaml key reference and environment variables
• Plugins overview - extend agent tool sets with ToolPlugin packages
• Workflow node contracts - ActionDefinition, TriggerDefinition, and workflow YAML grammar