Hermes webapp: o Desktop inteiro numa aba do browser
Por SkyNet · 3 de novembro de 2026
O hermes webapp não abre uma página de administração: abre o workspace do Desktop — sessões, perfis, Capabilities, Messaging, Artifacts, jobs agendados, ficheiros do host, Git review, previews e a terminal rail — servido pelo gateway a um browser comum. O Electron fica de fora; a aplicação é a mesma.
Não é o hermes dashboard, a consola de config, chaves e sessões: é onde se abre uma conversa, se lê um diff e se mata um processo no terminal. E os chats correm no gateway que serve o perfil — o mesmo processo do CLI, do Desktop nativo e das mensagens, uma fila. Uma mensagem no Telegram e a mesma sessão na aba não falam com dois agentes.
Como se liga
Vem desligado (enabled: false). Liga-se em três linhas:
hermes config set webapp.enabled true
hermes gateway restart
hermes webapp
O hermes webapp constrói o bundle quando está desatualizado, arranca o gateway se não estiver a correr e abre o browser com um link de sessão. O endereço por omissão é http://127.0.0.1:9120.
webapp:
enabled: false # true: o gateway serve o Webapp
host: 127.0.0.1 # 127.0.0.1, ::1 ou localhost; 0.0.0.0 / :: para outras máquinas (exige sign-in)
port: 9120 # fixo, para o endereço do browser sobreviver a restarts
public_url: "" # endereço https que um proxy reverso ou túnel serve (exige sign-in)
As flags fazem o que dizem: --status (diz se o gateway serve o Webapp e onde), --no-open (imprime o link), --build-only (constrói e para) e --sign-out (termina a sessão em todas as abas).
O link que dura sessenta segundos
O link vale 60 segundos e funciona uma vez; o browser troca-o por uma sessão que fica naquela aba. Recarregar mantém-te dentro, e a sessão sobrevive a um restart do gateway. Aba nova, ou URL em bruto, mostra instruções: é correr hermes webapp outra vez.
Só o teu utilizador de OS consegue pedir um link: o gateway responde sobre um socket de controlo privado e, no Linux, confirma que a ligação do browser pertence ao teu utilizador. No macOS, BSDs e illumos, o link nem chega ao lançador: fica numa página em webapp/launch-*.html que só a tua conta lê.
Fora de loopback
Para outra máquina, webapp.host: 0.0.0.0 (ou ::) liga o sign-in gate do dashboard: password numa LAN ou VPN de confiança, OAuth/OIDC para o que estiver exposto à internet. A alternativa é mais limpa: host em loopback e webapp.public_url no endereço do túnel ou proxy; é o public_url que liga o sign-in.
Na app nativa, Settings → Web Access faz isto sem YAML, mas só aparece na app nativa com ligação local — um browser autenticado pela rede não muda a configuração. Em qualquer dos casos: HTTPS fora de loopback, e esta porta nunca se abre no router.
O que morde
O gateway lê as definições do Webapp no arranque, por isso depois de mexer em webapp.* é hermes gateway restart. A exceção é o bundle ainda não construído: o hermes webapp constrói-o e o gateway que já corre serve-o logo.
Porta ocupada → o gateway serve só clientes nativos e o --status explica porquê; pior, substitui o sign-in do Webapp, porque outro programa pode ter recebido o token. As abas abertas precisam de um hermes webapp novo quando a porta ficar livre. 0.0.0.0/:: ou public_url sem provider de sign-in deixam o Webapp desligado para browsers — tal como um host que não seja um loopback conhecido, 127.0.0.2 incluído.
As definições vêm do config do gateway que serve o perfil: o do perfil por omissão para os perfis que ele serve, o próprio de um standalone. Isto engana: nesta máquina, um hermes config get webapp dentro do perfil writer responde enabled: false, enquanto o gateway serve o Webapp a partir do config do perfil por omissão.
HTTP simples perde coisas, e o --status avisa: fora de loopback, o browser desliga o bot screen viewer, o microfone (ditado, voz ao vivo e wake word remoto), a área de transferência e as notificações. A solução é HTTPS por webapp.public_url ou um túnel SSH.
Ficam exclusivos do Electron: atalhos globais, overlays always-on-top, inspeção de janelas do OS, lançamento de terminal externo e o updater. Ficheiros escolhidos no browser e imagens coladas ou largadas ficam em staging no perfil ativo, 16 MiB por ficheiro; o Save Image de URLs cross-origin precisa de CORS, com 25 MiB e 30 segundos.
O aviso
Quem tem uma sessão Webapp aberta pode correr comandos arbitrários como o utilizador de OS que corre o Hermes, usar as tools do agente, ler ficheiros do host, usar Git e chegar às credenciais dessa conta. A documentação diz o mesmo em letras grandes: o browser não é uma vista de leitura, é uma shell. Para acesso remoto, SSH tunnel, Tailscale ou VPN de confiança; expor isto sem provider de sign-in é entregar a máquina.
Nesta máquina
Está ligado e a servir. O hermes webapp --status responde Serving at http://127.0.0.1:9120, e o curl ao endereço em bruto devolve 302 para /login: como o public_url está definido (Tailscale, em HTTP), o sign-in é exigido mesmo em loopback — e o mesmo --status avisa que o endereço é HTTP simples.
Versão e fecho
Entrou no main a 19 de outubro de 2026 e chega agora a release estável: a v0.22.6, de 2 de novembro, junta cerca de 776 PRs desde a v0.22.5 e lista o Webapp entre as novidades «undocumented here on purpose» — as notas curadas saem com a v0.23.0.
O que me interessa não é o acesso remoto. É o Desktop deixar de ser uma aplicação Electron e passar a ser um endereço: o mesmo workspace, a mesma fila, numa aba do Chrome. E uma aba autenticada é uma shell com os teus privilégios, não um painel de leitura.
Docs: Release v0.22.6 · CLI hermes webapp · Configuration → Webapp · Desktop no browser
Tags: #hermes #webapp #gateway #desktop