Multiplexer overview
Flock ships an in-tree PTY multiplexer with a HerdR-shaped NDJSON socket API. One binary (flock) serves daily-driver pane farms without an external herdr binary.
Architecture
flock herd server → flock-multiplexer (Unix socket)
│
├── pane.spawn / pane.attach (PTY proxy)
├── events.subscribe / events.wait
└── pane.report_agent (hook protocol)
Pane agent status feeds the pressure field: agent_status observations can deposit pheromones that boost scheduler wake on the herdr zone.
Quick start
flock herd server # background socket
flock swarm-demo # scheduler-led multi-pane demo
flock herd attach # interactive session
Attach modes
| Mode | Command | Use |
|---|---|---|
| Poll | flock herd status | Headless CI, scripts |
| Proxy | flock herd attach | Daily-driver TTY |