Execute agentes de codificação AI dentro de sandboxes isoladas com git worktrees.
@alembic/factory orquestra agentes de codificação AI (Claude Code, Codex, Cursor, OpenCode, Copilot, Pi) dentro de ambientes Docker, Podman ou no-sandbox. Cada execução cria um git worktree, executa o agent contra um arquivo de prompt, captura commits e opcionalmente mergeia o resultado de volta.
Ele suporta sessões interativas, loops multi-iteração, output estruturado, resume/fork de sessão e estratégias de branch (head, merge-to-head ou branch explícito).
Pense assim… uma sala limpa para cirurgia de software: o paciente (seu repo) é isolado, o cirurgião (agent) opera, e a incisão é mergeada ou descartada.
A API pública é pequena: run, createSandbox, createWorktree, interactive, providers de agent, providers de sandbox e Output. Internamente usa Effect para composição funcional, mas consumidores veem funções Promise-returning. O pacote é vendored e adaptado de @ai-hero/sandcastle.
# scaffold uma config de factory pnpm exec alembic-factory init --agent claude-code --sandbox docker # build a imagem do sandbox pnpm exec alembic-factory docker build-image --image-name myproject:sandcastle
O scaffold cria um diretório .sandcastle/ com um prompt e um main.ts que importa @alembic/factory. O loop do agent impõe timeouts de idle e completion, captura sessões JSONL para resume/fork e suporta substituição de argumentos de prompt com tokens {{KEY}}.
Execute pnpm exec alembic-factory init e inspecione o .sandcastle/main.ts gerado. Identifique os providers de agent e sandbox.