yolobox v0.19.4

██╗   ██╗ ██████╗ ██╗      ██████╗ ██████╗  ██████╗ ██╗  ██╗
╚██╗ ██╔╝██╔═══██╗██║     ██╔═══██╗██╔══██╗██╔═══██╗╚██╗██╔╝
 ╚████╔╝ ██║   ██║██║     ██║   ██║██████╔╝██║   ██║ ╚███╔╝
  ╚██╔╝  ██║   ██║██║     ██║   ██║██╔══██╗██║   ██║ ██╔██╗
   ██║   ╚██████╔╝███████╗╚██████╔╝██████╔╝╚██████╔╝██╔╝ ██╗
   ╚═╝    ╚═════╝ ╚══════╝ ╚═════╝ ╚═════╝  ╚═════╝ ╚═╝  ╚═╝

Deja que tu IA se suelte del todo. Tu directorio home se queda en casa.

Docs: yolobox.dev

Changelog: CHANGELOG.md

Ejecuta Claude Code, Codex, Kimi Code, Gemini, Antigravity, OpenCode, Copilot, Pi, o cualquier agente de codificación con IA en "modo yolo" sin destruir tu directorio home.

El Problema

Los agentes de codificació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).

La Solución

yolobox ejecuta tu agente de IA dentro de un contenedor donde:

• tu directorio de proyecto se monta en su ruta real, como /Users/you/project
• el agente tiene permisos completos y sudo dentro del contenedor
• tu directorio home no se monta a menos que lo autorices explícitamente
• los volúmenes persistentes conservan herramientas, configuraciones y sesiones entre ejecuciones
• Claude, Codex y Kimi Code reciben orientación integrada de yolobox para que puedan entender el sandbox en el que se ejecutan

La IA puede descontrolarse por completo dentro del sandbox. ¿Tu directorio home real? Intocable.

Inicio Rápido

# Install via Homebrew
brew install finbarr/tap/yolobox

# Or install via script
curl -fsSL https://raw.githubusercontent.com/finbarr/yolobox/master/install.sh | bash

Luego desde cualquier proyecto:

cd /path/to/your/project
yolobox claude    # Let it rip

Otros atajos de IA funcionan de la misma manera:

yolobox codex
yolobox gemini
yolobox kimi
yolobox agy
yolobox antigravity
yolobox opencode
yolobox copilot
yolobox pi

Configura default_harness = "codex" para que yolobox a secas 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.

¿Qué Incluye?

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 los elementos prácticos 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 del 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 ejemplos de lanzamiento.

Para la lista completa de herramientas, la tabla de wrappers en modo YOLO, las notas sobre RTK, la política de frescura de paquetes npm y el comportamiento de actualización de los CLIs incluidos, consulta What's in the Box.

Personalización del Proyecto

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 ejecuta con normalidad:

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 cambie la imagen base o las entradas de personalización.

Usa 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 tal cual; nada en ellos se interpreta.

Para entregar al sandbox un valor diferente al que usa el host bajo el mismo nombre — un token de solo lectura en lugar del tuyo real — asígnalo 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 paso automático y --gh-token para la misma clave, y yolobox se niega a iniciar si la variable del host no está definida, de modo que el token al que reemplaza nunca pueda 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.

Flujos de Trabajo Comunes

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 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

--claude-config sincroniza de forma incremental los ajustes duraderos de Claude y monta en vivo ~/.claude/projects del host en lectura/escritura para que el historial de reanudación de sesiones se mantenga actualizado. --no-claude-auth mantiene el inicio de sesión del box independiente, pero no hace que ese montaje del historial del proyecto sea de solo lectura.

La configuración automática de RTK deja la telemetría desactivada a menos que la actives interactivamente desde dentro del box con rtk telemetry enable.

Las referencias detalladas están intencionadamente en el sitio de documentación:

• Commands: atajos, comandos de mantenimiento, fork y ejemplos
• Configuration: configuración global, configuración de proyecto, instrucciones copiadas, paso de env y manifiestos de contexto
• Flags: cada flag, nota de compatibilidad y detalle del paso al runtime
• Recipes: agentes en paralelo y enrutamiento de aplicaciones web

Filosofía: Es el Box de la IA, No el Tuyo

yolobox está diseñado para agentes de IA, no para humanos. Tú lanzas la IA y la dejas trabajar.

El agente tiene sudo dentro del contenedor. Si necesita un compilador, base de datos, paquete o framework, puede instalarlo. Los volúmenes con nombre conservan esa configuración entre sesiones, así que no tienes que convertir el README en una matriz de cientos de líneas de paquetes. Apúntalo a tu proyecto y deja que cocine.

Modelo de Seguridad