AI-Jail Sandbox: Sandbox Segura para o Gemini CLI

⚠️ ATENÇÃO: Este produto é EXPERIMENTAL e está em fase de testes. O uso em ambientes críticos não é recomendado sem a devida auditoria.

AI-Jail Sandbox é uma ferramenta CLI oficial para executar o agente de IA Gemini em um ambiente Docker isolado, protegendo seu sistema host de comandos inseguros e vazamento de dados.

Pré-requisitos

Para rodar o AI-Jail Sandbox, você precisa apenas de:

1. Docker: O motor que cria o ambiente isolado. Certifique-se de que o serviço está rodando e que seu usuário tem permissão para executar comandos docker sem sudo.
2. Node.js: Para instalar e rodar o CLI globalmente.
3. Bash: Nativo no Linux e macOS. No Windows, utilize o WSL2.

Instalação Global

Instale a ferramenta oficial diretamente do registro do NPM:

npm install -g ai-jail-sandbox

Ou usando pnpm:

pnpm add -g ai-jail-sandbox

Como Usar

Execute o ai-jail-sandbox de dentro de qualquer diretório de projeto:

1. Iniciar o Agente de IA (Modo Padrão)

ai-jail-sandbox

2. Passar uma Pergunta Direta

ai-jail-sandbox "Explique o código neste diretório"

3. Modo Lockdown (Segurança Máxima)

Para rodar a IA sem qualquer acesso à rede externa:

ai-jail-sandbox --lockdown

4. Proteção de Arquivos Sensíveis (Mascaramento)

Por padrão, o ai-jail-sandbox identifica e mascara os seguintes arquivos e pastas para que a IA não consiga ler seu conteúdo (eles aparecerão como arquivos vazios ou pastas vazias dentro do container):

• Arquivos de ambiente: Todos que começam com .env* (ex: .env, .env.local, .env.prod).
• Pastas de sistema e histórico: .git, .ssh, .npm, .pnpm.
• Chaves e credenciais: *.key, *.pem, credentials.json.

Para desativar essa proteção e permitir que a IA leia esses arquivos (não recomendado para agentes desconhecidos):

ai-jail-sandbox --allow-secrets

Arquitetura de Segurança

| Recurso | Proteção | | :--- | :--- | | Arquivos Montados | Apenas o diretório atual é acessível. | | Arquivos Mascarados | .env*, .git, .ssh, chaves e credenciais são sobrepostos por /dev/null. | | Rede | Bloqueio total via --network none (com a flag --lockdown). | | Sistema Host | O agente não tem acesso a pastas fora do projeto (como /home ou /tmp). | | Variáveis de Ambiente | Nenhuma variável do seu computador real é passada para o container. |

Inspirado por ai-jail de Fabio Akita (AkitaOnRails).