git404hub

what is pipod fr?

perk11/pipod — explained in plain English

Analysis updated 2026-05-18

3ShellAudience · developerComplexity · 3/5Setup · moderate

tl;dr

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

vibe map

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 make with this?

VIBE 1

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

VIBE 2

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

VIBE 3

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

VIBE 4

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

what's the stack?

ShellDockerBash

how it stacks up fr

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 i run it?

Difficulty · moderate time til it works · 30min

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

No license information is stated in the README.

in plain english

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.

prompts (copy fr)

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 fr?

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.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.