Farol

Visão geral

Saúde do ambiente, versão instalada e onde ficam os teus dados.

…

Contas

Cada conta com identidade e cor próprias. A política de automação é por conta: cada uma diz, nos próprios seletores, se revisa sozinha e o que faz com cada resultado. Contas silenciadas somem do painel.

Automação

Como o Farol trabalha sozinho: com qual modelo, quantas revisões ao mesmo tempo e de quanto em quanto tempo ele consulta o GitHub. Se uma conta revisa e aprova sozinha é decidido só em Contas, conta a conta.

Aprovar junto com quem pegou o PR Quando outra pessoa do time já está revisando um PR com o Farol, o Farol sai de cena e avisa aqui no app, sem postar nada no PR (um Farol por PR, pra não empilhar revisão em cima da mesma coisa). O sinal é a label <conta>:revisando que o Farol dela põe no PR: quem revisa sem o Farol não é detectado. Com esta chave ligada, ele ainda aprova em seu nome quando essa pessoa aprova o mesmo head, sem abrir sessão nem gastar do seu limite. Só vale em conta que revisa sozinha, e a conta cujo aprovável sem ressalvas espera você também não co-assina. Nunca co-assina onde você é dono do código pelo CODEOWNERS, nem quando o CODEOWNERS não pode ser lido: ali a sua aprovação precisa vir de revisão de verdade. O preço é explícito: você endossa uma revisão que não fez e não tem como saber com que rigor ou com que modelo ela foi feita. Desligado (padrão), o PR simplesmente espera você, e o botão Revisar continua funcionando normalmente. Revisar sozinho mesmo com outra pessoa revisando Quando outra pessoa tem a label de revisando num PR pedido a você, a revisão automática roda mesmo assim e o card só informa quem está lá. Desligada (padrão), o Farol não revisa sozinho naquele commit e o botão Revisar junto continua valendo. Ligada, a co-assinatura de “Aprovar junto com quem pegou o PR” não acontece: sua aprovação vem da sua revisão. Esperar o CI antes de revisar Com a chave ligada, a revisão automática só começa quando todos os checks obrigatórios do PR estão verdes, para não gastar uma sessão num commit que ainda vai mudar. Desligado (padrão), o Farol começa a revisar assim que o PR chega. O botão Revisar nunca espera. Esperar o CI para aprovar Com a chave ligada, a aprovação automática não sai enquanto algum check obrigatório do PR estiver vermelho ou rodando: o card fica em "Esperando o CI (aprova sozinho)" e o Farol posta quando a pipe fecha verde no mesmo commit. Desligado (padrão), a aprovação sai assim que a revisão termina, e o estado do CI fica registrado como ressalva aqui no app, nunca no PR. O botão Aprovar nunca espera. Modo rápido da revisão Corta o tempo da revisão automática: leitura orientada ao diff (abre o arquivo inteiro só quando o trecho não se explica sozinho), verificação empírica só do que muda a decisão, e o esforço de raciocínio da sessão cai pra medium (minimal ou low explícito continua valendo). Verificação que exigiria experimento longo vira decisão sua, com o motivo registrado. Nenhum gate afrouxa: a troca é velocidade por profundidade e autonomia, então mais PRs podem cair na sua mesa. A cobertura da leitura continua completa. Só vale pra revisão; chat, autoanálise e ferramentas seguem no esforço configurado. Não vale no modelo Auto, que fixa modelo e esforço sozinho. Retomar a sessão no round 2 Quando o autor corrige depois de um pedido de mudanças seu, a re-revisão automática continua a mesma conversa da revisão anterior (a sessão já leu o PR, então retomar poupa a releitura). Desligado (padrão), cada round parte do zero, sem carregar o contexto do anterior. Se a sessão antiga não existir mais, o app recomeça do zero sozinho. Só vale no Claude Code: conta com perfil Codex sempre recomeça do zero. Atualizar sozinho Aplica a atualização baixada das releases assim que nenhuma análise, chat ou sessão de terminal estiver rodando e a fila de revisão estiver vazia. O app fecha e reabre sozinho. Detectar pushback automaticamente Roda 1 sessão do provedor de IA associado à conta por PR em que o autor respondeu depois do seu pedido de mudanças ou aprovação com ressalva, pra classificar se foi contestação e como terminou (no máximo 2 por ciclo; com confiança baixa, fica pra você confirmar). Vem ligado; desligue se um dia quiser poupar o teu limite. A marcação manual (em Revisões recentes) funciona sempre.

