Introduction

Flock

Self-evolving agent coordination runtime — the harness is the flock.

Rust MIT CI verified

Install

curl -fsSL https://raw.githubusercontent.com/Alphabetsoup16/Flock/main/install.sh | bash

Quickstart · Daily driver · Agent guide · Socket API · MCP tools

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.

What makes Flock different

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. See What Flock is / is not.

Episode flywheel

flowchart LR
    RUN[flock run] --> LOG[.flock/episodes]
    LOG --> EVOLVE[flock evolve]
    EVOLVE --> GATE[flock drift-check]
    GATE --> RUN

    class RUN runtime
    class LOG runtime
    class EVOLVE evolve
    class GATE gate

1. Run — scheduler-led goal loop (flock run) or RLM verify/act (flock run --rlm)
2. Log — reproducible episode JSON with optional pane topology
3. Evolve — topology mutations from episode corpus
4. Gate — flock drift-check manifest guardrails

First success in one command after install:

flock run --goal "reach target" --plugin gridworld

Episode JSON lands in .flock/episodes/. Full walkthrough: Quickstart.

Quick paths

Build this book locally

cargo install mdbook mdbook-mermaid
mdbook-mermaid install book
mdbook build book
mdbook serve book   # http://localhost:3000

Or run ./scripts/smoke-docs.sh (included in ./scripts/verify.sh).

Live site: flock-docs.pages.dev — deploy via .github/workflows/docs.yml.

For LLM agents: llms.txt.