Cursor setup

Use Flock in Cursor via MCP (flock mcp). ACP is available for experiments but MCP is the primary editor path.

Install

git clone https://github.com/Alphabetsoup16/Flock.git && cd Flock
./install.sh
export PATH="$PWD/target/release:$PATH"

Wire MCP in Cursor

Add a server entry to Cursor MCP config (Settings → MCP, or ~/.cursor/mcp.json):

{
  "mcpServers": {
    "flock": {
      "command": "/path/to/Flock/target/release/flock",
      "args": ["mcp"]
    }
  }
}

Set command to your built target/release/flock path. Restart Cursor.

Discovery flow: flock_search_tools → flock_describe_tool → invoke. Full catalog: MCP tools.

First smoke

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

MCP vs ACP

Path	Cursor use
`flock mcp`	Primary — tool discovery, substrate read/write
`flock acp`	Experimental — in-process prompt bridge only

Skills and memory

Skills: .flock/skills/ and ~/.cursor/skills/ are both scanned on flock run.

Memory is the substrate (blackboard, field, episodes) — see Memory architecture. Vector RAG is deferred; hybrid SQLite/Turso plan is documented in-repo under docs/MEMORY_ARCHITECTURE.md (not yet migrated to this book).

Agent onboarding

For paste-into-agent context: Agent guide.

Keyboard shortcuts