yolobox

A IA pode ficar totalmente selvagem dentro da sandbox. Seu diretório home real? Intocável.

Início Rápido

Depois, a partir de qualquer projeto:

Outros atalhos de IA funcionam da mesma forma:

Defina default_harness = "codex" para fazer yolobox puro iniciar o Codex. Use yolobox shell quando quiser um shell manual, e yolobox run <cmd...> quando quiser um único comando na sandbox.

Detalhes completos de instalação e execução estão em Instalação & Configuração. Exemplos de comandos estão em Comandos.

O Que Tem na Caixa?

A imagem base vem com CLIs de IA, Node.js, Python, Go, Bun, ferramentas de build, Git, GitHub CLI, ripgrep, fd, fzf, jq, vim, RTK e os utilitários práticos usuais.

Precisa de outra coisa? O agente tem sudo.

Dentro do yolobox, os CLIs de IA suportados são encapsulados para pular prompts de permissão. Sem confirmações, sem guardrails. Apenas IA pura e sem filtro, como a natureza pretendia.

Para a lista completa de ferramentas, tabela de wrappers do modo YOLO, notas sobre RTK, política de atualização de pacotes npm e comportamento de atualização dos CLIs incluídos, veja O Que Tem na Caixa.

Personalização de Projeto

Se um projeto precisar de ferramentas ou variáveis de ambiente extras, adicione uma pequena configuração de projeto em vez de bifurcar toda a imagem base:

Depois execute normalmente:

A personalização em nível de projeto também pode sobrepor um fragmento de Dockerfile sobre a imagem base. A primeira execução cria 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 porque eles são passados diretamente para o processo dentro do yolobox. Os valores de env são passados ao runtime literalmente; nada neles é interpretado.

Para entregar à sandbox um valor diferente do que o host usa sob o mesmo nome — um token somente leitura em vez do seu real — crie um alias com env_from_host (ou --env-from-host KEY=HOST_VAR):

O alias é dono dessa variável: ele suprime o repasse 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 Configuração para configurações de env do projeto, e Personalização em Nível de Projeto para instalação de pacotes, fragmentos de Dockerfile, comportamento de rebuild, comportamento de atualização e imagens totalmente personalizadas.

Fluxos de Trabalho Comuns

--claude-config sincroniza incrementalmente as configurações duráveis do Claude e monta ao vivo o host ~/.claude/projects em leitura/escrita para que o histórico de retomada de sessão permaneça atual. --no-claude-auth mantém o login da caixa independente, mas não torna esse mount 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 da caixa com rtk telemetry enable.

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

• Comandos: atalhos, comandos de manutenção, fork e exemplos
• Configuração: config global, config de projeto, instruções copiadas, repasse de env e manifestos de contexto
• Flags: todas as flags, notas de compatibilidade e detalhes de repasse em runtime
• Receitas: agentes paralelos e roteamento de webapp

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

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 um. 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 seu projeto e deixe-o cozinhar.

Modelo de Segurança

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

Ele ajuda a proteger seu diretório home, chaves SSH, dotfiles, projetos não relacionados e a maior parte do estado do sistema de arquivos do host contra comandos destrutivos descuidados. Ele não protege o diretório de projeto que você montou, segredos que você encaminha explicitamente, ações do host que você conecta explicitamente, nem o kernel do host contra vulnerabilidades de fuga em runtime.

Para uma caixa mais restrita, combine flags como:

Se você está preocupado com código hostil em vez de código descuidado, use isolamento mais forte, como Podman sem root ou uma VM. O modelo de ameaça completo e as opções de endurecimento estão em Modelo de Segurança.

Desenvolvimento

Fluxo de trabalho para contribuidores, comandos do site de documentação, versionamento e regras de release estão em Contribuindo.

Licença

MIT