yolobox v0.19.4

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

Deixe sua IA solta de vez. Seu diretório home continua em casa.

Docs: yolobox.dev

Changelog: CHANGELOG.md

Execute o Claude Code, Codex, Kimi Code, Gemini, Antigravity, OpenCode, Copilot, Pi, ou qualquer agente de codificação com IA em "modo yolo" sem destruir seu diretório home.

O Problema

Agentes de codificação com IA são incrivelmente poderosos quando você os deixa executar comandos sem pedir permissão. Mas um prompt mal interpretado e, depois de um rm -rf ~, você está restaurando do backup (é, claro, como se você tivesse backups, rs).

A Solução

O yolobox executa seu agente de IA dentro de um contêiner onde:

• o diretório do seu projeto é montado em seu caminho real, como /Users/you/project
• o agente tem permissões totais e sudo dentro do contêiner
• seu diretório home não é montado a menos que você opte explicitamente por isso
• volumes persistentes mantêm ferramentas, configurações e sessões entre execuções
• Claude, Codex e Kimi Code recebem orientações integradas do yolobox para que possam entender o sandbox em que estão sendo executados

A IA pode fazer absolutamente o que quiser dentro do sandbox. Seu diretório home real? Intocável.

Início 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

Então, 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.

Detalhes completos de instalação e execução estão em Installation & Setup. Exemplos de comandos estão em Commands.

O Que Vem na Caixa?

A imagem base vem com CLIs de IA, adaptadores ACP do Codex e Claude, Node.js, Python, Go, Bun, ferramentas de build, Git, GitHub CLI, ripgrep, fd, fzf, jq, vim, RTK e os itens práticos de sempre.

Precisa de algo mais? O agente tem sudo.

Dentro do yolobox, as CLIs de IA suportadas são encapsuladas para pular os prompts de permissão. Sem confirmações, sem barreiras. Apenas IA pura e sem filtro, do jeito que 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. Veja ACP clients para exemplos de inicialização.

Para a lista completa de ferramentas, a tabela de wrappers do modo YOLO, notas sobre RTK, política de atualidade de pacotes npm e comportamento de atualização das CLIs incluídas, veja What's in the Box.

Personalização do Projeto

Se um projeto precisar de ferramentas ou variáveis de ambiente extras, adicione uma pequena configuração de projeto em vez de fazer um fork da imagem base inteira:

# .yolobox.toml
env = ["CODEX_HOME=/home/yolo/.codex-account"]

[customize]
packages = ["default-jdk", "maven"]

Depois execute normalmente:

yolobox run mvn --version

A personalização em nível de projeto também pode adicionar um fragmento de Dockerfile sobre a imagem base. A primeira execução constrói uma imagem derivada; execuções posteriores a reutilizam até que a imagem base ou as entradas de personalização mudem.

Use caminhos de contêiner para 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 entregar 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 é dono dessa variável: ele suprime o passthrough automático e --gh-token para a mesma chave, e o yolobox se recusa a iniciar se a variável do host não estiver definida, então o token que ele substitui nunca pode vazar por acidente.

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

Fluxos de Trabalho Comuns

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 incrementalmente configurações duráveis do Claude e monta ao vivo o ~/.claude/projects do host em leitura/escrita para que o histórico de retomada de sessão permaneça atualizado. --no-claude-auth mantém o login do box independente, mas não torna essa montagem de histórico do projeto somente leitura.

A configuração automática do RTK deixa a telemetria desativada, a menos que você opte por ativá-la interativamente de dentro do box com rtk telemetry enable.

As referências detalhadas estão intencionalmente no site de docs:

• Commands: atalhos, comandos de manutenção, fork e exemplos
• Configuration: configuração global, configuração de projeto, instruções copiadas, passthrough de env e manifestos de contexto
• Flags: cada flag, nota de compatibilidade e detalhe de passthrough do runtime
• Recipes: agentes em paralelo e roteamento de webapp

Filosofia: É a Caixa da IA, Não a Sua

O yolobox é projetado para agentes de IA, não para humanos. Você inicia a IA e a deixa trabalhar.

O agente tem sudo dentro do contêiner. Se precisar de um compilador, banco de dados, pacote ou framework, ele pode instalar. Volumes nomeados preservam essa configuração entre sessões, então você não precisa transformar o README em uma matriz de pacotes de cem linhas. Aponte-o para o seu projeto e deixe-o cozinhar.

Modelo de Segurança

O yolobox é proteção contra acidentes, não um teorema mágico anti-fuga de contêiner.