diff --git a/web/content/docs/13-agent-console.md b/web/content/docs/13-agent-console.md
index b0bc2ca9a..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 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 `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 bf5733906..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 tmux session:
+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
@@ -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 <path>` 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.