Hronaut

Navegador local persistente para agentes de codificação MCP. Mantenha abas, logins e espaços de trabalho isolados entre sessões; inspecione aplicativos localhost e pause para assumir o controle humano. Windows, macOS e Linux. Código-fonte disponível; gratuito para uso não comercial permitido, comercial US$ 10/mês ou US$ 60/ano por usuário.

GitHub

Experimente este MCPPatrocinado

Documentação

Hronaut

O Hronaut é um navegador Electron visível e persistente que expõe espaços de trabalho duráveis para agentes por meio do MCP. Ele mantém o navegador aberto independentemente de qualquer sessão individual de IA, para que as pessoas possam observar, pausar e assumir o controle enquanto os agentes trabalham em perfis de navegador locais separados.

Website · Configuração · Guia de decisão do Browser MCP · Downloads · Problemas · Referência detalhada

Veja o Hronaut em ação

Assista à visão geral do produto em 35 segundos e baixe o Hronaut para Windows, macOS ou Linux.

Não tem certeza de qual modelo de navegador se encaixa no seu fluxo de trabalho? Leia o Guia de decisão do Browser MCP com base em fontes, que compara o Hronaut com o Playwright MCP, o Chrome DevTools MCP e um Browser MCP baseado em extensão, sem afirmar que a persistência é exclusiva.

Comece em três etapas

Baixe a versão mais recente do Hronaut para Windows, macOS ou Linux e inicie-o.
Na página inicial do Hronaut, escolha seu agente de codificação e copie a configuração gerada, ou use o guia de configuração genérico. A configuração no aplicativo sempre reflete o endpoint local atual e a escolha de autenticação.
Pergunte ao agente conectado: Using Hronaut, create a new isolated workspace named “Hronaut first run”, open https://example.com, take a semantic snapshot, and tell me the page heading. Do not use the Default workspace.

Uma execução bem-sucedida permanece visível no Hronaut, cria um espaço de trabalho isolado e continua disponível após o término da conversa com o agente de codificação.

Pronto para uma tarefa real? Use os fluxos de trabalho iniciais prontos para copiar para transferência autenticada, QA em localhost e revisão responsiva, sem enfraquecer os limites de espaço de trabalho e privacidade do Hronaut.

Funciona com seu agente de codificação

Conecte-se por meio do endpoint MCP HTTP Streamable local do Hronaut. Escolha o guia focado para seu cliente ou comece com a configuração genérica:

Agentes de terminal e desktop: Codex, Claude Code, Gemini CLI, Goose, OpenCode, Devin Local, Mistral Vibe, Grok Build, Qwen Code e Warp.
Agentes de editor: Cursor, VS Code / GitHub Copilot, Cline, Zoo Code, Kiro, Kilo Code, JetBrains Junie, Zed e Windsurf.
Outros clientes: use a configuração genérica de HTTP Streamable.

Quando o Hronaut é o navegador certo

O Hronaut se encaixa quando você já tem um agente de codificação e deseja que o navegador permaneça local, visível e reutilizável após uma tarefa ou conversa terminar.

Mantenha sites autenticados em espaços de trabalho nomeados e isolados, em vez de reconstruir o estado de login para cada sessão de agente.
Observe o trabalho enquanto ele acontece, pause o acesso do agente, bloqueie a interação com o site ou assuma a mesma aba para CAPTCHA, 2FA, pagamento e outras etapas exclusivamente humanas.
Retome um espaço de trabalho de navegador deliberadamente delimitado em sessões MCP locais compatíveis com seu recurso de tarefa privada, sem expô-lo a outros clientes conectados ou conectar o agente ao seu perfil de navegador do dia a dia.
Preserve abas e evidências entre sessões de codificação para depuração, QA autenticado e transferências entre múltiplos agentes.

Explore os fluxos de trabalho com base em fontes para transferência autenticada de navegador, espaços de trabalho paralelos de agentes, QA em localhost, carteiras Web3 locais e confiança em segurança e lançamentos.

