Repolode
reticlehq

reticlehq/reticle

Um SDK e servidor MCP apenas para desenvolvimento que permite a agentes de codificação com IA controlar seu app web ou desktop em execução e devolver um veredito de aprovado, reprovado ou inconclusivo, com evidências.

Estrelas
1,276
Forks
220
Issues abertas
220
Último commit
há 17 horas

O que é?

O Reticle resolve uma lacuna comum na codificação assistida por IA: o agente escreve uma alteração, assume que ela funciona e nunca abre o app. O Reticle instala um pequeno SDK apenas para desenvolvimento dentro do seu app e expõe ferramentas via MCP para que o agente possa observar, interagir, acompanhar e verificar a aplicação em execução.

Como o SDK lê os dados de dentro da página, ele consegue ver as respostas de rede ligadas ao clique que as originou, guardar o estado de bibliotecas como zustand, Redux, TanStack Query e Pinia, registrar erros do console e o arquivo e a linha de origem de cada elemento. Cada verificação termina em um veredito de sim, não ou desconhecido, com as evidências anexadas. Fluxos salvos podem ser reexecutados depois sem usar um modelo de IA, e o `reticle gate` pode ser usado no CI para exigir uma execução aprovada quando o código coberto for alterado.

O Reticle oferece suporte a React, Next.js, Vue, Svelte, Angular e stacks web semelhantes, além de apps desktop com Electron e Tauri, e funciona com Claude Code, Cursor, Codex, Windsurf, VS Code, Gemini CLI e outros clientes MCP. A ponte escuta apenas em localhost, e os builds de produção excluem o SDK.

Recursos principais

  • 01Oferece aos agentes de codificação ferramentas para observar, interagir, acompanhar e verificar um app em execução.
  • 02Retorna vereditos de sim, não ou desconhecido, com a requisição, a mudança de estado e o arquivo:linha como evidência.
  • 03Lê respostas de rede, estado de stores, saída do console e renderizações do React de dentro da página.
  • 04Reexecuta fluxos salvos de forma determinística, sem chamar um modelo de IA.
  • 05Disponibiliza o `reticle gate` para o CI exigir execuções aprovadas quando o código coberto muda.
  • 06Exclui o SDK de builds de produção e vincula a ponte local a 127.0.0.1.

Casos de uso

  • Verificar se uma alteração feita por um agente em checkout ou login realmente funciona no app em execução.
  • Detectar falhas silenciosas, como uma resposta 500 por trás de uma mensagem de sucesso.
  • Travar jornadas críticas do usuário para que edições futuras não as quebrem sem aviso.
  • Exigir a verificação de fluxos cobertos no CI antes do merge.

Início rápido

  1. 1

    Instale o comando reticle globalmente com npm

    npm install -g @reticlehq/server
  2. 2

    Cadastre o Reticle nos seus agentes de programação

    reticle setup mcp
  3. 3

    Reinicie seu agente de programação e execute init na pasta do seu aplicativo

    reticle init

Antes de usar

  • O servidor e a CLI têm o código-fonte disponível sob a licença FSL-1.1-ALv2, mas não são software de código aberto aprovado pela OSI. Após dois anos, passarão para Apache-2.0.
  • É necessário ter Node 20.11 ou mais recente, um servidor de desenvolvimento em execução local e um agente de programação compatível com MCP.
  • Ele controla um navegador Chromium e, por padrão, a telemetria anônima de uso fica ativada, a menos que você a desative.

Tópicos

Perguntas frequentes

O que é reticle?
Um SDK e servidor MCP apenas para desenvolvimento que permite a agentes de codificação com IA controlar seu app web ou desktop em execução e devolver um veredito de aprovado, reprovado ou inconclusivo, com evidências. O Reticle resolve uma lacuna comum na codificação assistida por IA: o agente escreve uma alteração, assume que ela funciona e nunca abre o app. O Reticle instala um pequeno SDK apenas para desenvolvimento dentro do seu app e expõe ferramentas via MCP para que o agente possa observar, interagir, acompanhar e verificar a aplicação em execução.
reticle é gratuito? Qual é a licença?
reticle é open source sob a licença Other. Confira os termos da licença antes de usá-lo em produtos comerciais.
reticle ainda é mantido?
Manutenção ativa. O último commit de reticle foi em 21 de out. de 2026.
Para que posso usar reticle?
Verificar se uma alteração feita por um agente em checkout ou login realmente funciona no app em execução. Detectar falhas silenciosas, como uma resposta 500 por trás de uma mensagem de sucesso. Travar jornadas críticas do usuário para que edições futuras não as quebrem sem aviso. Exigir a verificação de fluxos cobertos no CI antes do merge.
Como instalar reticle?
Instale o comando reticle globalmente com npm: npm install -g @reticlehq/server Cadastre o Reticle nos seus agentes de programação: reticle setup mcp Reinicie seu agente de programação e execute init na pasta do seu aplicativo: reticle init
Onde consigo reticle?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/reticlehq/reticle

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados