Sandboxxer Plugin
Repository: andrewcchoi/sandbox-maxxing
Plugin Name: sandboxxer (used in commands: /sandboxxer:quickstart, /sandboxxer:yolo-docker-maxxing)
Interactive assistant for creating VS Code DevContainer configurations with Docker Compose support. Choose between interactive setup with project type selection and firewall customization, or quick one-command setup with defaults.
What is Sandboxing?
New to sandboxing? A sandbox is a secure, isolated environment where code runs safely without accessing your personal files, passwords, or system settings. Think of it like a protective bubble - code can run inside, but can't escape to harm your computer.
Visual guides for beginners:
This plugin helps you set up sandboxed development environments using either Docker containers (full isolation with firewall) or bubblewrap (lightweight native Linux sandboxing).
Important: Experimental Status
This plugin is experimental and provided as-is. Most features have received minimal to no testing. Generated configurations may not work correctly on the first try and may require several iterations to get working.
Testing levels:
/sandboxxer:yolo-docker-maxxing - Moderate testing (most reliable)/sandboxxer:quickstart - Very minimal testing- Firewall features - No testing (highly experimental)
- Azure deployment - No testing (highly experimental)
- Agents and skills - Not tested
If you encounter issues, expect to iterate on the generated configuration files.
Features
- 🚀 Two-Path Setup System - Interactive quickstart with project type selection, or non-interactive YOLO docker maxxing for instant defaults (Python+Node+AWS CLI, container isolation)
- 🐧 Native Linux Support - Run Claude Code directly on Linux/WSL2 without Docker overhead
- ☁️ Azure Cloud Deployment - Deploy DevContainers to Azure Container Apps for cloud-based development environments
- 📊 Data-Driven Templates - Configurations generated from curated registries of official Docker images and allowable domains
- 🔧 Troubleshooting Assistant - Diagnose and fix common sandbox issues automatically
- 🔒 Security Auditor - Review and harden sandbox configurations against best practices
- 🛡️ Smart Firewall Management - Optional domain allowlist with 30-100+ curated domains
- 🎯 Intelligent Detection - Auto-detects project type and suggests appropriate setup
Plugin component overview - see docs/diagrams/ for detailed diagrams
Table of Contents
Prerequisites
Before using this plugin, ensure you have:
- Anthropic Account with Claude Code access (Pro/Team subscription or API key)
- Docker Desktop (v4.0+) or Docker Engine with Compose v2
- VS Code with Dev Containers extension (
ms-vscode-remote.remote-containers)
- Claude Code CLI installed (installation guide)
- Git for version control
Platform-specific:
- Windows: WSL 2 required; clone repos to WSL filesystem (
~/projects/)
- macOS/Linux: Native Docker support
Quick Start
Installation
# Install the plugin
claude plugins add https://github.com/andrewcchoi/sandbox-maxxing
# Verify installation
claude plugins list
Basic Usage
andrewcchoi