Use um navegador headless de propriedade da tarefa ou uma biblioteca de automação quando o navegador deve ser descartável ou incorporado ao seu próprio runtime de agente. Use um serviço de navegador hospedado quando precisar de regiões remotas, proxies gerenciados, stealth ou execução em escala de frota. O guia de decisão cobre as compensações em mais detalhes.

Destaques

Abas persistentes, cookies, armazenamento, sessões, espaços de trabalho, visualizações divididas e estado da janela.
Pré-visualizações de abas pesquisáveis com visualizador de página inteira, tratamento inconfundível da aba ativa e layouts de abas no topo ou no lado esquerdo recolhível.
Dez opções de aparência: Sistema, Claro, Escuro, Meia-noite, Sépia, Cyberpunk, Cyberpunk Turbo, Matrix, Máquina e Galáctico.
Endpoint MCP HTTP Streamable local com ferramentas de navegação, interação, inspeção, diagnóstico, downloads, armazenamento e acessibilidade do navegador.
Espaços de trabalho multiagente com perfis de navegador isolados, acesso delimitado por conexão e recursos privados de retomada seguros contra reinicialização.
Listas de permissão de acesso a sites opcionais e confiáveis que cobrem navegação direta, redirecionamentos, ações de página, pop-ups e histórico, sem conceder mudanças de política aos agentes.
Bloqueios de interação humana, pausa instantânea do MCP, permissões explícitas e autenticação opcional por token de portador.
Modo independente Seguir agentes que mantém a aba do agente ativo visível sem assumir o foco do teclado ou do mouse.
Histórico integrado, favoritos, downloads, cofre de senhas, controles de site, pré-visualização responsiva, comparação visual e diagnóstico do Chromium.
Verificações automáticas de atualização contra lançamentos públicos do GitHub; downloads e instalação sempre exigem ação do usuário.
Idiomas de interface: inglês, ucraniano, russo, alemão, francês, espanhol e polonês.

Instalação

Baixe o pacote mais recente para Windows, macOS ou Linux em GitHub Releases.

Requisitos para Mac: macOS 13 Ventura ou posterior, em Apple Silicon ou Intel. Verifique sua versão do macOS em menu Apple → Sobre Este Mac antes de baixar.

No Windows x64, instale a versão portátil verificada e o atalho do Menu Iniciar com o Scoop:

scoop install https://raw.githubusercontent.com/hronaut/hronaut/main/packaging/scoop/hronaut.json

O binário do Windows permanece não assinado e os pacotes do macOS não são notarizados pela Apple, portanto o SmartScreen do Windows ou o Gatekeeper do macOS podem exibir um aviso. Verifique os downloads com o arquivo hashes.txt publicado e as atestações de artefatos do GitHub.

Verificar um download não assinado

Mantenha o pacote baixado em um único diretório, substitua PACKAGE_FILENAME abaixo pelo nome exato do arquivo e use a GitHub CLI para verificar tanto o pacote quanto o manifesto de soma de verificação em relação ao fluxo de trabalho de lançamento deste repositório:

gh release download --repo hronaut/hronaut --pattern hashes.txt
gh attestation verify hashes.txt --repo hronaut/hronaut
gh attestation verify "./PACKAGE_FILENAME" --repo hronaut/hronaut

Calcule o digest SHA-256 do pacote com o comando para sua plataforma:

# Linux
sha256sum "./PACKAGE_FILENAME"

# macOS
shasum -a 256 "./PACKAGE_FILENAME"

# Windows PowerShell
Get-FileHash .\PACKAGE_FILENAME -Algorithm SHA256

Compare o resultado com o nome de arquivo correspondente em hashes.txt. Atestações e hashes estabelecem proveniência do fluxo de trabalho de lançamento e integridade do arquivo; eles não tornam esses pacotes assinados com código de plataforma ou notarizados pela Apple. O guia de confiança em lançamentos explica o limite e verificações adicionais.

Executar a partir do código-fonte

Requisitos: Node.js 22 ou mais recente e uma sessão gráfica Linux, macOS ou Windows.

npm install
npm run dev

Compile e execute o aplicativo desktop:

npm run build
npm start

