Codex Sandboxes

Create one directory per task and run the agent inside that directory. Prefer this over git worktrees when:

• Codex or other agents sometimes use the wrong current working directory.
• You want full isolation for .env, node_modules, build outputs, ports, and dev servers.
• You want a simple mental model: one task equals one folder equals one branch.

This skill bundles a small Python CLI plus a Bash wrapper:

• scripts/codex_sandbox.py (primary)
• scripts/codex-task (convenience)

Locate the skill directory

Run the scripts from the skill folder, depending on where you installed it:

• Repo-scoped: $REPO_ROOT/.codex/skills/codex-sandboxes
• User-scoped: $CODEX_HOME/skills/codex-sandboxes (macOS/Linux default: ~/.codex/skills/codex-sandboxes)