Introduction
Flock is a Rust coordination runtime where agents wake from a decaying pressure field, verify work through typed harness recursion (RAH), and improve topology from episode logs.
This book is the curated entry point for operators and contributors. Canonical long-form design docs live in the repository docs/ tree.
What makes Flock different
| Dimension | Typical harness (Claude Code, OpenCode) | Flock |
|---|---|---|
| Coordination | Scripts / chat / manager | Stigmergic pressure field + scheduler |
| Topology | Fixed | Evolved from .flock/episodes/ |
| Recursion | API subagents | RAH verified depth in multiplexer panes |
| Execution | Vendor PTY | In-tree flock-multiplexer + flock dashboard |
Flock is not a meta-harness wrapper or workflow DSL. Default flock run uses deterministic plugins (gridworld, shell) — wire your LLM via MCP, ACP, or remote panes.
Episode flywheel
flock run → .flock/episodes/*.json → flock evolve → flock drift-check
- Run — scheduler-led goal loop (
flock run) or RLM verify/act (flock run --rlm) - Log — reproducible episode JSON with optional pane topology
- Evolve — topology mutations from episode corpus
- Gate —
flock drift-checkmanifest guardrails
Quick paths
- Quickstart — clone to first episode in 2 minutes
- Daily driver — multiplexer → dashboard → run → verify
- Dashboard — ratatui control tower
- CLI reference — full command surface
Build this book locally
cargo install mdbook
mdbook build book
mdbook serve book # http://localhost:3000
Or run ./scripts/smoke-docs.sh (included in ./scripts/verify.sh).
Live site: deploy via .github/workflows/docs.yml (Cloudflare Pages flock-docs).