Agro

🏗️ AGRO

Agent Governance Runtime Orchestrator

AGRO gives AI coding agents a workspace you control. It packages a Docker sandbox and shared agent procedures. Run one or more coding harnesses side by side in one workspace, for example Claude Code, Codex, and Pi. AGRO supports every harness in the harness table below.

Develop on your laptop or a remote VM. Install tools and harnesses on demand, organize parallel changes in separate git worktrees, and use shared skills and evidence checks to guide the work.

Start with the quickstart below. See the documentation for more guidance.

📦 Quickstart

Try AGRO in GitHub Codespaces

AGRO runs one project in one Docker sandbox, and agro is the only
front door. Host prerequisites: Docker (with the Compose plugin), Git, and
Node.js ≥ 22.

1. Get agro

npm — you already have Node ≥ 22:

Use npx @mifune/agro in place of agro in later commands.

curl

For a download-and-review alternative, see Installation.

Check the installed version, update AGRO, or see available commands:

2. Create the sandbox

agro sandbox install docker runs from any directory and needs no project
checkout.

Set up the sandbox, then enter it. For checkout and persistent home options, see Create the sandbox.

--checkout and --home-mount bind different paths, so one command can carry
both.

--repo is a deprecated alias for --checkout.

3. Install tools

Inside the sandbox, start with Herdr, the terminal
workspace for your agents and development tools:

Run the remaining commands in a Herdr pane. Install only the tools you need:

GitHub (optional): authenticate before repository work that uses GitHub.
Confirm that the status output shows your intended account.

See GitHub authentication for help.

4. Install a coding harness

Choose one harness to start. In a…