Comando hermes slack — Referência Completa e Exemplos

Visão Geral

hermes slack fornece utilitários de integração com o Slack para o Hermes. Ele tem um único subcomando, manifest, que imprime ou grava um manifest de app do Slack com cada comando do gateway registrado como comando de barra nativo (/btw, /stop, /model, …). Cole o manifest na configuração do seu app do Slack para conectar seu workspace ao gateway do Hermes.

hermes slack manifest

Subcomandos

manifest

Gera um manifest de app do Slack que registra cada comando do gateway no registro de comandos como um comando de barra de primeira classe. Cole a saída em Configuração do app do Slack → Recursos → App Manifest → Editar e salve. Reinstale o app se o Slack solicitar.

Opção	Descrição
`--write [PATH]`	Grava o manifest em um arquivo em vez de stdout. Sem PATH, grava em `$HERMES_HOME/slack-manifest.json`
`--name NAME`	Nome de exibição do bot (padrão: `Hermes`)
`--description DESCRIPTION`	Descrição do bot exibida no diretório de apps do Slack
`--long-description TEXT`	Define a descrição longa do app (175–4.000 caracteres)
`--long-description-file PATH`	Lê a descrição longa de um arquivo de texto UTF-8 (175–4.000 caracteres)
`--slashes-only`	Emite apenas o array `features.slash_commands` (para mesclar manualmente em um manifest existente)
`--no-assistant`	Omite o modo Slack AI Assistant; DMs aparecem como um chat plano onde comandos de barra simples (`/help`, `/new`) funcionam inline
`--agent-view`	Emite a experiência de mensagens Agent do Slack em vez da `assistant_view` legada; não pode ser revertida no Slack após aplicar o manifest

Cenários Comuns

Configuração inicial

hermes slack manifest
# Imprime um manifest.json completo em stdout

# 1. Acesse https://api.slack.com/apps
# 2. Criar novo app → A partir do manifest
# 3. Cole o manifest gerado
# 4. Instale o app no seu workspace

Salvar em um arquivo

hermes slack manifest --write
# Grava em $HERMES_HOME/slack-manifest.json

hermes slack manifest --write ./slack-manifest.json
# Ou em um caminho personalizado

Personalizar o bot

hermes slack manifest --name "Hermes Bot" --description "Assistente de IA conectado pelo gateway do Hermes"

Mesclar em um manifest existente

hermes slack manifest --slashes-only
# Emite apenas o array slash_commands para mesclagem manual

Escolher a experiência de mensagens

hermes slack manifest --agent-view
# Usa a experiência de mensagens Agent do Slack (não pode ser revertida depois)

Dicas

manifest é o único subcomando de hermes slack
--write sem PATH salva em $HERMES_HOME/slack-manifest.json
Após aplicar um manifest, reinstale o app se o Slack solicitar
--agent-view muda a superfície de mensagens do app e não pode ser revertido após a aplicação
Use --slashes-only quando mantiver um manifest existente manualmente