1

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:

  1. Você descreve a tarefa no chat (dá pra planejar antes, no modo Plan).
  2. O agente trabalha no branch.
  3. Quando ele termina uma mudança, o Farol roda seus pipelines no checkout, incluindo o que ainda não foi commitado.
  4. 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.

Carregando publicação patrocinada...