
Deja que tu IA se lance a fondo. Tu directorio personal se queda en casa.
██╗ ██╗ ██████╗ ██╗ ██████╗ ██████╗ ██████╗ ██╗ ██╗
╚██╗ ██╔╝██╔═══██╗██║ ██╔═══██╗██╔══██╗██╔═══██╗╚██╗██╔╝
╚████╔╝ ██║ ██║██║ ██║ ██║██████╔╝██║ ██║ ╚███╔╝
╚██╔╝ ██║ ██║██║ ██║ ██║██╔══██╗██║ ██║ ██╔██╗
██║ ╚██████╔╝███████╗╚██████╔╝██████╔╝╚██████╔╝██╔╝ ██╗
╚═╝ ╚═════╝ ╚══════╝ ╚═════╝ ╚═════╝ ╚═════╝ ╚═╝ ╚═╝
Deja que tu IA se desboque por completo. Tu directorio personal sigue siendo tu directorio personal.
Documentación: yolobox.dev
Registro de cambios: CHANGELOG.md
Ejecuta Claude Code, Codex, Kimi Code, Gemini, Antigravity, OpenCode, Copilot, Pi, o cualquier agente de programación con IA en "modo yolo" sin destrozar tu directorio personal.
Los agentes de programación con IA son increíblemente potentes cuando les dejas ejecutar comandos sin pedir permiso. Pero un prompt malinterpretado y un rm -rf ~ después, estás restaurando desde una copia de seguridad (sí, claro, como si tuvieras copias de seguridad, jaja).
yolobox ejecuta tu agente de IA dentro de un contenedor donde:
/Users/you/projectLa IA puede descontrolarse absolutamente dentro del entorno aislado. ¿Tu directorio personal real? Intocable.
# Install via Homebrew
brew install finbarr/tap/yolobox
# Or install via script
curl -fsSL https://raw.githubusercontent.com/finbarr/yolobox/master/install.sh | bash
Homebrew instala las completions de bash y zsh automáticamente. Para instalaciones mediante script, consulta shell completions.
Luego, desde cualquier proyecto:
cd /path/to/your/project
yolobox claude # Let it rip
Otras funciones de acceso rápido de IA funcionan de la misma manera:
yolobox codex
yolobox gemini
yolobox kimi
yolobox agy
yolobox antigravity
yolobox opencode
yolobox copilot
yolobox pi
Establece default_harness = "codex" para que yolobox sin argumentos lance Codex. Usa yolobox shell cuando quieras un shell manual, y yolobox run <cmd...> cuando quieras un solo comando en el sandbox.
Los detalles completos de instalación y ejecución están en Installation & Setup. Los ejemplos de comandos están en Commands.
La imagen base viene con CLIs de IA, adaptadores ACP de Codex y Claude, Node.js, Python, Go, Bun, herramientas de compilación, Git, GitHub CLI, ripgrep, fd, fzf, jq, vim, RTK y las utilidades prácticas habituales.
¿Necesitas algo más? El agente tiene sudo.
Dentro de yolobox, los CLIs de IA compatibles están envueltos para omitir las solicitudes de permisos. Sin confirmaciones, sin barreras de seguridad. Solo IA pura y sin filtros, como la naturaleza manda.
Para un cliente ACP o editor, usa yolobox run codex-acp o yolobox run claude-agent-acp como su comando de agente stdio. Los adaptadores incluyen motores compatibles y usan los modos de permisos del cliente; los wrappers YOLO de la CLI de yolobox y --no-yolo no los controlan. Se aplican las opciones existentes de sincronización de configuración y autenticación. Consulta ACP clients para ver ejemplos de lanzamiento.
El progreso de la descarga de imágenes y de la compilación de imágenes personalizadas se envía a stderr, dejando stdout y stdin canalizado para el comando del contenedor, incluso durante el arranque de ACP.
Para ver la lista completa de herramientas, la tabla de wrappers en modo YOLO, las notas sobre RTK, la política de actualización de paquetes npm y el comportamiento de actualización de los CLIs incluidos, consulta What's in the Box.
Si un proyecto necesita herramientas o variables de entorno adicionales, añade una pequeña configuración de proyecto en lugar de bifurcar toda la imagen base:
# .yolobox.toml
env = ["CODEX_HOME=/home/yolo/.codex-account"]
[customize]
packages = ["default-jdk", "maven"]
Luego ejecutar normalmente:
yolobox run mvn --version
La personalización a nivel de proyecto también puede superponer un fragmento de Dockerfile sobre la imagen base. La primera ejecución construye una imagen derivada; las ejecuciones posteriores la reutilizan hasta que cambien la imagen base o las entradas de personalización.
Utilice rutas de contenedor para los valores de env porque se pasan directamente al proceso dentro de yolobox. Los valores de env se pasan al runtime de forma literal; nada en ellos se interpreta.
Para entregar al sandbox un valor diferente del que usa el host bajo el mismo nombre —un token de solo lectura en lugar del real—, asígnelo con un alias mediante env_from_host (o --env-from-host KEY=HOST_VAR):
# .yolobox.toml
env_from_host = ["GH_TOKEN=YOLOBOX_READONLY_GH_TOKEN"]
El alias es dueño de esa variable: suprime el passthrough automático y --gh-token para la misma clave, y yolobox se niega a iniciar si la variable del host no está definida, por lo que el token que reemplaza nunca puede filtrarse por accidente.
Consulta Configuration para la configuración de env del proyecto, y Project-Level Customization para instalaciones de paquetes, fragmentos de Dockerfile, comportamiento de reconstrucción, comportamiento de actualización e imágenes totalmente personalizadas.
yolobox setup # Configure global defaults
yolobox config # Show resolved config for this project
yolobox claude --docker --gh-token # Give the agent Docker and GitHub access
yolobox claude --claude-config --no-claude-auth # Share config, keep the box login independent
yolobox copilot --copilot-config # Share Copilot settings, login, and session history
yolobox codex --rtk # Enable RTK command-output compression
yolobox run --no-network make test # Run one command with no network
yolobox fork --name bruno codex # Give an agent its own project copy
yolobox upgrade # Update binary and pull the latest image
yolobox update-agents # Update AI CLIs and ACP adapters in the persistent box
yolobox reset --force # Remove yolobox volumes from the configured runtime
El reinicio funciona con Docker, Podman y Apple container. Solo elimina los volúmenes de yolobox existentes y finaliza correctamente cuando no queda ninguno. yolobox uninstall --force también limpia esos volúmenes antes de eliminar el binario y la configuración global; un fallo en el runtime detiene la desinstalación para que pueda reintentarse. Añade --keep-volumes a la desinstalación para conservar los datos del runtime.
La imagen incluye OpenCode v2 (@opencode/cli). yolobox update-agents opencode también instala la v2, eliminando primero el paquete antiguo opencode-ai del prefijo npm persistente para evitar un conflicto de lanzador. Las instalaciones permiten explícitamente el script postinstall requerido. Las copias v1 instaladas por el usuario permanecen en su sitio hasta que las actualices; descargar una nueva imagen por sí sola no reemplaza las herramientas persistentes.