O desenvolvimento usa um perfil hronaut-dev persistente separado. As versões instaladas usam o perfil normal do Hronaut.

Conectar um cliente MCP

Inicie o Hronaut e configure um cliente HTTP Streamable com o endpoint local:

{
  "mcpServers": {
    "hronaut": {
      "url": "http://127.0.0.1:47812/mcp"
    }
  }
}

O guia de configuração público fornece comandos testados para Codex, Claude Code, Gemini CLI, Goose, Cursor, Cline, Zoo Code, Kilo Code, JetBrains Junie, Devin Local, Zed, Mistral Vibe, Grok Build, Qwen Code, Warp, Windsurf, VS Code/GitHub Copilot, OpenCode e clientes MCP genéricos. A página inicial do Hronaut contém a versão atual específica do perfil para cada cliente integrado, incluindo o endpoint correto e as configurações de autenticação.

Clientes compatíveis também recebem instruções concisas do servidor durante a inicialização do MCP: crie primeiro um espaço de trabalho isolado novo, prefira snapshots semânticos e refs, e solicite atenção humana apenas para uma etapa genuinamente manual. Essas instruções melhoram a seleção de ferramentas, mas não substituem os limites de espaço de trabalho e interação aplicados pelo Hronaut.

Instalar a Habilidade de Agente do Hronaut

Agentes de codificação com suporte a habilidades podem instalar a orientação portátil de fluxo de trabalho do Hronaut diretamente deste repositório:

npx skills add hronaut/hronaut --skill hronaut

A habilidade ensina o agente a criar seu próprio espaço de trabalho isolado, preferir interações semânticas de página, preservar o espaço de trabalho Padrão do usuário e solicitar uma transferência humana segura para CAPTCHA, 2FA ou entrada de credenciais. Ela não configura a conexão MCP nem contém um token de autenticação; inicie o Hronaut e copie a configuração atual do cliente na página inicial do Hronaut primeiro.

Depois de experimentar, compartilhe um relatório de configuração curto—conexões bem-sucedidas também são úteis. O formulário estruturado pergunta sobre o cliente, o sistema operacional, a versão do Hronaut e o resultado. Nunca inclua credenciais, tokens MCP, dados privados de página ou informações pessoais de sessão de navegador em um problema público.

Primeira execução bem-sucedida

Depois que seu cliente informar que o Hronaut está conectado, cole isto no agente de codificação:

Using Hronaut, create a new isolated workspace named “Hronaut first run”, open https://example.com, take a semantic snapshot, and tell me the page heading. Do not use the Default workspace.

A página inicial do Hronaut fornece o mesmo prompt com um botão de copiar. Uma execução bem-sucedida cria visivelmente um espaço de trabalho separado, abre a página e registra atividade de ferramenta sem conteúdo na página inicial; o espaço de trabalho e seu perfil de navegador permanecem disponíveis após o término da conversa com o agente de codificação.

OpenCode

Para um novo perfil do Hronaut com autenticação MCP desativada, adicione este servidor ao ~/.config/opencode/opencode.json global ou ao opencode.json de um projeto:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "hronaut": {
      "type": "remote",
      "url": "http://127.0.0.1:47812/mcp",
      "enabled": true,
      "oauth": false
    }
  }
}

Inicie o Hronaut e verifique a conexão com opencode mcp list. Se a autenticação MCP estiver ativada, copie a configuração do OpenCode da página inicial do Hronaut; ela referencia o arquivo de token exclusivo do proprietário sem colocar o token no JSON. Use opencode mcp debug hronaut para diagnosticar falhas de conexão ou autenticação. O guia focado de browser MCP do OpenCode do Hronaut inclui configuração estável e V2, verificação, limites de segurança e compensações de propriedade do navegador. Consulte o guia MCP oficial do OpenCode para o esquema estável atual.

Gemini CLI

