Agentic Sandbox

A Docker-based sandbox environment for running AI coding assistants in isolation. Supports Claude Code, OpenAI Codex, and Google Gemini CLI.

Features

• Multi-agent support - Run Claude, Codex, or Gemini in the same environment
• Isolated execution - Each agent runs in a Docker container
• Persistent state - Configurations and credentials persist between sessions
• Unified interface - Single command to launch any agent

Prerequisites

• Docker installed and running
• API keys for the AI services you want to use:
  • Anthropic API key for Claude Code
  • OpenAI API key for Codex
  • Google AI API key for Gemini CLI

Quick start

Build an image (only needed on first run):

make build

For Claude Code (default):

make compose

For Gemini CLI:

AGENT_TYPE=gemini make compose

For OpenAI Codex:

AGENT_TYPE=codex make compose

then

bin/agent-docker

When you're done, stop the container with:

make compose-down

For more information see the Advanced Usage guide.

License

BSD 3-Clause License - See LICENSE for details.