Configuração do provedor Edite separadamente o modelo e o raciocínio de cada CLI. Na execução, cada conta usa o perfil associado no painel Contas. No Claude, Auto (qualidade primeiro) revisa todo PR com o Opus, no mesmo raciocínio do Opus fixo, e sobe o raciocínio para xhigh em repositório crítico, caminho sensível ou PR muito grande, só na revisão headless.

Modelo das sessões autônomas

Revisões paralelas por conta

Quantas revisões automáticas a mesma conta roda ao mesmo tempo. O padrão (1) revisa em série; subir acelera fila cheia, mas gasta o limite do plano mais rápido e pesa mais na máquina. Contas diferentes já revisam em paralelo entre si. É sempre por conta, com ou sem o compartilhamento entre aparelhos: o total do aparelho é a linha de baixo.

Teto total deste aparelho

Limite do TOTAL de revisões automáticas rodando ao mesmo tempo neste aparelho, somando todas as contas. Sem teto (padrão), vale só o limite por conta da linha de cima. Ligue se a máquina ou a API sentirem o volume: a vaga que liberar vai para a org atendida há mais tempo, não para a primeira da fila. Com o compartilhamento entre aparelhos, o admin pode definir este mesmo número à distância ("Teto total do aparelho", em Sistema → Aparelhos e em Radar → Aparelhos): vale o menor dos dois.

Intervalo de checagem

De quanto em quanto tempo o Farol consulta o GitHub. Intervalo menor gasta mais chamadas do gh, não gasta IA.

Sessão no terminal sem pedir permissões --dangerously-skip-permissions: vale só pras sessões no terminal, o modo interno já roda sem prompts.

Merge em Meus PRs

Repos bloqueados pra merge Nesses repos o botão Merge de Meus PRs fica desativado, para respeitar a regra de review do time, e o Farol deixa de consultar no GitHub se os PRs deles dão para mergear. Vale para todas as contas e não muda nada no GitHub.

Nenhum repo bloqueado. O Merge aparece em todos os seus PRs quando a autoanálise diz aprovável e o GitHub deixa mergear.

Jira

Um site do Jira por organização do GitHub. Antes de abrir a revisão, o Farol descobre o site pela org dona do PR e lê o card, com os critérios de aceite.

Do primeiro site cadastrado em diante, o Farol assume todos os MCPs das sessões de revisão e de autoanálise, e remove os outros conectores delas. Vale inclusive em PR de organização que não tenha site aqui, pra nenhuma sessão alcançar o Jira de outra empresa.

Sincronização entre dispositivos

Opcional. Evita que dois aparelhos seus revisem o mesmo PR e mostra o consumo de todos juntos. Cada aparelho continua com o próprio histórico e funciona sem internet.

Nenhum prompt, diff, relatório ou título de PR sai daqui. Sobem em claro o SHA do commit analisado (no lease e no recibo; ele pode levar direto ao repositório, quando o repositório é público), o nome do aparelho (vazio usa o nome da máquina), o sistema operacional, a versão do Farol e, no consumo, o modelo, o perfil, os tokens e o custo de cada sessão, além de identificadores e horários de cada análise. Conta do GitHub e PR sobem como resumo SHA-256 sem chave: quem já conhece o nome consegue conferir.

Aparelhos

Os aparelhos da sua conta de sincronização, quem administra o conjunto e o que cada um aceita receber. Aposentar não apaga nada e pode ser desfeito.

Grupos de consumo

Um grupo soma o gasto dos perfis vinculados em todos os aparelhos e pode ter um teto. Só o admin cria e ativa. Enquanto o teto não está ativo, quem segura sessão é o orçamento de cada perfil.

Plano e chaves

A assinatura do Claude que paga as revisões. Um perfil por assinatura, e cada conta do GitHub pode usar um perfil diferente.

