Home

aicage wiki

Run AI coding agents in Docker with a clean separation between your host and the agent runtime.

Start here

• How it works
• CLI options
• Docker run pass-through args
• Images and layers
• Customization entry point
• Update behavior
• How to debug

Network and proxy note

When your environment uses proxies, aicage forwards HTTP_PROXY, HTTPS_PROXY, ALL_PROXY, and NO_PROXY into local image builds and container runtime automatically.

Quick usage

• Prerequisites:
  • Docker
  • Python 3.10+ and pipx

pipx install aicage

cd /path/to/project

Use one of these commands:

aicage claude
aicage codex
aicage copilot
aicage crush
aicage droid
aicage gemini
aicage goose
aicage opencode
aicage qwen

aicage mounts your project and your agent config into a container that already has a full dev toolchain and the agent.

You can also add your own custom agents. See Customization.

Built-in agents

CLI	Agent	Homepage
claude	Claude Code	https://claude.com/product/claude-code
codex	Codex CLI	https://developers.openai.com/codex/cli
copilot	GitHub Copilot CLI	https://github.com/features/copilot/cli
crush	Crush	https://github.com/charmbracelet/crush
droid	Factory CLI	https://factory.ai/product/cli
gemini	Gemini CLI	https://geminicli.com
goose	Goose CLI	https://block.github.io/goose
opencode	OpenCode	https://opencode.ai
qwen	Qwen Code	https://qwenlm.github.io/qwen-code-docs