skip to content
donmai
doc d-001 · donmai overview · rev 2026-07-07sha256:2254…5884

00 · donmai (どんまい): what you say when a teammate drops the ball. don't mind, next play.

The OSS agent runtime that takes it on.

One Go binary: a persistent daemon, a dispatch loop, and plugin-native MCP tools that run agent sessions against your repos, on your machine. MIT licensed. The same runtime powers Rensei in production.

Don, the kitsune mascot
brew install RenseiAI/homebrew-tap/donmai

rec 00 sha256:0493…0221 ▸ prev 409b…13b1 ▸ build 2026-07-07T15:27Z

01 · fig 1.0

fig 1.0rendered in-browserdemo data
donmai daemon status
Daemon: ready
Machine: demo-host
Version: 0.38.2
PID: 42531
Uptime: 6s
Sessions: 0 / 8
Projects: 1 allowed
Timestamp: 2026-06-11T01:42:01Z
donmai orchestrator --project demo
Donmai Orchestrator
=========================
Project: demo
Max concurrent: 3
Repo: Any
Dry run: false
Dispatched 1 agent(s):
demo-142 → claude · workarea wa-7c2
[session] demo-142 step qa: WORK_RESULT:failed (attempt 1/2)
どんまい. don't mind, next play.
[dispatch] demo-142: retry dispatched (attempt 2/2)
[session] demo-142 step qa: WORK_RESULT:passed
[audit] demo-142: attempt 2 recorded · every attempt on the record
fig 1.0 - a step fails, the loop retries, the audit line lands. demo data.

rec 01 sha256:477c…d238 ▸ prev a351…6f24 ▸ build 2026-07-07T15:27Z

02 · what ships

What ships: the daemon, the dispatch loop, the MCP tools.

A daemon that holds the fleet

Runs under launchd or systemd, enforces capacity caps, and drains, pauses, or resumes sessions on command.

A dispatch loop that owns the retry

Takes a backlog issue to a worktree to an agent session, applies your retry policy, and records every attempt.

Plugin-native MCP tools

17 Linear and 6 code-intelligence tools from the @donmai/* TypeScript packages; the binary wires them to agents as stdio MCP servers and ships the 6 code ops as native CLI subcommands.

A typed workflow grammar

Zod-validated YAML v2 contracts, published in @donmai/core. The durable executor that runs them at scale is the platform side: see the boundary.

rec 02 sha256:3cce…909c ▸ prev bbbd…0d57 ▸ build 2026-07-07T15:27Z

03 · the boundary

Where OSS ends and the platform begins.

oss · mit

  • daemon
  • dispatch loop
  • MCP tool plugins (17 Linear + 6 code-intelligence; code-intelligence npm publish pending, the code ops ship native in the binary)
  • typed YAML workflow grammar and validation
  • provider plugin contract + capability matrix docs (verified-tier probing runs on the platform)
  • architectural intelligence (repo assessment)

platform · rensei

  • ~60 concrete workflow nodes
  • durable executor
  • visual editor
  • Cedar policy
  • audit chain
  • routing intelligence

No asterisks. The contract is the docs.

The daemon pairs with any orchestrator endpoint you point it at, including a self-hosted one, or runs solo on a local file queue; the setup wizard offers both. Standalone-mode documentation is in progress.

rec 03 sha256:e026…9812 ▸ prev e2a0…fa4d ▸ build 2026-07-07T15:27Z

04 · install

Four commands to a running daemon.

brew install RenseiAI/homebrew-tap/donmai
donmai daemon setup
donmai daemon install
donmai daemon status

donmai is 0.x preview; APIs may change between minor releases.

Full install guide →

rec 04 sha256:b5b9…3b09 ▸ prev 8b0a…12fb ▸ build 2026-07-07T15:27Z

05 · open

Open source, with the history to prove it.

current release: v0.40.0

donmai is MIT licensed. Issues, pull requests, and the full release history live on GitHub.

donmai is what you say when a teammate drops the ball. The runtime treats failure as the default condition.

rec 05 sha256:8126…dc42 ▸ prev 31a7…1125 ▸ build 2026-07-07T15:27Z