whatisgithub

What is pipod?

perk11/pipod — explained in plain English

Analysis updated 2026-05-18

3ShellAudience · developerComplexity · 3/5Setup · moderate

In one sentence

A shell script that runs coding agents like Claude Code or Codex inside isolated, per-project Docker containers.

Mindmap

mindmap
  root((repo))
    What it does
      Runs agents in Docker
      Isolates per workspace
      Optional network isolation
    Tech stack
      Shell script
      Docker
      Bash
    Use cases
      Sandbox Claude Code
      Sandbox pi agent
      Sandbox Codex CLI
    Audience
      Developers
      Claude Code users
    Setup
      Install Docker
      Add shell alias
      Per agent config folders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run Claude Code, Codex, or the pi agent in an isolated Docker container per project.

USE CASE 2

Prevent an AI coding agent from making unrestricted changes to your host machine.

USE CASE 3

Keep shared agent configuration while isolating per-project session data.

USE CASE 4

Disable internet access for an agent's container while still reaching local services.

What is it built with?

ShellDockerBash

How does it compare?

perk11/pipodbechsteindigital/claude-shiploophamen/ship-feature
Stars333
LanguageShellShellShell
Setup difficultymoderatemoderatemoderate
Complexity3/54/53/5
Audiencedevelopervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Docker installed and a shell alias added before first use.

No license information is stated in the README.

So what is it?

Pipod is a script that runs AI coding agents like the pi coding agent, Claude Code, or OpenAI Codex CLI inside an isolated Docker container instead of directly on your computer. Each project directory gets its own persistent container, and the current directory is automatically shared into that container as a workspace folder. You can optionally turn off internet access for extra isolation, while still allowing the agent to reach services running on your own machine. The main point of running an agent this way is safety. If a coding agent is allowed to run shell commands or edit files, doing that inside a container limits the damage it can cause to the rest of your computer, compared to tools that only try to filter which commands are allowed or blocked. The README is honest that this is not a perfect sandbox, since the agent could still change files inside the mounted project folder or attempt to escape the container, but it describes this as a much stronger approach than command filtering alone. Getting started involves installing Docker, cloning the repository, and adding a shell alias pointing to the pipod script. From inside a project folder, running the pipod command launches the pi coding agent in its container. Passing claude or codex as an argument instead runs Claude Code or the Codex CLI in their own separate containers and Docker images, so installed packages for each agent do not mix. Extra flags let you drop into a plain shell inside the container to install project dependencies, force an isolated network with no outside access, or recreate the container from scratch. Configuration for each agent, such as Claude Code's settings and login credentials, is shared across all your projects by default, while session data and history for each individual project stay separate so different workspaces do not overwrite each other's work. The first time you log in to an agent inside a container, your existing host credentials are reused automatically where possible, or you can log in interactively once and it will persist for future sessions. The README includes detailed tables showing exactly which folders on your computer map to which paths inside each agent's container.

Copy-paste prompts

Prompt 1
Walk me through installing pipod and setting up the bash alias for it.
Prompt 2
Explain how pipod isolates per-workspace session data from shared agent config.
Prompt 3
Show me the pipod commands for running Claude Code with an isolated network.
Prompt 4
Help me understand which host folders map to which container paths for Codex in pipod.

Frequently asked questions

What is pipod?

A shell script that runs coding agents like Claude Code or Codex inside isolated, per-project Docker containers.

What language is pipod written in?

Mainly Shell. The stack also includes Shell, Docker, Bash.

What license does pipod use?

No license information is stated in the README.

How hard is pipod to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is pipod for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.