Conheça a TUI: o Hermes Ganha uma Cara Moderna

Se você vem usando o Hermes através da interface de linha de comando clássica, vai adorar o que vem a seguir. A TUI (Interface de Usuário de Terminal) é a nova forma recomendada de executar o Hermes interativamente — e é uma grande evolução em polimento e usabilidade.

Pense nela como o mesmo Hermes que você conhece, mas com uma superfície mais limpa e responsiva. Mesmo agente, mesmas sessões, mesmos comandos de barra. Apenas uma visão muito melhor.

O Que Torna a TUI Especial?

A TUI não é apenas uma versão mais bonita da CLI clássica. Ela traz melhorias reais que tornam seu fluxo de trabalho diário mais suave:

Primeiro quadro instantâneo — O banner aparece antes do aplicativo terminar de carregar, então seu terminal nunca parece congelado durante a inicialização.
Entrada não bloqueante — Você pode digitar e enfileirar mensagens antes da sessão estar pronta. Seu primeiro prompt é enviado no momento em que o agente fica online.
Sobreposições ricas — Seletor de modelo, seletor de sessão, prompts de aprovação — tudo renderizado como painéis modais limpos, em vez de fluxos inline bagunçados.
Painel de sessão ao vivo — Veja ferramentas e habilidades sendo preenchidas progressivamente durante a inicialização.
Compatível com mouse — Arraste para destacar texto com um fundo uniforme. Copie com o gesto normal do seu terminal.
Sem cintilação — Atualizações diferenciais significam streaming suave e sem bagunça no histórico de rolagem após sair.

Iniciando a TUI

Começar é simples. Basta adicionar a flag --tui:

# Iniciar a TUI
hermes --tui

# Retomar a sessão mais recente
hermes --tui -c

# Retomar uma sessão específica por ID ou título
hermes --tui -r 20260409_000000_aa11bb
hermes --tui --resume "minha sessão t0p"

# Retomar a sessão mais recente de um projeto específico
hermes --tui --resume latest --in ./meu-projeto

Você também pode ativá-la via variável de ambiente:

export HERMES_TUI=1
hermes          # agora usa a TUI

Ou torná-la seu padrão permanente em ~/.hermes/config.yaml:

display:
  interface: tui   # "cli" (padrão) ou "tui"

Com display.interface: tui, um simples hermes inicia a TUI. Mas flags explícitas sempre vencem — execute hermes --cli para voltar ao REPL clássico em uma única sessão.

Um dos toques mais agradáveis: o banner de inicialização agora agrupa informações de runtime em quatro seções recolhíveis, cada uma com uma seta ▸ / ▾:

Seção	Estado padrão
Ferramentas	Aberta
Habilidades	Recolhida
Prompt do Sistema	Recolhida
Servidores MCP	Recolhida

Clique em qualquer cabeçalho de seção para alternar. A lista de Ferramentas abre por padrão porque é a seção mais consultada na inicialização. Habilidades, Prompt do Sistema e Servidores MCP permanecem recolhidas para que o banner continue compacto — mesmo se você tiver dezenas de habilidades instaladas.

Atalhos de Teclado e Comandos de Barra

Boas notícias: os atalhos de teclado correspondem exatamente aos da CLI clássica. As diferenças são todas melhorias:

Arrastar com o mouse destaca texto com um fundo de seleção uniforme
Cmd+V / Ctrl+V tenta colar texto primeiro, depois recorre à leitura da área de transferência e, por fim, ao anexo de imagem
Ctrl+X abre o alternador de sessão ao vivo
Ctrl+G abre sua entrada atual no $EDITOR para composição de prompts longos

Todos os comandos de barra funcionam sem alterações. Alguns são renderizados como sobreposições mais ricas — /help mostra um painel de comandos categorizado, por exemplo.

Requisitos

Você precisará de Node.js ≥ 20 — a TUI roda como um subprocesso iniciado a partir da CLI Python. O hermes doctor verifica isso. Na primeira execução, o Hermes instala as dependências Node da TUI (uma única vez, alguns segundos). As execuções seguintes são rápidas.

A CLI clássica continua sendo o padrão de fábrica, então você sempre pode voltar a ela. Mas depois de experimentar a TUI, talvez você não queira.