diff options
| author | Ogulcan Celik <ogulcancelik@gmail.com> | 2026-05-17 01:41:16 +0300 |
|---|---|---|
| committer | Ogulcan Celik <ogulcancelik@gmail.com> | 2026-05-17 01:41:16 +0300 |
| commit | e4de58b37f58d59d146158239ed218a8accd5c3c (patch) | |
| tree | 6bb35b8c9aaec969110ff51a58814dd8099617c0 /SOCKET_API.md | |
| parent | 86adf88351e17c6a11cac253714b169eac0db233 (diff) | |
feat: add agent start for server-owned terminals
Diffstat (limited to 'SOCKET_API.md')
| -rw-r--r-- | SOCKET_API.md | 5 |
1 files changed, 4 insertions, 1 deletions
diff --git a/SOCKET_API.md b/SOCKET_API.md index fe6aed2d..b21fba6f 100644 --- a/SOCKET_API.md +++ b/SOCKET_API.md @@ -231,6 +231,7 @@ for backward compatibility, requests also accept the older positional forms like | `agent.send` | send literal text to one terminal-backed agent | `ok` | | `agent.rename` | set or clear the unique agent/terminal name | `agent_info` | | `agent.focus` | show the terminal-backed agent in the TUI | `agent_info` | +| `agent.start` | start a named terminal-backed agent from argv | `agent_started` | | `pane.list` | list panes, optionally filtered by workspace | `pane_list` | | `pane.get` | inspect one pane | `pane_info` | | `pane.rename` | set or clear a manual pane label | `pane_info` | @@ -997,9 +998,10 @@ herdr agent read <target> [--source visible|recent|recent-unwrapped] [--lines N] herdr agent send <target> <text> herdr agent rename <target> <name>|--clear herdr agent focus <target> +herdr agent start <name> [--cwd PATH] [--workspace ID] [--tab ID] [--split right|down] [--focus|--no-focus] -- <argv...> ``` -agent targets accept terminal ids, unique agent names, and legacy pane ids. duplicate names fail clearly for `agent.*`; `pane.rename` can still create duplicate pane labels for backward compatibility. +agent targets accept terminal ids, unique agent names, and legacy pane ids. duplicate names fail clearly for `agent.*`; `pane.rename` can still create duplicate pane labels for backward compatibility. `agent start` treats everything after `--` as argv and does not require agent-specific launch logic. pane commands: @@ -1038,6 +1040,7 @@ herdr wait agent-status <pane_id> --status <idle|working|blocked|done|unknown> [ - `agent list` shows named panes and detected/reported agents as terminal-backed agents - `agent focus` switches the TUI workspace/tab/pane focus; it is not direct terminal attach - `agent rename` enforces unique active names; use `pane rename` only when duplicate labels are intentional +- `agent start <name> -- <argv...>` starts a named pane-backed terminal and returns `result.agent` plus `result.argv` - `pane split` keeps focus where it is by default; pass `--focus` to switch to the new pane - `pane read` prints **text**, not json - `pane read --format ansi` and `pane read --ansi` print a rendered ANSI snapshot with colors/styles preserved |