donmai is in 0.x preview. APIs may change between minor releases. See the changelog.

donmai is the open-source CLI and daemon for running AI agent fleets. The af binary manages the local session daemon, dispatches agents against Linear backlogs, and surfaces fleet health via a terminal dashboard.

Architecture overview

The donmai stack has two layers: the OSS CLI + daemon (everything in this repo), and the closed platform that orchestrates work across fleets.

Sections

  • Getting started — install donmai via Homebrew or go install, set up the daemon, and dispatch your first agent session.
  • Configuration~/.donmai/daemon.yaml key reference and the WORKER_API_KEY / DONMAI_API_TOKEN / DONMAI_* environment variables.
  • Plugins — extend agent tool sets with ToolPlugin packages under the @donmai/* npm scope.
  • Workflow nodesActionDefinition, TriggerDefinition, ConditionDefinition interface contracts and the workflow YAML grammar.

Source

Source is on GitHub at github.com/RenseiAI/donmai. Issues and pull requests welcome.