Comando hermes dashboard — Referência Completa e Exemplos

Visão Geral

hermes dashboard inicia o painel web do Hermes Agent para gerenciar configuração, chaves API, sessões e chat embutido. Você pode vinculá-lo a um host/porta personalizado, pular a compilação da UI, executar um servidor isolado para um perfil ou controlar um servidor em execução.

hermes dashboard [register] [opções]

Subcomandos

`register` — Registrar um painel auto-hospedado

hermes dashboard register

Registra um painel auto-hospedado no Nous Portal e escreve o ID do cliente OAuth em .env.

Opções

Opção	Descrição
`--port PORTA`	Porta de escuta. O padrão é `9119`. Use `0` para atribuição automática pelo SO.
`--host HOST`	Host de vinculação. O padrão é `127.0.0.1`.
`--insecure`	Depreciado / sem efeito. Desde o endurecimento de junho de 2026, ele não desativa mais a autenticação em vínculos públicos. Vínculos públicos sempre exigem um provedor de autenticação; vincule `127.0.0.1` e use um túnel para acesso local.
`--skip-build`	Pula a etapa de compilação da UI e serve o `dist/` existente diretamente. Útil em contextos não interativos (Tarefas Agendadas do Windows, CI) onde o npm pode não estar disponível. Pré-compile com `cd web && npm run build`.
`--isolated`	Quando iniciado a partir de um perfil nomeado, executa um servidor dedicado àquele perfil em vez de se conectar ao servidor no nível da máquina. O comportamento padrão é unificado.
`--stop`	Interrompe todos os processos do servidor web Hermes em execução e sai.
`--status`	Lista os processos do servidor web Hermes em execução e sai.
`--no-open`	Não abre o navegador automaticamente.

Cenários Comuns

Iniciar o painel localmente

hermes dashboard

Inicia o painel em http://127.0.0.1:9119 e abre no navegador.

Usar uma porta personalizada

hermes dashboard --port 8080

Útil quando a porta 9119 já está ocupada.

Executar sem abrir o navegador

hermes dashboard --no-open

Útil em hosts remotos ou ao executar a partir de um script.

Servir uma UI pré-compilada em CI

cd web && npm run build
cd ..
hermes dashboard --skip-build --no-open

Use --skip-build para evitar a resolução de dependências do npm em ambientes sem interface gráfica.

Verificar ou parar um servidor em execução

hermes dashboard --status
hermes dashboard --stop

Executar um painel isolado para um perfil

hermes dashboard --isolated --profile work

Executa um servidor de painel dedicado para o perfil work em vez de compartilhar o servidor no nível da máquina.

Dicas

O painel requer autenticação quando vinculado a um endereço não loopback; configure primeiro um provedor OAuth ou por senha.
Mantenha a vinculação padrão 127.0.0.1 para uso apenas local e use um túnel SSH para acesso remoto.
--skip-build ainda requer um diretório dist/ válido; compile a UI previamente.