6.2 Dashboard, gateway, túnel

🖥️ O que tem na dashboard

A web UI do Hermes (módulo web/ no repositório) é um painel completo. Não é gimmick — é interface de administração séria com tudo que você precisa para operar múltiplos agentes.

💬 Sessões

Histórico completo de conversas, com busca FTS5. Reabrir sessão antiga, exportar transcrição, podar conversas obsoletas.

📡 Canais

Lista de plataformas de mensagem ativas (Telegram, Discord, etc), status do gateway, métricas de mensagem por canal.

⏰ Crons

Todos os agendamentos ativos, próxima execução, histórico de runs, botões para pausar/editar/duplicar cron.

🛠️ Skills

Skills bundled, instaladas via hub, e custom locais. Editor de SKILL.md inline. Indicador de uso (quantas vezes invocada).

🔌 Plugins

LCM, Kanban, integrações da comunidade. Versão, status, atualizar/desabilitar com 1 clique.

🗒️ Kanban

Novo no v0.13.0. Boards com cards de tarefa, swim lanes por worker, indicadores de heartbeat e zombie.

📌 Importante

Tudo que a dashboard mostra também está em arquivos texto em ~/.hermes/. A UI é conveniência visual, não banco oculto. Você pode editar tudo via terminal e a dashboard reflete na hora.

🚪 Como abrir: SSH tunnel ou nginx

Por padrão a dashboard sobe em localhost:8080 dentro do VPS. Não é exposta na internet. Você precisa criar uma ponte segura — duas opções comuns:

🚇Opção 1: SSH Tunnel (recomendado pra uso individual)

ssh -L 8080:localhost:8080 user@vps.exemplo.com

Depois abra http://localhost:8080 no seu navegador. O tráfego trafega criptografado pelo SSH. Ninguém de fora vê nada.

🌐Opção 2: nginx reverse proxy + auth

Para múltiplos usuários ou URL fixa: configure nginx como reverse proxy com HTTPS (Let's Encrypt) e autenticação básica ou Cloudflare Access.

location / {
  auth_basic "Hermes Dashboard";
  auth_basic_user_file /etc/nginx/.htpasswd;
  proxy_pass http://localhost:8080;
}

⚠️Não fazer

Nunca abrir a porta 8080 direto na internet sem auth. Token de admin não é firewall. Mesmo que o Hermes tenha login, você está expondo superfície de ataque desnecessária.

⚡ Skill abrir-dashboard

Esquecer comando SSH a cada vez é fricção desnecessária. A skill bundled abrir-dashboard automatiza: você diz pelo Telegram "abre minha dashboard" e ela executa o tunnel local, espera a porta abrir, e te entrega o link.

🔧 O que a skill faz

Confirma que o host VPS está configurado em ~/.ssh/config
Roda ssh -fN -L 8080:localhost:8080 vps em background
Aguarda porta 8080 ficar disponível (timeout 10s)
Te entrega http://localhost:8080 clicável
Opcionalmente, abre o navegador automaticamente (em Mac/Linux com GUI)

📌 Limitação

A skill assume que sua chave SSH e host estão configurados localmente. Não funciona se o agente está rodando dentro do VPS — ele estaria tentando criar túnel pra ele mesmo. Faz sentido em setup laptop → VPS.

🗒️ Kanban view

Quando você ativa o sistema multi-agente da v0.13.0, a Kanban view se torna seu painel de comando. Layout clássico (To Do, In Progress, Done) com camadas extras pra dar visibilidade dos workers.

📋 To Do

Cards aguardando worker disponível. Cada card mostra título, descrição e contagem de retries (se houver).

⚙️ In Progress

Cards ativos com nome do worker, tempo desde início, indicador de heartbeat (verde/amarelo/vermelho).

✅ Done

Concluídas. Hallucination gate marca verde se passou, vermelho se foi rejeitada e voltou pro topo.

🎯 Sinais visuais úteis

•Heartbeat verde = worker batendo ping nos últimos 30s
•Heartbeat amarelo = worker silencioso há 1-3 min, monitorando
•Heartbeat vermelho / "zombie" = worker considerado travado, tarefa será reclaimed
•Retry count visível = você vê na hora se uma tarefa está caindo repetidamente

🔌 Manutenção dos plugins

A aba de plugins na dashboard é onde você administra extensões: LCM (compressão lossless), Kanban (multi-agente), integrações de calendário, plugins da comunidade. Atualização vira clique em vez de pull + restart manual.

🛠️ O que você administra ali

•Listar: ver todos os plugins instalados, versão atual, versão disponível
•Atualizar: 1 clique pra puxar nova versão; restart automático do plugin
•Desativar: sem desinstalar; útil pra debug ("é o plugin X que está causando isso?")
•Configurar: editar settings.yaml do plugin direto na UI
•Logs: stream de logs do plugin pra debug em tempo real

⚠️Cuidado com auto-update

Atualizar plugin pode quebrar skill que dependia da versão antiga. Em produção, leia o changelog antes de atualizar. Em desenvolvimento, atualize logo — você quer descobrir quebras cedo.

📵 Quando NÃO usar dashboard

A maioria do uso diário cabe no Telegram. Dashboard é ferramenta de manutenção, não de operação. Quem se acostuma a abrir dashboard pra qualquer coisa perde a praticidade do agente "no bolso".

✓ Telegram cobre

✓Pedir tarefas, fazer perguntas
✓Conferir cron de hoje, próximas execuções
✓Ler resumos diários/semanais
✓Ajustar memória ("anota que...")
✓Adicionar skill simples por descrição
✓Pausar/retomar cron

✓ Dashboard ganha quando

✓Editar arquivo Markdown longo (skill complexa)
✓Triar dezenas de cards Kanban
✓Buscar texto em sessões antigas
✓Atualizar 5 plugins de uma vez
✓Ver gráfico de uso de tokens
✓Configurar canais novos (Discord, Slack)

💡Regra prática

Se você consegue pedir em texto, peça via Telegram. Se está editando arquivo grande ou triando muitos itens visuais, abre dashboard. 80/20 vai pro Telegram.

🎯Resumo do módulo

✓

Dashboard cobre sessões, canais, crons, skills, plugins, configs e Kanban — tudo espelhado em ~/.hermes/.

✓

SSH tunnel é o caminho default seguro — nginx + auth para múltiplos usuários.

✓

Skill abrir-dashboard automatiza o túnel — útil em setup laptop → VPS.

✓

Kanban view mostra heartbeat por worker — verde/amarelo/vermelho indica saúde da execução.

✓

Plugins atualizam por 1 clique na UI — leia changelog antes de atualizar produção.

✓

80% do uso diário cabe no Telegram — dashboard é manutenção, não operação.

Próximo módulo:

6.3 - 🛠️ Troubleshooting completo

← Módulo Anterior Próximo Módulo →