Skip to content

Documentation

Everything you need to run your coding agents in formation. Current release: v0.7.44, macOS 12+ on Apple Silicon.

Start here

Install Download the DMG, drag flock into Applications, and point it at an agent CLI. Signed and notarized, macOS 12+ on Apple Silicon. Your flock ID Sign in, claim a handle, and manage your account. Your handle is how friends add you and how your presence travels. Quickstart The full setup walkthrough: your first workspace, a branch per agent, secure mode, shared memory, GitHub, and the habits that make a formation productive.

Work in formation

Workspaces Workspaces, tabs, and split panes. Tile as many live agent terminals as the work demands, with a git worktree per agent so they never clash. Secure Mode Secure Mode runs every agent in a workspace inside a Docker container that sees only your repo. No keys, no credentials, no host files, so full permissions stay safe. Pop-out windows Pull any agent pane into its own window and spread your formation across monitors. Collaboration Add friends by handle, watch their agent session live and read-only, hand a prompt into their agent, or co-drive one workspace from two chairs. PR review Watch GitHub repos, get told when a pull request opens, have an agent review the diff in a fresh worktree, and land approved work through an ordered merge queue.

Everyday tools

Keyboard shortcuts Every shortcut in flock: split panes, new tabs, zoom, close, and move between agents without touching the mouse. Voice Hold right option and talk. Your words land in the focused pane as typed input, transcribed on your own machine. Usage Live usage and spend across every agent CLI you run, in one gauge. Know your burn before the bill does. The Graph A local-first knowledge graph of decisions, attempts, and file claims that every agent reads before it writes. Postgres in Docker, MCP-native, on your machine.

Help & updates

macOS permissions Which macOS permissions flock asks for, why each one is needed, and how to grant them. Troubleshooting Fixes for the problems people actually hit: Gatekeeper, Docker not running, agents not spawning, and updates that will not apply. Changelog Every flock release, with the real notes. Shipped continuously since v0.2.0.