sandboxxer

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:

• 🔒 Docker Sandbox Explained - Simple visual showing what sandboxes can and cannot do
• 🛡️ Bubblewrap Explained - Comparison: Docker (maximum security) vs Bubblewrap (lightweight)

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

• What is Sandboxing?
• Important: Experimental Status
• Features
• Prerequisites
• Quick Start
• Setup Options
• Slash Commands
• Auto-Detection
• Security Features
• Troubleshooting Features
• Cloud Deployment
• Files Generated
• Configuration Placeholders
• Command Reference
• Reference Documentation
• Development
• Example Applications
• Contributing
• Changelog

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