Check that Herdr is reachable and report server version plus event tap state.

Full live snapshot: workspaces, tabs, panes, agents, layouts and focus. Large; prefer the list tools for routine checks.

List workspaces with their labels, tab/pane counts and aggregate agent status.

Get one workspace by id (for example "w1").

Create a workspace with one tab and one shell pane. Returns the new workspace, tab and root_pane ids.

Switch the user's view to a workspace.

Rename a workspace.

Close a workspace and every pane process in it. Only close workspaces you created or the user named.

List tabs, optionally within one workspace.

Create a tab with one shell pane. Returns the new tab and root_pane ids.

Switch the user's view to a tab (for example "w1:t2").

Rename a tab.

Close a tab and every pane process in it. Only close tabs you created or the user named.

List panes with cwd, title, hosted agent and agent status, optionally within one workspace.

Get one pane by id (for example "w1:p3").

Geometry of the tab containing a pane: rects and split tree. Use it to pick a split direction.

Foreground process and shell information for a pane.

Read terminal output from a pane. recent-unwrapped joins soft wraps and suits logs; visible is the rendered viewport.

Split a pane to create a new shell pane beside it. Returns the new pane under result.pane. Split wide panes right and tall panes down.

Type a shell command into a pane and press Enter. The pane must be at an interactive shell prompt.

Send raw text to a pane without pressing Enter.

Send logical key presses to a pane, for example ["ctrl+c"] or ["esc"] or ["enter"].

Block until pane output contains a literal substring (match) or a Rust regex (regex). Output that already exists matches immediately.

Set a pane's label, or clear it when label is omitted.

Close a pane and kill its process. Only close panes you created or the user named.

List recognized coding agents: kind, name, pane, cwd, status and terminal title.

Get one agent by unique name or hosting pane id.

Explain how Herdr detected an agent and why it reports its current state.

Read an agent's terminal output. Use after agent_prompt to see the response; use source=detection for the raw bottom-of-screen text.

Submit a prompt to an agent. With wait=true, block until the agent settles (idle, done or blocked by default, or any state in until). Rejected with agent_blocked if the agent is already waiting at a dialog.

Wait until an agent reaches a settled state (idle, done or blocked by default, or any state in until).

Send logical key presses to an agent's UI, for example ["esc"], ["ctrl+c"], ["enter"], ["y"].

Start a coding agent (kind such as claude, codex, grok, opencode, pi) in an existing idle shell pane and name it. Extra args go to the agent's own CLI.

Give an agent a unique name, or clear it when name is omitted.

Switch the user's view to an agent's pane and mark its completion as seen.

List git worktrees known to a workspace or repository.

Create a git worktree and open it as a linked workspace.

Show a toast inside the Herdr terminal UI.

State of the live event tap: connection, buffer bounds (oldest_seq, latest_seq), and last known agent status per pane.

Buffered Herdr events after since_seq, newest last. Kinds include pane_agent_status_changed, pane_agent_detected, pane_created, pane_closed, pane_exited, tab_created, tab_closed, workspace_created, workspace_closed, layout_updated, tap_connected, tap_disconnected. Returns latest_seq to use as the next cursor.

Block until a matching event arrives after since_seq, or until timeout_ms. Typical: kinds=["pane_agent_status_changed"], agent_status=["done","blocked"]. Returns timed_out=true with no events when nothing matched.