Documentation

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

Install Download the DMG, drag Clarence into Applications, and point it at an agent CLI. Signed and notarized, macOS 12+ on Apple Silicon. Your Clarence ID Sign in, claim a handle, and manage your account. Your handle is how friends add you and how your presence travels. Quickstart Create a workspace, point it at a repo, pick an agent, and put several agents to work in one window. Workspaces persist across restarts. The Cockpit 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. The Cage (secure mode) The Cage 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. Keyboard shortcuts Every shortcut in the Clarence cockpit: split panes, new tabs, zoom, close, and move between agents without touching the mouse. 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. Voice Hold right option and talk. Your words land in the focused pane as typed input, transcribed on your own machine. Fuel gauge (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. macOS permissions Which macOS permissions Clarence 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 Clarence release, with the real notes. Shipped continuously since v0.2.0.