Ping the herdr server. Returns the server version and protocol.

Dump the full herdr session: workspaces, tabs, panes, layouts and agents. Useful for debugging the entire state at once.

List all open workspaces in herdr.

Get a single workspace by id. Returns label, tab/pane count, worktree info if linked.

List tabs, optionally filtered to a workspace. Each tab has tab_id, label, pane_count, agent_status.

Get a single tab by id. Returns label, pane_count, workspace_id, agent_status.

List all panes, optionally filtered to a workspace. Each pane has pane_id, cwd, agent_status, terminal info.

Get pane info by id. Returns cwd, terminal_id, agent_status, agent (if running opencode), terminal_title, scroll info.

Split a pane, creating a new pane to the right or below. Returns the new pane's pane_id. Essential for launching reviewers in a clean pane.

Send text and/or key presses to a pane in one call. Used for warm-up (PING_REPLY_WITH_PONG) and sending commands. Keys are key names like Enter, CtrlC, Backspace.

Block until the pane output matches a substring or regex, then return the read. More efficient than polling. Returns the matched output lines.

Launch an opencode agent in a pane. Returns agent info. May need retries if the pane is not ready yet ('not an available shell').

Send a prompt to an agent running in a pane. Optionally block until the agent reaches one of these statuses: idle, working, blocked, done, unknown.

Get agent info by target (pane id, session id or path). Returns agent_status (idle/working/blocked/done/unknown), terminal_title, interactive_ready. Note: agent_status is nested under .agent.agent_status.

Block until the agent reaches one of the given statuses (idle, working, blocked, done, unknown). Alternative to polling agent.get in a loop.

Read recent output from an agent's terminal. Used to check for TASK_COMPLETE, blocked questions, or any agent output. For warm-up: read ~400 lines from 'recent' looking for PONG.

Send key presses to an agent's terminal. Useful for recovery (CtrlC to interrupt a stuck agent) or TUI navigation.

Create a git worktree and open it as a herdr workspace. Returns workspace_id, root_pane.pane_id (for agent.start), and worktree info. The pane may need retries for agent.start if 'not an available shell'.

WARNING: Destructive: deletes the worktree checkout and closes its workspace. Does NOT delete the git branch (use git branch -D separately).

List git worktrees for a repository. Returns branch, path, is_linked_worktree, open_workspace_id for each.