Repository navigation
Peapod v0.2.0 🫛
Peapod v0.2.0 🫛
Sandboxes isolados, descartáveis e auditados para a IA (ou você) rodar código não-confiável — agora com firewall de egresso à prova de bypass e manual embutido.
✨ Novidades desde a v0.1.0
- 🔒 Firewall de domínio à prova de bypass —
sandbox create --allow d1,d2coloca o sandbox numa rede Docker--internal(sem rota para fora) e sobe um proxy sidecar como a única saída. Mesmo um processo que ignoreHTTP(S)_PROXYnão tem rota — o allowlist não é burlável. Tudo é criado e destruído junto com o sandbox. - 📖 Manual no app (menu Ajuda → "Manual do Peapod"): renderizado em Markdown, com aba "Para todos" (didática, com diagramas) e "Técnico".
- 🎬 GIF de demo real no README.
- 🧪 Suíte de testes cobrindo firewall, parsers da CLI e a lógica do núcleo (auditoria/reap/prune).
- 🍺 Homebrew:
brew tap andre28abr/peapod && brew trust andre28abr/peapod && brew install peapod.
⬇️ Instalar (macOS)
- Baixe o
Peapod.dmgabaixo (em Assets). - Abra o
.dmge arraste o Peapod para Aplicativos. - Na primeira vez, clique com o botão direito em Peapod → Abrir → Abrir.
App assinado ad-hoc (não notarizado pela Apple), então o macOS pede essa confirmação uma vez. Requer OrbStack (ou Docker) rodando.
🔧 Por dentro
- Núcleo em Go com a costura
Driver— backendsoci(Docker/OrbStack),apple-container(microVM) emock. - Servidor MCP (12 ferramentas), CLI e dashboard web.
- O proxy do firewall roda um binário linux estático do peapod, embutido no app e construído pela fórmula.
📖 Manual: docs/MANUAL.md · 🫛 Guia para todos: docs/GUIA.md
AGPL-3.0 © André Augusto Azarias De Souza