# docker-sandbox

docker-sandbox runs Claude and Codex agent loops inside isolated Docker containers. Keeps subprocesses separated from your host machine and protects credentials.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 103 installs · ★ 68 repo stars
- Author: Joel Hooks
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/joelhooks/joelclaw/tree/HEAD/skills/docker-sandbox/SKILL.md
- Updated: 2026-10-20
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/docker-sandbox

## What it does

This skill routes execution based on the workload type. It points workshop and demo environments toward `sandbox-computer`, while background execution jobs use `workflow-rig` with a dedicated adapter.

Isolation is treated as a hard requirement. If Docker is unavailable, the skill refuses to silently fall back to running commands on your host. Credentials stay confined to persistent auth volumes, which blocks tokens from slipping into container layers or terminal arguments.

Container lifecycle is tightly tracked. The skill publishes only requested network ports and removes the containers it started once the task is finished.

## Requirements
- Works with: Docker

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add joelhooks/joelclaw --skill docker-sandbox -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/docker-sandbox/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/docker-sandbox/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add joelhooks/joelclaw --skill docker-sandbox -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/docker-sandbox/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add joelhooks/joelclaw --skill docker-sandbox -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/docker-sandbox/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install joelhooks/joelclaw skills/docker-sandbox
```

2. **Manually: put the files in place**
- File: `.github/skills/docker-sandbox/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add joelhooks/joelclaw --skill docker-sandbox -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/joelhooks/joelclaw --path skills/docker-sandbox
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/docker-sandbox/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add joelhooks/joelclaw --skill docker-sandbox -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/joelhooks/joelclaw/tree/HEAD/skills/docker-sandbox/SKILL.md

## When to use it
- isolate agent tool subprocesses from the local host system
- prevent auth credentials from leaking into Docker images or command logs
- spin up isolated sandboxes for workshop exercises and code demos
- clean up finished containers and mapped ports after agent execution

## Example prompts
- Run this agent loop inside a Docker sandbox to keep the host clean
- Set up an isolated demo workspace for the workshop
- Check Docker availability and execute this task in a container sandbox

## Similar
- [sandbox-guard](https://affpapa.org/en/nevibecode/skills/sandbox-guard.md) — skill · 484 installs
- [docker-sandboxes-network-credentials](https://affpapa.org/en/nevibecode/skills/docker-sandboxes-network-credentials.md) — skill · 1100 installs
- [docker-sandboxes-lifecycle](https://affpapa.org/en/nevibecode/skills/docker-sandboxes-lifecycle.md) — skill · 1100 installs
- [setup-auditor](https://affpapa.org/en/nevibecode/skills/setup-auditor.md) — skill · 471 installs
- [docker-expert](https://affpapa.org/en/nevibecode/skills/sickn33-docker-expert.md) — skill · 27500 installs
- [docker-patterns](https://affpapa.org/en/nevibecode/skills/docker-patterns.md) — skill · 8600 installs

From the same set: [joelhooks/joelclaw](https://affpapa.org/en/nevibecode/by/joelhooks/joelclaw.md) — 4 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
