nlesc/sandbox repository overview

⁠Enhanced Docker Sandbox Templates

Enhanced Docker Desktop Sandbox⁠ templates built on top of official docker/sandbox-templates images.

The base images already include common language runtimes (Python, Node.js, etc.) and development tools. These templates add on top of that:

• zsh + oh-my-zsh as default shell
• VS Code CLI for tunnel-based IDE access
• Extra tools: bat, autojump, vim, git-delta
• python aliased to python3

⁠Usage

1. Create a sandbox container from a template image:

   cd /path/to/your/repo
   # Use registry image
   docker sandbox create -t nlesc/sandbox:claude-code shell .
   

   Copy

2. Start an interactive shell in the sandbox container:

   docker sandbox exec -it -w $PWD <sandbox-name> zsh
   

   Copy

   Avoid using docker sandbox run ... shell as it always uses bash, ignoring the template's default shell.

   You can also directly start AI agent:

   docker sandbox exec -it -w $PWD <sandbox-name> claude-code
   

   Copy

   But it's recommended to start a shell first to set up the environment and then run the agent.

3. Start VS Code tunnel from the sandbox container:

   code tunnel --accept-server-license-terms
   

   Copy

   The first time you run this, it will prompt you to authenticate with GitHub.

   After the first time, you can start it in the background:

   code tunnel --accept-server-license-terms > /tmp/tunnel.log 2>&1 &
   

   Copy

4. Connect to the tunnel from VS Code on your machine:

   • Install the Remote - Tunnels extension
   • Cmd+Shift+P > Remote-Tunnels: Connect to Tunnel...
   • Sign in with the same GitHub account, pick the tunnel

   Now you can edit files in the sandbox container directly from VS Code on your machine!

When you make some custom setup for your dev env, you can save your sandbox state as a new template image (optional):

docker sandbox save <sandbox-name> <new-template-image>

⁠License

Apache License 2.0