Live terminals on this machine and every connected machine, with their status, cwd, labels and parent. Includes the user's other work, not just yours.

One terminal's facts, live or finished: argv, cwd, state, status, exit code, labels, foreground process.

Start a program in a new terminal that stays alive. argv runs as given; line runs in the shell; neither opens that machine's shell. If argv[0] names a template (see herdr_templates), its command starts and its body plus task are sent as the first message once the agent is ready. For a plain agent, task is typed as its first message once it is ready. Agents: always background=true, a name, and the whole task up front. Programs: background=false waits for exit (up to timeout) and returns its output in output and how it ended in wait. Returns the terminal (address is what you use afterwards) and, with a task, first_message.sent.

Paste text into a terminal and press Enter (once nobody has typed for ~3 s). Refuses a blocked program unless force. With wait=true, also waits for the turn it starts and returns how it ended. Do not resend after an unclear result: read first.

Wait until a program is not working (an agent reports idle/done/blocked/error, or a program exits), or with output, until it prints that text. Use it instead of sleeping or polling. A timeout is a check-in (ended=false), not a failure: wait again. children=all waits until none of the caller's children is working; children=any returns on the next child's news.

The terminal's screen plus lines of history, as plain text, live or finished.

Press named keys in a terminal: enter, esc, tab, up, down, ctrl+c, alt+x, f5, a, ... (e.g. to answer a dialog with down, enter).

Press the stop key (esc for agents, ctrl+c for programs) and report what happened. Stops the current turn, not the process.

End the program: hangup, then terminate, then kill. Only clean up terminals you started.

Remove a finished terminal from the list.

Set or remove labels (free-form key=value). An empty string removes a label.

Write a file beside a live terminal, on its machine, for its program to read (an image to paste, a patch). Returns where it landed.

Ready-made agent roles (reviewer, implementer, ...) by name and description. Run one with herdr_run argv=[name] and a task.

Run one command here or on another machine without a terminal and return its exit code and exactly what it wrote. For short commands (git diff, ls, cat). Everything it started ends with it at exit or timeout. Use herdr_run for anything long or interactive.

Read a text file here or on another machine: lines from offset, at most limit. Returns the text and how many lines the file has.

Write a whole file here or on another machine, making missing folders. Atomic: a reader sees old or new, never half.

Replace exact text in a file here or on another machine. Each old must occur exactly once; edits must not overlap; all are made or none. On edit_failed, add context to make old unique.

The other machines this core has added (over ssh or a command), with their connection state. Use their names in on and machine/t7.

herdr-core's identity, version, pid, uptime and terminal counts, plus this server's connection details.

Call any herdr-core JSON-RPC method directly (rpc.discover lists them all with their schemas). For methods without a dedicated tool: doc.get, doc.set, machine.add, machine.connect, machine.rename, machine.rm, terminal.keep. server.stop and server.restart are refused: they affect every terminal the user has.

Spaces, their tabs and terminals (with pane IDs) in the open Herdr window. Inspect before acting; use these IDs rather than guessing.

What the window shows: layout, selected space and tab, focused pane, overlays, zoom, and any file or mod errors.

Every window command herdr_app_do can run, with its arguments and what it does.

Run a window command: space.new {name, folder, machine, argv, task}, tab.new {name, space, folder, argv, task}, pane.split {direction, pane}, agent.focus {terminal}, tab.select {id}, space.rename {id, name}, ... (herdr_app_commands lists them all). Returns the created IDs. Supply every required argument: commands from an agent never open a dialog. New spaces and tabs are shown immediately: only create them when the user asks, and give them explicit names.

Save the window's last rendered frame as a PNG (its own rendering, even when covered) and return its absolute path. Needs a running window.