AI review & human-in-the-loop

Human Review

Um editor visual local para o HTML e o Markdown que seu agente de IA produz — edite no lugar, comente como num documento e devolva o lote inteiro de uma vez

petergyang/human-reviewJavaScript1,023 as of 2026-08-17
By Jake Luo · Published 17 de ago. de 2026

Human Review é uma ferramenta de linha de comando com licença MIT que abre no seu navegador, como documento editável, um arquivo HTML ou Markdown gerado por IA — ou uma página rodando em localhost. Você corrige o texto direto, reorganiza blocos e deixa comentários ancorados a uma frase ou elemento específico, e então envia todas as edições e comentários ao seu agente em um único lote, em vez de descrever as mudanças no chat. Tudo roda na sua própria máquina: o README afirma que não precisa de conta, serviço em nuvem, banco de dados nem chave de API.

O que é o Human Review

O Human Review (github.com/petergyang/human-review) é uma CLI pequena em JavaScript, licenciada sob MIT, publicada pela primeira vez no fim de julho de 2026. Você o instala como uma skill que seu agente pode invocar, ou executa direto com npx, e então aponta para um arquivo — `/human-review (seu arquivo)` — e ele abre esse arquivo no navegador como uma página editável. O problema que ele nomeia é conhecido: dar feedback a um agente no chat significa escrever um parágrafo do tipo "na terceira seção troque X por Y, corte o card que repete o primeiro, reescreva a chamada para ação", e depois reler o arquivo inteiro para conferir o que o modelo entendeu.

  • Edite a saída diretamente. Altere o texto no lugar com formatação básica, faça listas com marcadores e numeradas, adicione ou edite links com um atalho de teclado, redimensione imagens arrastando um canto, mova imagens e arraste blocos inteiros para reorganizar a página.
  • Comente como num documento. Selecione uma frase e deixe um comentário ancorado exatamente naquele texto, ou clique numa imagem, gráfico ou seção para comentar o elemento. Apagar algo não exige explicação no chat: você simplesmente remove.
  • Envie tudo de uma vez. Um único Send entrega ao seu agente todas as edições e comentários juntos, e ele aplica no código-fonte e atualiza a página para outra passada. Clicar em links com a tecla de comando permite revisar várias páginas na mesma sessão sem perder feedback pelo caminho.
  • Revise um app rodando, não só um arquivo. Apontá-lo para uma URL de localhost revisa a página ao vivo. O README é preciso sobre a diferença: em arquivos HTML, edições diretas e redimensionamentos salvam automaticamente, enquanto Markdown e localhost precisam do Send para o agente aplicá-los no código-fonte.

Onde ele entra na pilha de um fundador

Isto não é uma ferramenta de crescimento, e vale dizer com clareza. Ele fica uma camada antes, na ida e volta que todo fluxo com IA cria e que quase nenhum resolve: a lacuna entre o agente produziu algo e isto está certo. Descrever edições em prosa perde informação nos dois sentidos: você demora mais para especificar a mudança do que para fazê-la, e depois ainda precisa auditar se ela pegou. Editar o artefato diretamente elimina de vez a etapa de especificação.

O encaixe é mais nítido em páginas de marketing, que é exatamente onde a saída de um agente tem mais chance de parecer pronta e estar errada. Se você está pedindo a um modelo que construa uma landing page, a passada de revisão é toda a diferença entre um rascunho e um site — veja devo usar IA para criar meu site? para as falhas específicas que valem a caçada. O repositório é jovem e está em desenvolvimento ativo, não assentado: criado em julho de 2026, com v0.5.0 e v0.6.0 chegando com um dia de diferença no início de agosto e v0.6.1 em 2026-08-15. Espere que a interface continue mudando.

O modo de falha que uma revisão acrescenta

Colocar uma pessoa no circuito é o instinto certo, e não sai de graça: introduz um jeito novo de perder trabalho, que é a revisão que nunca acontece. Sabemos disso pela nossa própria plataforma, onde toda ação para fora que um agente propõe espera uma pessoa aprovar, e o portão é imposto em código em vez de pedido num prompt, porque uma regra no nível do prompt é um pedido e uma no nível do código não é. Das primeiras duas dúzias de solicitações de aprovação que nosso sistema produziu, exatamente metade nunca virou uma ação concluída: cinco falharam do outro lado e sete simplesmente nunca foram clicadas.

As sete são o número interessante. Ninguém as rejeitou; a fila apenas sobreviveu ao momento em que alguém se importava. Esse é o imposto que uma etapa de revisão cobra, e por isso os detalhes de projeto importam mais que o princípio: a fila precisa ser visível, o lote precisa ser pequeno o bastante para ser esvaziado de uma sentada, e a ferramenta precisa relatar o que de fato aconteceu. Essa última parte tivemos de acrescentar depois, porque um agente que não enxerga o resultado da própria aprovação vai dizer alegremente a um cliente que algo foi publicado quando não foi.

Essa fronteira é o projeto inteiro da AgentCeres — a Diretora de Crescimento com IA, em agentceres.com. Um time de especialistas redige as páginas de SEO, os posts sociais, os anúncios e a prospecção; qualquer coisa que vá para o mundo espera uma pessoa clicar em aprovar. Um editor local como o Human Review torna esse clique mais bem informado, porque revisar o artefato é melhor do que revisar uma descrição dele. O rascunho é a metade barata de qualquer jeito — veja o que um time de marketing com IA realmente consegue fazer.

FAQ

O Human Review é gratuito?
Sim. O repositório é licenciado sob MIT e tudo roda localmente — o README afirma que não exige conta, serviço em nuvem, banco de dados nem chave de API. O único custo é o agente que você já paga, já que o Human Review cuida apenas da passada de revisão e devolve as edições para o seu agente aplicar.
Com quais ferramentas de IA o Human Review funciona?
O README descreve instalá-lo como skill para agentes de programação, incluindo Claude Code e Codex, seja pedindo ao agente que instale a partir do repositório, seja com `npx -y human-review setup --global`. O repositório traz um SKILL.md que ensina um agente a operá-lo, então o público pretendido é qualquer ambiente que leia arquivos de skill.
Ainda preciso revisar se a saída da IA parece certa?
Principalmente então. Em páginas geradas, as partes com maior chance de estarem quebradas são as que aparecem perfeitamente: um formulário de contato sem destino, uma imagem que só resolve na sua máquina. Olhar a página não é o mesmo que conferi-la, e é por isso que a revisão útil é aquela em que você interage com o artefato em vez de lê-lo.
Related projects
Marketing SkillsUma coleção de código aberto com 45 skills de marketing para o Claude Code e agentes de IAASO SkillsSkills de App Store Optimization com licença MIT para Claude Code, Cursor e outros hosts de Agent Skills, com dados ao vivo da App Store opcionais via uma API comercialWebstudioConstrutor visual de sites open source —uma alternativa ao Webflow que você mesmo hospeda

You built it. Now grow it.

AgentCeres is a managed AI marketing team — specialists draft the SEO, social, and outreach that fill your links, you approve what ships. 14-day free trial, from $39/month.

Start free trialMore projects