md

Branch-locked development containers for AI coding agents. Each container is locked to a repository-branch pair. Safe parallel work, no conflicts.

The problem

AI coding agents work best in YOLO mode (full command execution). But running them locally creates:

• Branch conflicts — agent changes interfere with your local checkout
• Test conflicts — simultaneous test runs cause failures and race conditions
• Environment pollution — accumulated dependencies cause hidden bugs
• Context switching — switching branches while an agent works loses progress

Platform support

md is supported on Linux, macOS, and Windows via WSL2.

The solution

md gives each agent a complete, isolated container with a full git clone:

• Run agents on multiple branches simultaneously
• Switch local branches without affecting running agents
• Run tests in parallel without conflicts
• Keep your local checkout clean
• Delete containers cleanly when done

Quick start

# Start container for your current branch (auto-SSH in)
git checkout -b wip origin/main
md start

# Inside the container — run your agent
cd ~/src/<repo-name>
claude

# Back on host — check changes and sync
md diff
md pull

Install

curl -fsSL https://caic.xyz/install.sh | bash

See Installation for all options, Commands for the full command reference, Configuration for caches and environment variables, and Harnesses for agent-specific setup.