clodpod

# ClodPod - Run AI agents in a macOS VM sandbox

<img src="https://www.codeofhonor.com/images/projects/clodpod.webp" align="left" width="200px"/>
ClodPod creates a macOS virtual machine sandbox configured to run applications like Claude Code, Open AI Codex, Google Cursor, and Cursor Agent. It facilitates disabling AI permission prompts so you can get work done without risking your entire computer.
</br>
</br>
ClodPod maps any number of your project directories into the virtual machine so AI agents can work on your code while remaining isolated from your host computer.
</br>
</br>
ClodPod virtual machines include Xcode and common development tools, and it's easy to extend to add your own development tools and configuration files.

</br>
</br>

---

# Key features

- Builds a virtual machine and launches AI agents with access to your projects
- Enables mapping multiple projects in the same virtual machine simultaneously
- Open multiple AI agents sessions and shell prompts, or use the GUI
- Headless mode for CI/CD workflows with `--no-graphics`
- Includes Xcode and common development tools; you can add your own tools too
- Fast rebuild and relaunch using a three-layer APFS CoW caching system
- Named VM instances for switching between projects or worktree branches
- Parallel VM execution with configurable memory budget


Usage:

    # Clone clodpod
    git clone https://github.com/webcoyote/clodpod ~/projects/clodpod

    # Create an alias for clod or add it to your path
    alias clod="$HOME/projects/clodpod/clod"
    # - or -
    alias clod="$HOME/projects/clodpod/clod --no-graphics"
    # - or -
    PATH="$PATH:"$HOME/projects/clodpod"

    # Note: for the first run you'll want to start in the project directory,
    # which will get remembered. Use add/remove for changing projects.
    cd "YOUR PROJECT DIRECTORY"

    # Run Claude Code
    clod cursor
    # also clod cl"

    # Run OpenAI Codex
    clod codex
    # also "clod co"

    # Run Google Cursor
    clod gem