PersonalPython

boxctl

AI coding agents in Docker containers with auto-approve, parallel worktrees and desktop notifications.

dockerai-agentscliclaude-code

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).