Ghostlight

Use seu navegador Chromium real conectado a partir de qualquer agente MCP, com ações visíveis, execução local e governança opcional.

Documentação

Ghostlight mascot: a small sky-blue pixel-art ghost holding a glowing lantern

Ghostlight MCP

Dê ao seu agente um lugar no navegador que você já usa.

CI npm release MCP registry

Ghostlight reading and completing a launch brief in a real browser with visible page, field, and click feedback

Um resumo de lançamento passa de formulário vazio a pronto para revisão, com visão completa.

Instalar Ghostlight | Veja onde se encaixa | Guia de instalação | Central de confiança

Ghostlight dá a agentes de IA compatíveis um espaço de trabalho dedicado dentro do perfil Chromium que você já usa. Suas sessões conectadas estão lá. O trabalho permanece visível. Você pode pausar, assumir ou interrompê-lo a qualquer momento.

Peça a um agente para ler uma página, preencher um formulário, lidar com um arquivo, seguir um pop-up ou investigar um fluxo de trabalho web com falha. O Ghostlight conduz a tarefa entre abas e mudanças no navegador, mantendo o trabalho do navegador e seus controles na sua máquina.

Seus primeiros cinco minutos

Você precisa de Chrome, Edge, Brave ou Chromium 116+, um cliente MCP e Node.js para o instalador. O serviço que você executa depois é Rust nativo.

  1. Instale o Ghostlight e registre os clientes MCP que ele encontrar:

    npx -y ghostlight install
    
  2. Adicione Ghostlight no Navegador da Chrome Web Store.

  3. Reinicie um cliente MCP se ele não recarregar ferramentas automaticamente.

  4. Dê a ele uma pequena tarefa somente leitura:

    Abra https://example.com/ em uma nova aba do Ghostlight, resuma a página e me diga qual aba você usou. Não clique, digite, envie ou altere a página.

Um grupo Ghostlight azul-celeste deve aparecer no seu navegador. O agente abre a página, lê e nomeia a aba exata que usou. Esse único prompt prova toda a conexão sem autorizar um clique ou escrita.

Se uma etapa precisar de atenção, execute:

npx -y ghostlight doctor

doctor verifica a entrada do cliente, o serviço local, a conexão do navegador e a extensão, e então indica a próxima ação. O guia de instalação cobre clientes específicos, Homebrew, builds a partir do código-fonte, atualizações, desinstalação e recuperação orientada por sintomas.

De uma página a um fluxo de trabalho completo

O Ghostlight é melhor quando o trabalho no navegador tem um fio condutor:

  • Continue de onde você está conectado. Abra um aplicativo no perfil Chromium que você escolheu e trabalhe com a sessão já existente. As credenciais permanecem no navegador.
  • Conclua a interação. Navegue, preencha formulários, envie arquivos, resolva diálogos, aguarde o estado da página e leve os resultados de uma etapa para a próxima.
  • Acompanhe o navegador. Continue trabalhando quando um site abrir uma aba filha compatível ou quando um espaço de trabalho conhecido mudar sob a tarefa.
  • Veja o que falhou. Reúna o estado da página, mensagens do console e solicitações de rede para que o próximo passo de depuração venha de evidências em vez de suposições.

Use a mesma capacidade de navegador a partir de Codex, Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Zed, OpenCode, Crush ou outro cliente MCP stdio compatível. Os agentes recebem leituras estruturadas de página, referências exatas de elementos, recibos de ação limitados e orientação específica de recuperação. Eles podem chamar explain para o diretório de ações e capacidades ao vivo sempre que uma tarefa precisar.

O navegador permanece um espaço compartilhado

O Ghostlight funciona em um grupo de abas azul-celeste dedicado dentro da janela do navegador que você escolheu. Varreduras de página, cliques, digitação, arrastos e fases mais longas compartilham uma linguagem visual, para que o movimento na tela tenha uma explicação.

Pause o espaço de trabalho, assuma uma etapa delicada ou interrompa-o. Mova as abas para onde quiser; o Ghostlight segue o espaço de trabalho em vez de recolocá-las. Abas comuns permanecem fora do conjunto de propriedade do agente.

