devboxes
بواسطة adshrc
Web & Frontend Developmentموجز
Manage development environment containers (devboxes) with web-accessible VSCode, VNC, and app routing via Traefik.
الوصف
ما الذي تفعله هذه المهارة
Devboxes are sandboxed containers that run VSCode Web, noVNC, Chromium CDP, and up to 5 routed app ports. The main agent assigns each container a sequential ID, spawns a devbox subagent, and runs devbox-init to configure routing and expose public URLs. Traefik or Cloudflare Tunnels handle routing to VSCode, noVNC, and app slots.
Combines browser-based VSCode, VNC desktop, Chromium CDP, and automatic public URL routing in one container, removing the need to manually configure reverse proxies or DNS per environment.
متى تستخدمها
- Spinning up an isolated browser-based coding environment for a new project
- Previewing a web app on a public URL without configuring local tunnels
- Cloning and developing inside a private GitHub repo in a sandboxed container
- Sharing a live dev environment URL with a teammate for real-time review
- Running multiple services on separate ports under a single container session
مثال على سير العمل
User asks: Spin up a devbox for my project
- 1
Reads and increments the devbox counter file to assign the next sequential DEVBOX_ID
- 2
Spawns a devbox subagent labeled devbox-{id} with the assigned ID in the task
- 3
Subagent runs devbox-init to build routing config and write APP_URL_*, VSCODE_URL, and NOVNC_URL env vars
- 4
Routes VSCode, noVNC, and app ports via Traefik dynamic config or Cloudflare Tunnel DNS registration
- 5
Reports VSCode URL, noVNC URL, and app slot URLs to the user
Public URLs ready: https://vscode-1.example.com, https://novnc-1.example.com/vnc.html, and https://app1-1.example.com
المتطلبات
- Domain with a wildcard DNS A-record pointing to the server (e.g. *.example.com)
- Traefik running on the host and accessible via Docker network (Traefik routing mode only)
- Cloudflare API token with DNS edit and Tunnel edit permissions for the target zone (Cloudflare Tunnel routing only)
- GitHub personal access token for cloning private repositories (optional)
التثبيت
clawhub install adshrc/devboxesشغّل أمر واجهة سطر الأوامر، أو الصق النص في Claude Code أو Cursor أو Codex أو أي وكيل برمجة تستخدمه.