herdr_open_agent
Launch a coding agent in a new tab and pane with an optional initial prompt, enabling remote control of a Herdr session via MCP.
Instructions
Open a new tab and pane and start a coding agent in it, optionally with an initial prompt. The one-call way to launch an agent in a fresh tab.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "herdr_open_agent"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cwd | No | Working directory for the new tab. | |
| kind | No | Agent kind, e.g. claude, codex, opencode (default: HERDR_MCP_DEFAULT_KIND). | |
| name | No | Agent name (auto-generated if omitted). | |
| wait | No | Wait for the prompt to settle. | |
| focus | No | Move user focus to the new tab. | |
| prompt | No | Optional initial prompt sent after startup. | |
| agent_args | No | Native agent arguments passed after --. Disabled unless the server sets HERDR_MCP_ALLOW_AGENT_ARGS=1. | |
| timeout_ms | No | Agent startup timeout in milliseconds. | |
| workspace_id | No | Target workspace id (default: focused workspace). |