Run Claude Code, Codex, or Google Antigravity CLI in a disposable Podman
container or Lima VM. Your project is mounted at /app; credentials, agent
history, shell history, and caches persist under ~/ai.
Agents run with permission prompts disabled inside the sandbox. Language runtimes, databases, and development tools are included. Optional host bridges provide browser control, GitHub operations, and approved 1Password reads.
- Containers: Podman,
curl,jq, and Ruby or Python 3 on the host. On macOS, install withbrew install podman jqand initialize the Podman machine withbin/setup-vmfrom this checkout. - Linux VMs: Lima and
jq; build a base with./build_vm. - macOS VMs: Apple Silicon, Lima 2.1+, and full Xcode; build with
./build_vm --macos. This backend is experimental.
See building and updating for full requirements and options.
Clone the repository and put its commands on your path:
git clone https://github.com/dentarg/ai.git
cd ai
export PATH="$PWD/bin:$PATH"With Podman running, download the public image and authenticate a profile:
podman pull ghcr.io/dentarg/ai:latest
podman tag ghcr.io/dentarg/ai:latest ai:latest
ai profile create work
ai profile login work claudeLaunch from the project you want the agent to work on:
cd /path/to/project
ai c workFor Codex, use ai profile login work codex and ai cx work. Antigravity
uses ai g work and authenticates on first launch. Exit the shell to remove
the disposable environment; --keep-vm retains a VM for inspection.
| Command | Purpose |
|---|---|
ai |
Open a sandbox shell |
ai c work / ai cx work / ai g work |
Launch an agent with a profile |
ai cx --resume <id> |
Resume a saved session |
ai cx --resume <id> --fork |
Fork a saved conversation |
ai c work --ports 3000 |
Expose an application port |
ai c work --vm |
Use a Linux VM |
ai c work --macos |
Use a macOS VM |
ai --help |
Show all launcher options |
Inside the sandbox, s starts services, c / cx / g launches an agent,
and x exits. Repeat the image pull and tag commands to update, or build
locally with ./build_image from this checkout.
Guide examples use paths relative to the repository root.
| Topic | Guides |
|---|---|
| Everyday use | Usage, profiles and configuration, agent features and plugins |
| Environments | Building and updating, virtual machines, Claude cloud setup, installed tools and services |
| Local inference | Models, GPU VMs, and native macOS inference |
| Host integrations | Browser, 1Password, GitHub |
| History and collaboration | Shared terminals, history viewer |
| Diagnostics | Troubleshooting |