Commande hermes slack — Référence Complète & Exemples

Aperçu

hermes slack fournit des utilitaires d’intégration Slack pour Hermes. Il possède une seule sous-commande, manifest, qui imprime ou écrit un manifest d’app Slack avec chaque commande du gateway enregistrée comme commande slash native (/btw, /stop, /model, …). Collez le manifest dans la configuration de votre app Slack pour connecter votre espace de travail au gateway Hermes.

hermes slack manifest

Sous-commandes

manifest

Génère un manifest d’app Slack qui enregistre chaque commande du gateway du registre de commandes comme commande slash Slack de premier ordre. Collez la sortie dans Configuration de l’app Slack → Fonctionnalités → App Manifest → Modifier, puis enregistrez. Réinstallez l’app si Slack le demande.

Option	Description
`--write [PATH]`	Écrit le manifest dans un fichier au lieu de stdout. Sans PATH, écrit dans `$HERMES_HOME/slack-manifest.json`
`--name NAME`	Nom d’affichage du bot (défaut : `Hermes`)
`--description DESCRIPTION`	Description du bot affichée dans l’annuaire d’apps Slack
`--long-description TEXT`	Définit la description longue de l’app (175–4 000 caractères)
`--long-description-file PATH`	Lit la description longue depuis un fichier texte UTF-8 (175–4 000 caractères)
`--slashes-only`	Émet uniquement le tableau `features.slash_commands` (pour fusion manuelle dans un manifest existant)
`--no-assistant`	Omet le mode Slack AI Assistant ; les DM s’affichent comme un chat plat où les commandes slash nues (`/help`, `/new`) fonctionnent en ligne
`--agent-view`	Émet l’expérience de messagerie Agent de Slack au lieu de l’`assistant_view` héritée ; irréversible dans Slack après application du manifest

Scénarios courants

Configuration initiale

hermes slack manifest
# Affiche un manifest.json complet sur stdout

# 1. Allez sur https://api.slack.com/apps
# 2. Créer une nouvelle app → À partir du manifest
# 3. Collez le manifest généré
# 4. Installez l'app dans votre espace de travail

Enregistrer dans un fichier

hermes slack manifest --write
# Écrit dans $HERMES_HOME/slack-manifest.json

hermes slack manifest --write ./slack-manifest.json
# Ou vers un chemin personnalisé

Personnaliser le bot

hermes slack manifest --name "Hermes Bot" --description "Assistant IA relayé via le gateway Hermes"

Fusion dans un manifest existant

hermes slack manifest --slashes-only
# Émet uniquement le tableau slash_commands pour fusion manuelle

Choisir l’expérience de messagerie

hermes slack manifest --agent-view
# Utilise l'expérience de messagerie Agent de Slack (irréversible ensuite)

Conseils

manifest est la seule sous-commande de hermes slack
--write sans PATH enregistre dans $HERMES_HOME/slack-manifest.json
Après application d’un manifest, réinstallez l’app si Slack le demande
--agent-view modifie la surface de messagerie de l’app et ne peut pas être inversé après application
Utilisez --slashes-only si vous maintenez un manifest existant à la main