Devbox — One-Command Docker Dev Environment

Create isolated Docker dev environments for any project with a single command.

How It Works

The scripts/devbox.sh script is bundled with this skill. It:

1. Auto-detects your project type (framework, language, package manager)
2. Reads your local language version (Node, Python, Go, Rust, Java, etc.)
3. Generates a docker-compose.dev.yml with the matching Docker image
4. Optionally attaches database services (PostgreSQL, MySQL, Redis, MongoDB, MinIO)

Usage

After installing this skill, run the bundled script directly:

# Find where the skill is installed
SKILL_DIR=$(clawhub list --json 2>/dev/null | python3 -c "import sys,json; print([s['folder'] for s in json.load(sys.stdin) if s.get('slug')=='docker-devbox'][0])" 2>/dev/null || echo "skills/docker-devbox")

# Run devbox
bash "$SKILL_DIR/scripts/devbox.sh" /path/to/project

# Or copy to PATH for convenience
cp "$SKILL_DIR/scripts/devbox.sh" /usr/local/bin/devbox
chmod +x /usr/local/bin/devbox
devbox /path/to/project

Quick Start

# Auto-detect project type
devbox /path/to/project

# Specify port + attach databases
devbox /path/to/project 8000 --with postgres,redis

# Force framework
devbox /path/to/project --framework java-spring

Supported Project Types

Attach Database Services

devbox ./app --with postgres,redis

CLI Options

devbox \x3Cproject-path> [port] [options]

Options:
  --framework \x3Ctype>    Override auto-detection
  --with \x3Cservices>     Comma-separated services to attach
  --env-file \x3Cpath>     Environment variable file
  --use-dockerfile      Use project's existing Dockerfile
  -h, --help            Show help

Dependencies

Required:

• docker + docker compose — the only hard requirement

Optional (for version detection):

• node — Node.js version matching
• python3 — Python version matching
• go — Go version matching
• rustc — Rust version matching
• java — Java version matching
• ruby — Ruby version matching
• php — PHP version matching
• dotnet — .NET version matching
• swift — Swift version matching
• pnpm / yarn / bun — Node.js package manager detection

Optional (for port conflict detection):

• lsof — Detects host processes using a port (falls back to Docker-only check if missing)

Only the runtimes installed on your host are used. If a language is not installed, the script falls back to a sensible default version.

Included Files

scripts/devbox.sh          — Main script (auto-detect + generate compose)
scripts/create-dev-env.sh  — Backward-compatible wrapper
references/docker-templates.md — Ready-to-use compose templates

Docker Templates

See references/docker-templates.md for ready-to-use compose templates for each project type.