Usar o Hermes pelo terminal

O comando hermes, executado pelo usuário que instalou o agente, abre uma conversa no próprio terminal da VPS. A interface padrão, chamada de CLI clássica, funciona como cliente: ela abre um WebSocket local até o processo do profile que executa o agente. Por isso fechar o terminal só desconecta a conversa. A tarefa em andamento continua rodando no servidor.

A outra interface é a TUI, aberta com hermes --tui. Ela usa o mesmo agente e as mesmas sessões da CLI clássica, com a lista completa de comandos de barra. A diferença fica na tela: a escolha do modelo, a lista de sessões e as aprovações de comandos aparecem em janelas sobre a conversa. O campo de mensagem também aceita texto enquanto o agente ainda carrega. A documentação recomenda a TUI para o uso interativo, embora a CLI clássica continue como padrão da instalação.

Abra a primeira sessão pela TUI

Conecte-se à VPS com o administrador e abra a sessão do usuário hermes, como no guia de instalação. Em seguida, abra a TUI:

1
sudo -iu hermes
2
hermes --tui

Na primeira abertura, a TUI instala as dependências de Node.js dela na pasta ui-tui/node_modules, uma etapa que não se repete. A barra de status mostra starting agent… enquanto o agente carrega e ready quando ele aceita mensagens. Sem um modelo configurado, o agente ainda não responde. O guia do modelo, na etapa seguinte da trilha, resolve essa parte.

Para o comando hermes abrir a TUI por padrão, grave a opção display.interface: tui no arquivo ~/.hermes/config.yaml. Com essa opção gravada, hermes --cli abre a CLI clássica numa execução avulsa.

Retome uma sessão anterior

O Hermes grava cada sessão no banco ~/.hermes/state.db, com o histórico das mensagens e um índice de busca. A opção -c retoma a sessão mais recente. Já a --resume aceita o identificador ou o título de uma sessão específica:

1
hermes --tui -c
2
hermes --tui --resume "nome da sessão"
3
hermes sessions list

O hermes sessions list mostra as sessões gravadas. Dentro da conversa, o comando /title dá um nome à sessão atual, o que facilita encontrar a mesma conversa depois com --resume.

Comandos de barra do dia a dia

Os comandos começam com /. A tabela vale para a TUI, que tem a lista completa. A CLI clássica, como cliente do gateway, aceita só um conjunto menor: /model, /help, /quit, /stop, /approve, /answer, /branch, /compress e /yolo. Os outros respondem Unsupported gateway CLI command; use /help. Os mais usados na trilha são estes:

Cada skill instalada também vira um comando de barra com o nome dela, na TUI e na conversa com o bot. O guia de skills mostra como instalar e chamar esses comandos.

Atalhos de teclado

A tecla Enter envia a mensagem. Para quebrar a linha sem enviar, use Alt+Enter ou Ctrl+J. O Shift+Enter também quebra a linha, mas só nos terminais que distinguem essa combinação do Enter. O Ctrl+G abre o texto digitado no editor definido em $EDITOR, útil para mensagens longas.

O Ctrl+C age em etapas. Com texto digitado, ele apaga o rascunho. Com o campo vazio, ele interrompe o agente. Dois Ctrl+C em menos de dois segundos fecham o Hermes.