herdr_agent_start
Start a coding agent (e.g., Claude, Codex) in an existing shell pane to enable remote control and prompting. Specify agent name, kind, and pane ID.
Instructions
Start a coding agent in an existing available shell pane.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>",
"kind": "<kind>",
"pane_id": "<pane_id>"
},
"name": "herdr_agent_start"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | Agent kind, e.g. claude, codex, opencode. | |
| name | Yes | Unique agent name [a-z][a-z0-9_-]{0,31}. | |
| pane_id | Yes | Pane that will host the agent. | |
| agent_args | No | Native agent arguments passed after --. Disabled unless the server sets HERDR_MCP_ALLOW_AGENT_ARGS=1. | |
| timeout_ms | No | Startup timeout in milliseconds. |