O uso pessoal é completo sem um manifesto de política. Comece com o mecanismo completo do navegador e faça um trabalho útil. Quando um fluxo de trabalho precisar de limites mais fortes, conceda as capacidades read, action, write e execute por identidade e domínio MCP. Adicione domínios sagrados, pré-verificação de simulação e auditoria estruturada enquanto a experiência do navegador permanece a mesma.

O guia de governança mostra o modelo operacional. A Central de Confiança contém as evidências de segurança, privacidade, continuidade, implantação e aquisição. O auxílio de decisão cobre outros modelos operacionais de navegador quando essa é a questão.

Versão atual e compatibilidade

Estado da plataforma. Windows e Linux são verificados de ponta a ponta contra navegadores reais. O macOS compila e passa na suíte de testes completa no CI; sua verificação com navegador real ainda está pendente.

Estado da extensão. A Chrome Web Store serve o adaptador Chrome v0.8.0. O adaptador Chrome v0.8.0 cobre as versões v0.8.x do serviço Ghostlight. Instale a extensão a partir da listagem pública. Veja o mapa de compatibilidade de adaptadores completo.

O serviço e o adaptador Chrome têm versões independentes. O mapa de compatibilidade é a referência autoritativa, e o arquivo de status público é o dono do estado atual de versão, plataforma e loja.

O candidato a fonte 0.8 implementa as revisões MCP stdio locais exatas 2025-11-25 e 2026-07-28. Veja o changelog para mudanças de versão e consequências de atualização.

Como o Ghostlight se encaixa
MCP Client <--stdio--> ghostlight-mcp-connector <--typed local IPC--> ghostlight service
    <--browser IPC--> ghostlight-browser-connector <--native messaging--> Extension <--CDP--> Browser

O conector é dono do estado do protocolo MCP. O serviço persistente é dono dos espaços de trabalho, coordenação do navegador, governança opcional e auditoria. O conector do navegador passa mensagens nativas, enquanto a extensão é dona do mecanismo do Chrome. Cada função pode se reconectar de forma independente.

ADR-0096 explica o limite. docs/SPEC.md fornece o modelo de governança mais profundo. O guia de instalação inclui o caminho de desenvolvimento a partir do código-fonte.

Escolha seu próximo passo

Eu quero...Comece aqui
Instalar, verificar, atualizar, recuperar ou desinstalarGuia de instalação
Deixar um cliente de IA executar a configuraçãoGuia de instalação para agentes
Experimentar um fluxo de trabalho visível completoDemonstração de resumo de lançamento
Compilar a partir do código-fonte e testar localmenteCaminho de desenvolvimento a partir do código-fonte
Entender qual modelo operacional de navegador se encaixaAuxílio de decisão
Adicionar limites ou revisar evidências de confiançaGuia de governança e Central de Confiança
Contribuir com código, documentação, testes ou ideiasGuia de contribuição
Ler as decisões de arquiteturaÍndice de ADR

Licença e continuidade

O mecanismo de automação do navegador fora de crates/core/src/governance/ é Apache-2.0 OU MIT. O módulo de governança é de código-fonte disponível sob a Licença Comercial Ghostlight e é gratuito para indivíduos, equipes de até cinco pessoas, avaliação, desenvolvimento, operação totalmente aberta e uso não comercial qualificado. LICENSING.md mapeia o limite exato.

O estado da licença nunca altera o comportamento em tempo de execução. Uma cópia instalada não chama um serviço Ghostlight para telemetria, ativação ou atualizações, e continua funcionando sem o fornecedor. A Promessa de Continuidade e o PRICING.md contêm os termos duradouros.

Perguntas e contribuições

Use GitHub Issues para defeitos reproduzíveis e GitHub Discussions para perguntas e ideias. Use hello@sylin.org para segurança, licenciamento ou informações que não podem ser públicas.

CONTRIBUTING.md explica os limites do projeto, as expectativas de teste e as formas de participar.