Daily driver loop
The recommended local workflow for developing and operating Flock.
Loop
flock multiplexer ensure → flock dashboard → flock run → flock evolve → ./scripts/verify.sh
- Multiplexer —
flock multiplexer ensurestarts the in-tree PTY server (~/.config/flock/flock.sock). - Dashboard —
flock dashboardopens the ratatui control tower (agents, pressure, pane tree). Writes~/.config/flock/statusline.jsonfor MCP observability. - Run —
flock run --goal "…" --plugin gridworld(scheduler) or--rlm(verify/act loop with mux pane topology). - Evolve —
flock evolve --episodes 16 --workspace .flock/episodesmutates topology from episode corpus. - Verify —
./scripts/verify.shbefore every PR (fmt, clippy, hack, tests, smoke benches, dashboard + socket e2e).
Headless CI parity
CI runs the same smoke surface without a TTY:
cargo test -p flock-dashboard --test integration
cargo test -p flock-multiplexer --test socket_integration
flock run --goal "reach target" --plugin gridworld --rlm
Remote / SSH
flock remote --goal "reach target" --plugin gridworld
flock herd attach --session my-work