A página inicial do Hronaut gera a entrada atual de ~/.gemini/settings.json no nível do usuário com o campo httpUrl documentado do Gemini CLI e cabeçalhos com reconhecimento de autenticação. Após salvá-la, execute gemini mcp list para verificar se o Hronaut está conectado. O guia público de browser MCP do Gemini CLI cobre configuração, verificação observável, compensações do ciclo de vida do navegador e limites de segurança. Consulte o guia oficial de servidor MCP v0.57.0 do Gemini CLI para o esquema de configuração verificado.

Goose

A página inicial do Hronaut gera a entrada de extensão streamable_http persistente do Goose para ~/.config/goose/config.yaml no macOS/Linux ou %APPDATA%\Block\goose\config\config.yaml no Windows. Perfis protegidos referenciam HRONAUT_MCP_TOKEN do ambiente em vez de incorporar o token do proprietário no YAML. Reinicie as sessões existentes do Goose após editar o arquivo e execute goose info -v para verificar a configuração ativa. Consulte o guia focado de browser MCP do Goose e a referência oficial de configuração do Goose.

Cline

A página inicial do Hronaut gera a definição explícita de servidor streamableHttp do Cline com aprovação ativada e cabeçalhos com reconhecimento de autenticação. Adicione-a pelo painel de Servidores MCP do Cline ou pelo gerenciador de CLI e execute cline config mcp --json para verificar o servidor ativado. O guia público de browser MCP do Cline explica quando usar o navegador integrado com escopo de tarefa do Cline e quando um espaço de trabalho persistente do Hronaut de propriedade separada é útil. Consulte o guia MCP oficial do Cline para o esquema de configuração atual.

Zoo Code

O Hronaut Home gera a definição global do servidor streamable-http do Zoo Code com uma lista alwaysAllow vazia. Perfis protegidos referenciam HRONAUT_MCP_TOKEN por meio da expansão ${env:...} do Zoo Code, mantendo o token do proprietário fora do JSON. Abra Zoo Code → MCP Servers → Edit Global MCP, salve a configuração gerada, reinicie o editor após alterar o ambiente e confirme que hronaut está conectado. Consulte o guia focado do Zoo Code para MCP de navegador, o guia oficial de MCP do Zoo Code e sua fonte de configuração.

Kilo Code

O Hronaut Home gera a entrada MCP remota global ~/.config/kilo/kilo.jsonc do Kilo Code com uma referência ao arquivo de token do proprietário quando a autenticação está habilitada. Execute kilo mcp list para verificar a conexão local. Use o navegador integrado do Kilo para automação descartável vinculada à tarefa; use o Hronaut quando um workspace nomeado visível precisar sobreviver à tarefa e permanecer disponível para o Kilo CLI, a IDE ou outro cliente local. Os Cloud Agents atuais do Kilo não conseguem acessar o endpoint de loopback do Hronaut. Consulte o guia focado do Kilo Code para MCP de navegador e o guia oficial de MCP do Kilo.

JetBrains Junie

O Hronaut Home gera a entrada MCP remota ~/.junie/mcp/mcp.json de nível de usuário do Junie para o endpoint local atual. A mesma configuração é compartilhada pelo Junie CLI e pelo Junie nas IDEs JetBrains. Abra a tela /mcp do Junie para verificar se o Hronaut está ativo. Quando a autenticação está habilitada, o Hronaut usa um espaço reservado de token seguro para cópia em vez de exibir o token do proprietário; cole o token localmente e não o envie em um .junie/mcp/mcp.json com escopo de projeto. Consulte o guia focado do JetBrains Junie para MCP de navegador e o guia oficial de configuração de MCP do Junie.

Devin Local

O Hronaut Home gera a entrada ~/.config/devin/mcp_config.json de nível de usuário do Devin Local no macOS e Linux ou %APPDATA%\devin\mcp_config.json no Windows. Ele usa o transporte HTTP atual e, quando a autenticação está habilitada, referencia o arquivo de token do proprietário do Hronaut sem incorporar o token no JSON. Execute devin mcp list e devin mcp get hronaut para verificar o servidor salvo. Esta configuração local também atende ao agente padrão em novas guias do Devin Desktop; o Devin Cloud não consegue acessar o endpoint de loopback do Hronaut. Consulte o guia focado do Devin Local para MCP de navegador e o guia oficial de configuração de MCP do Devin.

