Skip to content
visionikPublic

About

Herdr-shaped adapter that drives Rex — Herdr CLI/socket API for Rex sessions, windows, and terminal blocks

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

herdrex

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.

Status

0.17.0 — working against a live Rex server:

  • Inspect: ping, session.snapshot (enriched agents[] + layouts[]), workspace/tab/pane list/get/current
  • pane.get / pane.current include agent / agent_session when detected
  • pane.focus / agent.focus raise block + window + app session select; reply pane_info
  • Panes: split, send-text/keys/send-input, run, read (recent_unwrapped alias), 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 / remove via git + Rex sessions; emit worktree_* on event stream
  • Workspaces/tabs: create, focus, rename, close, move (insert_index; --close-group for 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.show via 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 a herdr shim → herdrex

Build

go build -o herdrex ./cmd/herdrex

Usage

# 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 snapshot

Default socket: ~/.config/herdrex/herdr.sock.

Real herdr is left alone. This binary is named herdrex on purpose.

About

Herdr-shaped adapter that drives Rex — Herdr CLI/socket API for Rex sessions, windows, and terminal blocks

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages