Pitch: Farol, um app open source que faz lint, testes e review de IA no código dos agentes e devolve as falhas pra eles corrigirem
Oi, pessoal. Sou o Antonio, dev solo aqui no Brasil, e queria mostrar um projeto que venho construindo: o Farol.
O problema
Uso agentes de código todo dia (Claude Code, Codex, Cursor). O agente diz que terminou, mas o código não passa no lint, quebra teste ou foge da arquitetura. Eu virava o revisor de tudo.
O que o Farol faz
É um app de Mac (Electron, só Apple Silicon por enquanto) que roda o agente pelo próprio CLI dele, na pasta do projeto, e confere o trabalho no branch:
- Você descreve a tarefa no chat (dá pra planejar antes, no modo Plan).
- O agente trabalha no branch.
- Quando ele termina uma mudança, o Farol roda seus pipelines no checkout, incluindo o que ainda não foi commitado.
- Se um passo falha, o relatório volta pro chat, o agente corrige e os checks rodam de novo até tudo passar.
Como os pipelines funcionam
- Shell: roda seus comandos (lint, testes) no seu login shell.
- Git: passa diff, log ou lista de arquivos pros próximos passos.
- IA: um prompt que revisa arquitetura ou segurança, com o agente e o modelo que você escolher, e dá um veredito de passa ou falha.
- Gates: pulam o resto do pipeline quando um passo falha, pra não gastar review num build quebrado.
- A saída de um passo vira entrada do próximo com
${name}.
Os pipelines ficam em .farol/pipelines.json, então dá pra commitar e o time inteiro usa os mesmos checks. Também rodam como hook antes do commit ou do push.
Privacidade
Os passos shell rodam na sua máquina. Os passos de IA mandam o prompt e o código pro provedor que você escolheu, pelo CLI e login dele.
Como testar
Licença MIT. Baixe o .dmg em https://github.com/acf77/farol/releases. O build ainda não é notarizado, então na primeira vez vá em Ajustes do Sistema > Privacidade e Segurança > Abrir Mesmo Assim. Também dá pra rodar do código-fonte (cd app && npm install && npm run dev).
Releases recentes trouxeram checkpoints por turno, fila de mensagens, escolha do nível de raciocínio e acompanhamento de memória e CPU dos agentes. E agora dá pra ver a memória de cada agente direto na barra lateral.
Feedback é muito bem-vindo, principalmente sobre como vocês validam o código que os agentes geram hoje.