Run AI coding agents (Claude Code, Codex, Gemini, Aider) inside isolated Docker containers. Only the folders you choose are mounted — host secrets, env vars, and config files are never exposed.
git clone https://github.com/jalet/powercode
cd powercode
make build
sudo mv bin/powercode /usr/local/bin/Prerequisites: Go 1.23+, Docker Engine with buildx.
cd ~/myproject
powercode init
export ANTHROPIC_API_KEY=sk-ant-...
powercode run| Provider | Command | Runtime | API key env |
|---|---|---|---|
| claude | claude | Node.js | ANTHROPIC_API_KEY |
| codex | codex | Node.js | OPENAI_API_KEY |
| gemini | gemini | Node.js | GEMINI_API_KEY |
| aider | aider | Python | OPENAI_API_KEY |
| Command | Description |
|---|---|
powercode run |
Launch an agent container |
powercode build |
Build the provider Docker image |
powercode init |
Create powercode.toml in current dir |
powercode completion [bash|zsh|fish] |
Generate shell completion scripts |
powercode ps |
List running containers |
powercode stop <name> |
Stop a container |
powercode shell <name> |
Open a bash shell in a container |
powercode update <name> |
Update the provider package |
- Getting started — step-by-step from install to your first session
- Configure a project —
powercode.tomlreference and config precedence - Shell completions — enable bash, zsh, or fish completions
- Switch providers — use Codex, Gemini, or Aider instead of Claude
- Use AWS Bedrock — run agents against AWS Bedrock instead of the Anthropic API
- Manage the firewall — whitelist extra domains or disable the firewall
- Persistent data — where config and history are stored
- Contributing — build, test, and add a new provider
MIT — see LICENSE