Stitch 2.0 está no ar. Se você acompanhou a série, a versão curta é: tudo que você leu nas retrospectivas acabou de aterrissar.
Se não acompanhou, este post é o resumo autônomo. O que o Stitch é agora, o que mudou do v1 e como experimentar nos próximos trinta segundos.
O que é o Stitch 2.0
Uma ferramenta de linha de comando que roda no seu laptop. Ele lê a configuração de CI que já está no seu repositório, faz o parse dos jobs que você definiu e roda os jobs de verificação (lint, typecheck, test, build) localmente em segundos. Quando um job falha, o Stitch entrega a falha para um agente de IA (Claude Code ou Codex) que você já tem instalado. O agente corrige o problema. O Stitch re-executa o job. Se passa, acabou.
Um comando para instalar e rodar:
npx stitch-agent run claudeSem API keys. Sem imagem Docker. Sem novos jobs de pipeline. Sem arquivo de configuração obrigatório. O CI que você já tem, rodando na máquina em que você já trabalha, com o agente já aberto na sua tela.
O que mudou do v1
A lista curta, para quem usou o Stitch v1 e está se perguntando o que quebrou:
- Linguagem. v1 era Python, distribuído no PyPI. v2 é TypeScript, distribuído no npm. O nome do pacote continua sendo
stitch-agent. - Modelo de execução. v1 rodava como um job de CI disparado por falha de pipeline. v2 roda localmente no seu terminal. O pipeline fica intocado.
- Integração com agente. v1 falava com modelos via API, usando chaves que você fornecia. v2 delega para o Claude Code ou Codex que você já instalou e usa a assinatura que você já tem.
- Superfície de config. v1 exigia adicionar dois jobs (
stitch-monitor,stitch-heal) ao seu YAML de CI. v2 não exige nenhuma mudança no seu CI. - Classificação de erros. v1 tinha uma engine de regex com 150 padrões que separava erros em nove categorias. v2 não tem nada disso. O agente cuida do diagnóstico diretamente.
- Auto-merge. v1 tinha uma flag para isso. v2 faz auto-commit + push só em branches limpos e só se você passar
--auto-commit. Desligado por padrão. - TUI interativa. A saída do v1 era um log de CI. v2 tem uma interface de terminal ao vivo com stepper de pipeline, tabela de status de jobs e painel do driver.
- Modo watch. Novo no v2. Re-verifica os jobs afetados quando você salva um arquivo.
Por que uma reescrita completa e não uma migração? Porque a maioria dessas mudanças não é de funcionalidade, é de forma. Uma biblioteca feita para rodar dentro de um ambiente de CI tem estrutura diferente de uma CLI feita para rodar ao lado do seu editor. Tentar remodelar o v1 no v2 teria sido mais lento do que escrever o v2 do zero. Tentamos o caminho lento primeiro. Os posts anteriores desta série explicam como chegamos a essa decisão.
Para quem é
O perfil que tínhamos em mente durante a reescrita:
- Você trabalha em um ou mais repositórios com pipeline de CI.
- Seu CI quebra por motivos triviais com frequência suficiente para você notar.
- Você já usa Claude Code, Codex ou outro agente de IA em CLI no dia a dia.
- Você prefere não esperar um round trip de pipeline remoto para saber que esqueceu um ponto e vírgula.
Se isso é você, o Stitch 2.0 está a um comando de distância.
O que vem a seguir
Stitch 2.0 é o primeiro release da forma local-first. O roadmap daqui para frente é mais curto e simples que o do v1, e isso é proposital. O que queremos adicionar a seguir:
- Mais plataformas de CI. GitLab CI e GitHub Actions têm suporte hoje. CircleCI, Drone e runners self-hosted são os próximos.
- Mais agentes. Claude Code e Codex são os drivers atuais. Adicionar outros agentes baseados em CLI é um pequeno pattern match.
- Melhor inferência de jobs. A heurística para classificar jobs de verificação versus infra é boa, mas não perfeita. Casos de borda em pipelines exóticos precisam de mais trabalho.
- Compartilhamento em time. Sem dashboard, sem serviço. Só um jeito de compartilhar uma política
.stitch.ymlnum repo sem cada desenvolvedor redescobrir do zero.
As coisas que deliberadamente não estamos adicionando também merecem ser nomeadas. Sem serviço hospedado. Sem conta. Sem telemetria. Sem treinar no seu código. Se isso mudar, será um produto separado com nome separado.
Experimente
npx stitch-agent run claudeSe você tem dez minutos e um pipeline quebrando, é o suficiente. O repositório está em github.com/x24labs/stitch-agent. Issues estão abertas. Contribuições são bem-vindas.
Obrigado por ler a série. A resposta honesta para “por que isso precisou de uma reescrita” é que a forma certa não estava disponível para nós até vermos a forma errada sair. v2 é a versão que queríamos construir desde o início. Só precisávamos construir o v1 primeiro para saber.