Skip to content

Harborist documentation

Harborist runs software engineering requests against a local Git repository. It captures the request, builds a candidate commit, runs your mandatory checks, and reviews that exact commit against the acceptance criteria. You decide when to apply a verified candidate locally or publish it to GitHub.

In the container deployment, the worker and browser workspace run in local Docker containers. With the Docker Sandboxes policy selected, the worker executes agent stages and mandatory checks in separate, fresh VMs on the Mac.

Follow Run Harborist with Docker to start the containers, select the sandbox policy, and inspect your first Run.

I want to… Read
Capture a request, inspect the result, or deliver a candidate Run and deliver changes
Configure a repository, Codex, or Docker Sandboxes Configure Harborist
Start, stop, or troubleshoot the local worker Operate the local service
Understand what Harborist verifies Workflow and verification
Locate evidence or recover from an interruption Storage and recovery
Look up a command or option CLI reference

For implementation details, see the architecture, developer reference, and contribution instructions. Release and planning records are available in the changelog and roadmap.