Herdr-shaped adapter that drives Rex. Speaks enough of Herdr's CLI / Unix-socket API that agent skills and scripts written for Herdr can control Rex sessions, windows, and terminal blocks.
See DESIGN.md for architecture, ID mapping, and the P0 method table.
0.17.0 — working against a live Rex server:
- Inspect:
ping,session.snapshot(enrichedagents[]+layouts[]), workspace/tab/pane list/get/current pane.get/pane.currentincludeagent/agent_sessionwhen detectedpane.focus/agent.focusraise block + window + app session select; replypane_info- Panes: split, send-text/keys/send-input, run, read (
recent_unwrappedalias), wait-output, close, rename, process-info - Panes: report-agent / report-metadata / release-agent
- Layout: layout, neighbor, edges, zoom, swap, resize, focus / focus_direction
- Layout trees:
layout.export/apply/set-split-ratio;pane.move(same session + cross-ws recreate) - Worktrees:
worktree.list/create/open/removevia git + Rex sessions; emitworktree_*on event stream - Workspaces/tabs: create, focus, rename, close, move (
insert_index;--close-groupfor worktree primaries) - Events:
events.subscribe(socket stream + local hub),events.wait,herdrex events follow - Agents: list/get/read/prompt/wait/focus/rename/send-keys/start/explain via OSC 7501
program_status - Agent turns / views / report_agent holds as in 0.12–0.13
notification.showvia macOS Notification Center (Rex has no toast API)- Cross-workspace
pane.move/new_workspace: recreate shell at source cwd (PTY not preserved) - New shells get
HERDR_ENV=1, Herdr ids, and aherdrshim →herdrex
go build -o herdrex ./cmd/herdrex# optional long-running socket (Herdr-compatible NDJSON)
./herdrex serve
# one-shot CLI (uses the socket if running, else talks to Rex directly)
./herdrex status
./herdrex doctor
./herdrex workspace list
./herdrex pane list
./herdrex api snapshotDefault socket: ~/.config/herdrex/herdr.sock.
Real herdr is left alone. This binary is named herdrex on purpose.