
Deixe sua IA ir até o fim. Seu diretório home fica em casa.
██╗ ██╗ ██████╗ ██╗ ██████╗ ██████╗ ██████╗ ██╗ ██╗
╚██╗ ██╔╝██╔═══██╗██║ ██╔═══██╗██╔══██╗██╔═══██╗╚██╗██╔╝
╚████╔╝ ██║ ██║██║ ██║ ██║██████╔╝██║ ██║ ╚███╔╝
╚██╔╝ ██║ ██║██║ ██║ ██║██╔══██╗██║ ██║ ██╔██╗
██║ ╚██████╔╝███████╗╚██████╔╝██████╔╝╚██████╔╝██╔╝ ██╗
╚═╝ ╚═════╝ ╚══════╝ ╚═════╝ ╚═════╝ ╚═════╝ ╚═╝ ╚═╝
Deixe sua IA solta de vez. Seu diretório home continua sendo seu home.
Docs: yolobox.dev
Changelog: CHANGELOG.md
Execute o Claude Code, Codex, Kimi Code, Gemini, Antigravity, OpenCode, Copilot, Pi ou qualquer agente de programação com IA em "modo yolo" sem destruir seu diretório home.
Agentes de programação com IA são incrivelmente poderosos quando você os deixa executar comandos sem pedir permissão. Mas basta um prompt mal interpretado e, depois de um rm -rf ~, você está restaurando do backup (ah tá, como se você tivesse backups kkk).
O yolobox executa seu agente de IA dentro de um contêiner onde:
/Users/you/projectA IA pode fazer absolutamente o que quiser dentro do sandbox. Seu diretório home de verdade? Intocável.
# Install via Homebrew
brew install finbarr/tap/yolobox
# Or install via script
curl -fsSL https://raw.githubusercontent.com/finbarr/yolobox/master/install.sh | bash
O Homebrew instala as completions de bash e zsh automaticamente. Para instalações via script, consulte shell completions.
Depois, a partir de qualquer projeto:
cd /path/to/your/project
yolobox claude # Let it rip
Outros atalhos de IA funcionam da mesma forma:
yolobox codex
yolobox gemini
yolobox kimi
yolobox agy
yolobox antigravity
yolobox opencode
yolobox copilot
yolobox pi
Defina default_harness = "codex" para fazer com que o yolobox sem argumentos inicie o Codex. Use yolobox shell quando quiser um shell manual, e yolobox run <cmd...> quando quiser um único comando no sandbox.
Os detalhes completos de instalação e execução estão em Installation & Setup. Exemplos de comandos estão em Commands.
A imagem base vem com CLIs de IA, adaptadores Codex e Claude ACP, Node.js, Python, Go, Bun, ferramentas de build, Git, GitHub CLI, ripgrep, fd, fzf, jq, vim, RTK e os utilitários práticos de sempre.
Precisa de algo mais? O agente tem sudo.
Dentro do yolobox, as CLIs de IA suportadas são encapsuladas para ignorar os prompts de permissão. Sem confirmações, sem barreiras de proteção. Apenas IA pura e sem filtro, como a natureza pretendia.
Para um cliente ACP ou editor, use yolobox run codex-acp ou yolobox run claude-agent-acp como o comando de agente stdio dele. Os adaptadores incluem engines compatíveis e usam os modos de permissão do cliente; os wrappers YOLO da CLI do yolobox e --no-yolo não os controlam. As opções existentes de sincronização de configuração e autenticação se aplicam. Consulte ACP clients para exemplos de inicialização.
O progresso do pull da imagem e da build de imagens personalizadas vai para stderr, deixando stdout e stdin canalizado para o comando do contêiner, inclusive durante a inicialização do ACP.
Para a lista completa de ferramentas, a tabela de wrappers do modo YOLO, notas sobre RTK, a política de atualidade dos pacotes npm e o comportamento de atualização das CLIs incluídas, consulte What's in the Box.
Se um projeto precisar de ferramentas ou variáveis de ambiente extras, adicione uma pequena configuração de projeto em vez de criar um fork da imagem base inteira:
# .yolobox.toml
env = ["CODEX_HOME=/home/yolo/.codex-account"]
[customize]
packages = ["default-jdk", "maven"]
Em seguida, execute normalmente:
yolobox run mvn --version
A personalização ao nível do projeto também pode adicionar um fragmento de Dockerfile sobre a imagem base. A primeira execução constrói uma imagem derivada; as execuções seguintes reutilizam-na até que a imagem base ou as entradas de personalização mudem.
Use caminhos de container para os valores de env, pois eles são passados diretamente ao processo dentro do yolobox. Os valores de env são passados ao runtime literalmente; nada neles é interpretado.
Para fornecer ao sandbox um valor diferente do que o host usa sob o mesmo nome — um token somente leitura em vez do seu token real — crie um alias com env_from_host (ou --env-from-host KEY=HOST_VAR):
# .yolobox.toml
env_from_host = ["GH_TOKEN=YOLOBOX_READONLY_GH_TOKEN"]
O alias é o dono dessa variável: ele suprime o passthrough automático e o --gh-token para a mesma chave, e o yolobox se recusa a iniciar se a variável do host não estiver definida, de modo que o token que ele substitui nunca pode vazar por acidente.
Consulte Configuration para configurações de env do projeto, e Project-Level Customization para instalações de pacotes, fragmentos de Dockerfile, comportamento de rebuild, comportamento de upgrade e imagens 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
O reset funciona com Docker, Podman e Apple container. Ele remove apenas os volumes yolobox existentes e é bem-sucedido quando nenhum permanece. yolobox uninstall --force também limpa esses volumes antes de remover o binário e a configuração global; uma falha no runtime interrompe a desinstalação para que possa ser tentada novamente. Adicione --keep-volumes à desinstalação para preservar os dados do runtime.
A imagem inclui o OpenCode v2 (@opencode/cli). yolobox update-agents opencode também instala a v2, removendo primeiro o pacote antigo opencode-ai do prefixo npm persistente para evitar um conflito de launcher. As instalações permitem explicitamente o script postinstall necessário. Cópias v1 existentes instaladas pelo usuário permanecem no lugar até que você as atualize; apenas baixar uma nova imagem não substitui ferramentas persistentes.
O OpenCode v2 mantém o comando opencode e os locais de configuração existentes. Faça backup da sua configuração antes de alternar: plugins v1 e integrações com a API do servidor precisam de migração. Consulte o guia de migração upstream.