Installation

CoCo runs on Linux and macOS and uses your existing Codex login and configuration. CoCo is tested with Codex 0.160.1.

You need Git and a configured codex command on your PATH.

Install with Cargo

With Rust 1.98.1 or newer, install the published package:

cargo install --locked codex-coordinator

The package installs coco, cocod, and coco-mcp, normally into ~/.cargo/bin. Make sure that directory is on your PATH.

Use release binaries

Download an archive for your platform from GitHub Releases. Extract it and place coco, cocod, and coco-mcp in a directory on your PATH. Each archive has a matching SHA-256 checksum file.

Install with Nix

Install the current repository version with flakes enabled:

nix profile add github:janthmueller/coco

This provides the same three commands and supplies the build toolchain.

Install a development version

For the latest development version directly from Git:

cargo install --locked --git https://github.com/janthmueller/coco codex-coordinator

Or build from your own checkout:

git clone https://github.com/janthmueller/coco.git
cd coco
cargo install --path . --locked

With Nix, you can use nix develop -c cargo install --path . --locked for the final command.

These docs follow the repository version; newly added commands may appear here before the next published release.

Start CoCo

Check your installation:

coco --version
codex --version

Start the coordinator in its own terminal:

cocod

Leave it running while using CoCo. It keeps agent work running when you leave a CLI command or the Codex UI. Installation currently leaves background-service setup to you.

Stopping cocod interrupts active turns. Saved conversations, workspaces, and files remain available when you start it again.

Continue with the quickstart. If startup fails, use Troubleshooting.