Get started

Read three pages in order.

Install

Install from a source checkout with uv, a released macOS archive, or a wheel. This page lists the external tools that the factory expects on PATH.

First offline run

Run one work item through the pipeline with the deterministic fake runtime. This step needs no network access and has no cost.

Real Copilot runs

Switch to --runtime copilot. Learn what it spends, what it can touch, and how it fails.

When a run finishes, continue to Configure a repository. Configure the real lint, test, and build commands for your project.