Zed

O Hronaut Home gera a entrada context_servers de nível de usuário do Zed para o endpoint de loopback atual. Para um perfil Hronaut desprotegido, ele inclui um cabeçalho de marcador local não secreto, impedindo que o Zed inicie um fluxo OAuth que o Hronaut não implementa; perfis protegidos recebem um espaço reservado de token do proprietário seguro para cópia. Verifique o servidor ativo em Settings → AI → MCP Servers e confirme o status verde Server is active. O Zed Agent usa o servidor diretamente e pode encaminhá-lo para agentes ACP externos, enquanto os threads do terminal usam a própria configuração de MCP do CLI. Consulte o guia focado do Zed para MCP de navegador e a documentação oficial de MCP do Zed.

Windsurf

O Hronaut Home gera a entrada ~/.codeium/windsurf/mcp_config.json de nível de usuário do Windsurf Cascade com o endpoint HTTP Streamable atual. Perfis protegidos usam a interpolação de arquivos do Windsurf para ler o token exclusivo do proprietário localmente em vez de incorporá-lo no JSON. Abra Cascade → MCPs após salvar e confirme que hronaut está conectado. Consulte o guia oficial de configuração de MCP do Windsurf.

Grok Build

O CLI oficial do Grok Build sob licença Apache-2.0 pode conectar-se diretamente ao endpoint MCP HTTP local do Hronaut:

grok mcp add --transport http hronaut http://127.0.0.1:47812/mcp
grok mcp doctor hronaut

Para um perfil protegido, copie o comando com reconhecimento de autenticação do Hronaut Home. Ele armazena um cabeçalho Authorization que referencia HRONAUT_MCP_TOKEN; o Grok expande a variável de ambiente ao carregar ~/.grok/config.toml, portanto, o token do proprietário não é copiado para o arquivo de configuração. Consulte o guia oficial de servidor MCP da xAI.

Esta integração local é para o Grok Build. O Grok hospedado na web e o bot do X não conseguem acessar um servidor Hronaut somente de loopback; o Hronaut não recomenda publicar seu endpoint de controle de navegador por meio de um túnel público.

O servidor escuta apenas em loopback. A autenticação é opcional para um novo perfil e pode ser habilitada em Settings → MCP security.

Verificações de desenvolvimento

npm run lint
npm test
npm run build
npm run test:integration:headless

O empacotamento e a publicação de versões são centralizados em .github/workflows/release.yml. Todo comando de pacote local usa --publish never.

Licença

O Hronaut está disponível com código-fonte sob a Licença Não Comercial PolyForm 1.0.0. Usos não permitidos por essa licença exigem uma licença de assinatura comercial ativa.

Contribuições externas são bem-vindas sob os termos em CONTRIBUTING.md. Relatórios de segurança devem seguir a política de segurança.

Para suporte de cobrança e licenciamento, entre em contato com support@hronaut.dev.

Documentação

A referência detalhada cobre o comportamento do navegador, limites de privacidade e segurança, todos os grupos de ferramentas MCP, testes, empacotamento e operações de versão.

Carteiras Web3 locais

O Hronaut pode manter contas EVM, Solana e Tron locais separadas, anexá-las a workspaces selecionados e mediar solicitações de sites ou agentes de codificação por meio de simulação, verificações de políticas e aprovação confiável do Hronaut. Chaves privadas e frases de recuperação não são retornadas a páginas da web ou clientes MCP. A mainnet usa como padrão a aprovação humana explícita. Uma carteira de agente EVM dedicada pode optar por uma política exata e de curta duração Bypass Approve com limites completos de transação e gastos; sites e todas as solicitações de mainnet ilimitadas ou não suportadas ainda exigem uma pessoa.

Consulte docs/WALLETS.md para o modelo de ameaças, métodos suportados, comportamento do cofre Linux, recuperação, configuração de RPC, revogação e o limite de segurança exato. O Hronaut não usa WalletConnect, Reown, custódia hospedada ou SDKs de carteira proprietários.