boxctl
AI coding agents in Docker containers with auto-approve, parallel worktrees and desktop notifications.
What it does
boxctl runs AI coding agents (Claude, Codex, Gemini, Qwen) inside Docker containers. The agent sees the project directory and explicitly mounted paths, nothing else. Git tracks every change, so a bad run ends with git reset --hard.
Key features
- Autonomous or interactive: agents run with auto-approve, or ask before each action
- Git worktrees: several agents on different branches in parallel
- agentctl: inside the container, agents switch worktrees, start parallel agents and detach via MCP
- Multi-agent review: agents ask each other for review and second opinions via MCP
- Desktop notifications: a host daemon reports finished tasks and stalled agents
- Ports, networks, devices: forward host ports, connect to other containers, pass through hardware
Tech stack
Python CLI (Python 3.12+, Poetry) on Docker, with a host daemon (boxctld) and a container-side CLI (agentctl).