Get the source

Corotation is MIT licensed and built from source. This site includes a source archive generated from the same project as these docs. It contains the Rust implementation, tests, CLI helpers, and website sources.

Download v{{version}} source ↗ SHA-256 checksum

If you already have the project checked out, skip extracting the archive and open a terminal in that project folder.

tar -xzf corotation-{{version}}-source.tar.gz
cd corotation-{{version}}

Prerequisites

• Rust and Cargo. This implementation is tested with Rust 1.93.
• A working native C compiler for the bundled SQLite dependency. On macOS, install the Xcode Command Line Tools if you do not already have them.
• Optional: Just, which runs the project’s build and test recipes.

Build and install

From the source folder, build the optimized executable and start its installer:

just release
./target/release/cor install

Or build directly with Cargo:

env RUSTC_WRAPPER= cargo build --release --locked
./target/release/cor install

The installer copies this build into ~/.local/bin, offers to configure your shell’s PATH, and offers conflict helper skills for Codex and Claude. It preserves customized skills when you reinstall.

Follow the printed PATH command for your current terminal, or open a new terminal after accepting shell configuration. Verify the installation:

cor --version
cor --help

You should see version {{version}} and commands including current, work, remote, and conflicts.

Choose install options

cor install --skills both --project

cor install --skills none --no-modify-path

Choose a different binary directory with --bin-dir PATH. For an unattended install, use --yes --no-modify-path and manage your own PATH. The full option list is in the installer reference.

Upgrading

Stop your workers and current, and back up current’s entire data directory before upgrading. Build the new source, then run its installer to replace the existing executable. Use --force to explicitly replace a different installed binary without a prompt.

This early implementation has no compatibility or migration guarantee for future disk and wire formats. Use the same build on your current node and clients.

Upgrading from Laplace

Corotation is the new name for Laplace. Build this release and install cor, then use cor work and the other commands shown here. Existing laplace.json files are still discovered and updated in place. New projects use corotation.json; it takes priority if both files exist.

The rename preserves existing disk and wire formats. Private state in .laplace/, saved SSH identities, .laplaceignore, conflicts.laplace.json, checks.laplace.json, laplace.jobs.toml, and LAPLACE_* script variables keep their names. Keep these paths and your remote URLs as they are. Server service identities and storage paths also remain compatible.