Skip to content

Peapod v0.2.0 🫛

Choose a tag to compare

@andre28abr andre28abr released this 26 Jun 14:53
· 21 commits to main since this release

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,d2 coloca o sandbox numa rede Docker --internal (sem rota para fora) e sobe um proxy sidecar como a única saída. Mesmo um processo que ignore HTTP(S)_PROXY nã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)

  1. Baixe o Peapod.dmg abaixo (em Assets).
  2. Abra o .dmg e arraste o Peapod para Aplicativos.
  3. 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 — backends oci (Docker/OrbStack), apple-container (microVM) e mock.
  • 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