name: "devbox"
description: "One-command Docker dev environment for any project. Auto-detects 20+ types (Nuxt/Next/Vite/Python/Go/Rust/Java/Ruby/PHP/C#/Swift/Hugo), matches local language versions to Docker images, manages port conflicts, and attaches database services. All generated files (deps/cache/build artifacts) use named volumes for full host↔container isolation. Use when: setting up containerized dev environments, running projects in isolated Docker containers, or needing database dependencies."
metadata: {"clawdbot":{"emoji":"🧊","requires":{"bins":["docker"]},"os":["linux","darwin"],"files":["scripts/","references/"]}}

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:

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)

Volume 隔离策略

All generated files use named volumes, never bind-mounted to the host:

• Source code → bind mount (read/write from host)
• Dependencies → named volume (node_modules, pip, m2, gems, etc.)
• Build caches → named volume (.nuxt, .next, go-build, cargo-target, etc.)
• Package manager stores → named volume (pnpm-store, composer, nuget, etc.)

Benefits: no host/container cache collisions, native speed on macOS, cache survives container rebuilds.

Usage

After installing this skill, run the bundled script directly:

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

| Type | Detection | Default Port | Docker Image |
|------|-----------|-------------|--------------|
| Nuxt 3/4 | nuxt.config.* | 3000 | node:{ver}-bookworm |
| Next.js | next.config.* | 3000 | node:{ver}-bookworm |
| Vue + Vite | vite.config.* + vue | 5173 | node:{ver}-bookworm |
| React + Vite | vite.config.* + react | 5173 | node:{ver}-bookworm |
| Svelte | svelte.config.* | 5173 | node:{ver}-bookworm |
| VitePress | docs/.vitepress/ | 5173 | node:{ver}-bookworm |
| Node.js backend | package.json | 3000 | node:{ver}-bookworm |
| Python FastAPI | requirements.txt + fastapi | 8000 | python:{ver}-slim |
| Python Django | manage.py | 8000 | python:{ver}-slim |
| Python Flask | requirements.txt + flask | 5000 | python:{ver}-slim |
| Go | go.mod | 8080 | golang:{ver} |
| Rust | Cargo.toml | 8080 | rust:{ver} |
| Java (Spring Boot) | pom.xml + spring-boot | 8080 | eclipse-temurin:{ver}-jdk |
| Java (Maven) | pom.xml | 8080 | eclipse-temurin:{ver}-jdk |
| Java (Gradle) | build.gradle / .kts | 8080 | eclipse-temurin:{ver}-jdk |
| Kotlin | *.kt (no build.gradle) | 8080 | eclipse-temurin:21-jdk |
| Ruby on Rails | Gemfile + rails | 3000 | ruby:{ver}-slim |
| Ruby Sinatra | Gemfile | 4567 | ruby:{ver}-slim |
| PHP Laravel | composer.json + laravel | 5000 | php:{ver}-cli |
| PHP | composer.json | 8000 | php:{ver}-cli |
| C# / .NET | *.csproj / *.sln | 5000 | dotnet/sdk:{ver} |
| Swift | Package.swift | 8080 | swift:{ver} |
| Hugo | hugo.toml | 1313 | klakegg/hugo:ext-alpine |
| Static HTML | *.html | 80 | nginx:alpine |

Attach Database Services

devbox ./app --with postgres,redis

| Service | Image | Port |
|---------|-------|------|
| postgres / pg | postgres:16-alpine | 5432 |
| mysql | mysql:8-alpine | 3306 |
| redis | redis:7-alpine | 6379 |
| mongo | mongo:7 | 27017 |
| minio | minio/minio | 9000/9001 |

CLI Options

devbox <project-path> [port] [options]

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

Volume 隔离速查表

| 项目类型 | 命名卷 |
|---------|--------|
| Nuxt | nm, pnpm-store, nuxt, nuxt-output |
| Next.js | nm, next |
| Vue/React/Vite/Svelte | nm, pnpm-store |
| Python | pip |
| Go | go-mod, go-cache |
| Rust | cargo-registry, cargo-git, cargo-target |
| Java Maven | m2 |
| Java Gradle | gradle |
| Ruby | gems |
| PHP | composer |
| .NET | nuget |
| Swift | swift |

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 with volume isolation

Dependencies

Required:

• docker + docker compose — the only hard requirement

Optional (for version detection):

• node, python3, go, rustc, java, ruby, php, dotnet, swift
• pnpm / yarn / bun — Node.js package manager detection

Optional (for port conflict detection):

• lsof — Detects host processes using a port

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