Cada perfil aponta pra um diretório de config próprio. Faça claude login nesse diretório uma vez, FORA do Farol (ex.: $env:CLAUDE_CONFIG_DIR="C:\caminho"; claude login), antes de usá-lo aqui. O perfil padrão vale pra toda conta do GitHub que não tiver um perfil próprio (dropdown na conta, seção Contas). Sem nenhum perfil salvo, o Farol usa o login padrão da máquina.

Reviewers por projeto

Um grupo padrão por organização, aplicado num clique pelo botão Reviewers em Meus PRs. Só os repos que fogem do padrão aparecem como exceção.

Por repo, escolha as pessoas e times da lista (sem digitar handle na mão). É o que o botão "Reviewers" (em Meus PRs) aplica num clique.

Preferências

Exibição, avisos e inicialização.

Identidade nos cards

Quanto marcador de conta aparece em cada card na visão Todas. A borda esquerda do card não entra aqui: ela indica urgência. Vale só neste computador.

Contas silenciadas

Como as contas silenciadas aparecem na visão Todas. Elas seguem acessíveis ao selecionar a conta na barra. Vale só neste computador.

Som ao chegar PR novo Um toque curto quando entra PR novo na tua fila. Destaques do time Mostra a aba Destaques e registra momentos exemplares encontrados nas revisões. Suas autoanálises também entram, então você faz parte do time exibido. Desligar oculta a função e para novos registros, sem apagar o histórico existente. Entregas Mostra a aba Entregas e consulta no GitHub os PRs mergeados das organizações monitoradas. Esta função não usa IA; desligá-la evita as chamadas ao GitHub e o processamento local quando você não utiliza essa visão. Iniciar com o Windows O Farol abre junto com o sistema e fica monitorando em segundo plano.

Novidades

O que mudou em cada versão. A que você tem instalada aparece marcada.

Diagnóstico

Uma visão só: as falhas registradas com o que fazer, o log e o diagnóstico com o Claude. Ver e copiar não executam nada e não enviam o diagnóstico a ninguém; a cópia é texto, com segredos mascarados e menções desligadas.

Registrar processos (diagnóstico) Ferramenta pra caçar "terminal piscando": registra cada comando que o Farol dispara, com horário, em workspace/state/spawns.log (só o comando, nunca token). Vem desligado; ligue só pra capturar a evidência de um flash e depois desligue.

Falhas registradas

apagar o log não apaga estas

Log de falhas

Só falhas, sem ruído: é o que o diagnóstico com o Claude lê, em sessão somente leitura.

…

Sobre o Farol

O compromisso de privacidade, a licença e quem constrói o projeto.

Privacidade

O Farol não coleta nem envia nenhum dado a quem o mantém. Não existe telemetria nem servidor do projeto: tudo o que o app registra fica na sua máquina, em ~/.farol (log de falhas, consumo, decisões de review, configurações).

O tráfego de rede é todo em seu nome, com as suas credenciais: GitHub pelo seu gh e o provedor de IA pelo Claude Code ou Codex CLI configurado. As automações que postam review são opt-in, e quem as liga responde pelo que é postado.

Licença

Software livre sob a licença MIT, distribuído no estado em que se encontra, sem garantia. O texto completo está no arquivo LICENSE do repositório.

Analisando agora

Precisa de você

Esperando o CI (aprova sozinho)

Sua fila

Esperando colocação no conjunto

Comandos enviados deste aparelho

Tomadas feitas por este aparelho

Revisões recentes

Revisões de todos os aparelhos

Enviar o histórico deste aparelho

O que é só deste aparelho

Meus PRs

Panorama

Entregas

Destaques do time

Kudos compilados

Memória do time

Consumo

Justiça de fila

Linha do tempo

Tipo × Modelo

Orçamento por perfil

Sessões recentes

Visão geral

Contas

Automação

Merge em Meus PRs

Jira

Sincronização entre dispositivos

Aparelhos

Grupos de consumo

Plano e chaves

Reviewers por projeto

Preferências

Novidades

Diagnóstico

Diagnóstico desta máquina

Falhas registradas

Diagnóstico

Log de falhas

Sobre o Farol

Privacidade

Licença

Créditos