What Flock is / is not
Flock is
- A coordination runtime — pressure-field scheduler, typed blackboard, episode logs
- A plugin harness boundary —
FlockPlugin::verify_goaldrives the defaultflock runloop - An in-tree multiplexer — HerdR-shaped NDJSON socket API + PTY panes
- A topology evolution loop —
flock evolvemutates wake maps from episodes - Governance-aware —
flock.tomlhooks, tool pipeline, drift-check manifest
Default flock run uses deterministic plugins (gridworld, shell). The scheduler wakes agents from substrate signals — not a manager LLM.
Flock is not
- An OpenCode / Claude Code / claw-code clone — no drop-in coding agent with dozens of providers on the hot path
- An OpenClaw wrapper — Flock does not host or wrap external harness binaries; it is the coordination runtime
- A meta-harness composition layer — unlike Omnigent-style wrappers, Flock does not orchestrate Claude Code + Codex as black boxes
- A workflow DSL — coordination is the pressure field, not hand-drawn graphs
- A chat router — agent-to-agent NL handoffs are intentionally forbidden
Honest scope: claw-code and OpenClaw optimize single-agent coding loops. Flock optimizes multi-agent coordination geometry — scheduler ticks, pheromone deposits, topology evolution, and multiplexer pane farms.
Comparison snapshot
| Need | Flock | claw-code / OpenClaw |
|---|---|---|
| Daily coding agent | Use flock acp or external editor + MCP | Primary product |
| Multi-pane agent farm | In-tree multiplexer + dashboard | External tmux scripts |
| Topology evolution | flock evolve + archive | Not in scope |
| Stigmergy / pressure field | Core scheduler | Not in scope |
| Provider matrix | Optional verify-path LLM only | Hot-path feature |
Honest adoption path
| Need | Use |
|---|---|
| Prove coordination thesis | flock run, swarm-demo, Govcraft bench in verify.sh |
| Editor integration | flock acp (stdio + prompt → engine) |
| External tool bridge | flock mcp or flock run --mcp |
| Remote pane farm | flock remote --plugin <name> with governance |
| Cursor / Claude daily driver | Pair Flock multiplexer with agent hooks |
Flock deliberately does not chase OpenCode/Claude Code/claw-code feature parity — coordination runtime and honest scope are the product.