From 6513cb867918487b520652606a029f57f7625185 Mon Sep 17 00:00:00 2001 From: Hoang Nguyen Date: Sat, 10 Oct 2026 13:15:07 +0000 Subject: [PATCH 1/2] docs: mention the Herdr managed runtime alongside tmux Generated with [Devin](https://devin.ai) Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- web/content/docs/13-agent-console.md | 2 +- web/content/docs/8-agent-management.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/web/content/docs/13-agent-console.md b/web/content/docs/13-agent-console.md index b0bc2ca9a..6cb38d3bb 100644 --- a/web/content/docs/13-agent-console.md +++ b/web/content/docs/13-agent-console.md @@ -104,7 +104,7 @@ Supported start types: | `kiro` | Kiro CLI | | `devin` | Devin | -Starting an agent from the console uses a managed tmux session. If tmux is not installed or the selected agent command is not in `PATH`, the console shows an error. +Starting an agent from the console uses the configured managed runtime (tmux by default, or Herdr when configured). If tmux is not installed or the selected agent command is not in `PATH`, the console shows an error. ### Rename an Agent diff --git a/web/content/docs/8-agent-management.md b/web/content/docs/8-agent-management.md index bf5733906..24d133dde 100644 --- a/web/content/docs/8-agent-management.md +++ b/web/content/docs/8-agent-management.md @@ -48,7 +48,7 @@ AI DevKit detects active sessions from the following tools: ### Start an Agent -Start a named agent in a managed tmux session: +Start a named agent in a managed runtime session (tmux by default; the Herdr runtime is used when configured): ```bash ai-devkit agent start --type claude --name backend --cwd ./packages/backend @@ -56,7 +56,7 @@ ai-devkit agent start --type claude --name backend --cwd ./packages/backend `--type` accepts `claude`, `codex`, `copilot`, `gemini_cli`, `grok_cli`, `kiro`, `opencode`, or `pi`. Names default to the current folder plus a timestamp. Use `--cwd ` to choose a working directory and `--debug` to show startup diagnostics. -The default `--mode interactive` starts the agent in tmux. Claude also supports a durable mode that keeps a named agent available without an interactive terminal: +The default `--mode interactive` starts the agent in an interactive session. Start output reports the runtime used (for example `Runtime: herdr`). The `durable` mode keeps a named agent available without an interactive terminal: Run `ai-devkit setup` to check the host prerequisite early. It reports the installed tmux version or prints a platform-aware install command without installing packages or failing setup. tmux 2.6+ is the provisional documented compatibility floor; older versions are reported, not rejected. From 160f32f42ba0454180534dc47e392ddcf45d80f5 Mon Sep 17 00:00:00 2001 From: Hoang Nguyen Date: Sat, 10 Oct 2026 13:37:21 +0000 Subject: [PATCH 2/2] docs: show the agentRuntime.provider config key for Herdr (technical-writer pass) Generated with [Devin](https://devin.ai) Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- web/content/docs/13-agent-console.md | 2 +- web/content/docs/8-agent-management.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/web/content/docs/13-agent-console.md b/web/content/docs/13-agent-console.md index 6cb38d3bb..537fabdc7 100644 --- a/web/content/docs/13-agent-console.md +++ b/web/content/docs/13-agent-console.md @@ -104,7 +104,7 @@ Supported start types: | `kiro` | Kiro CLI | | `devin` | Devin | -Starting an agent from the console uses the configured managed runtime (tmux by default, or Herdr when configured). If tmux is not installed or the selected agent command is not in `PATH`, the console shows an error. +Starting an agent from the console uses the configured managed runtime (tmux by default, or Herdr when `agentRuntime.provider` is set to `herdr` in `.ai-devkit.json`). If tmux is not installed or the selected agent command is not in `PATH`, the console shows an error. ### Rename an Agent diff --git a/web/content/docs/8-agent-management.md b/web/content/docs/8-agent-management.md index 24d133dde..00eab0abf 100644 --- a/web/content/docs/8-agent-management.md +++ b/web/content/docs/8-agent-management.md @@ -48,7 +48,7 @@ AI DevKit detects active sessions from the following tools: ### Start an Agent -Start a named agent in a managed runtime session (tmux by default; the Herdr runtime is used when configured): +Start a named agent in a managed runtime session (tmux by default; set `"agentRuntime": {"provider": "herdr"}` in `.ai-devkit.json` to use the Herdr runtime instead): ```bash ai-devkit agent start --type claude --name backend --cwd ./packages/backend