hermes slack Command — Complete Reference & Examples

Overview

hermes slack provides Slack integration helpers for Hermes. It has a single subcommand, manifest, which prints or writes a Slack app manifest with every gateway command registered as a native slash command (/btw, /stop, /model, …). Paste the manifest into your Slack app configuration to connect your workspace to the Hermes gateway.

hermes slack manifest

Subcommands

manifest

Generate a Slack app manifest that registers every gateway command in the command registry as a first-class Slack slash command. Paste the output into Slack app config → Features → App Manifest → Edit, then Save. Reinstall the app if Slack prompts for it.

Option	Description
`--write [PATH]`	Write the manifest to a file instead of stdout. With no PATH, writes to `$HERMES_HOME/slack-manifest.json`
`--name NAME`	Bot display name (default: `Hermes`)
`--description DESCRIPTION`	Bot description shown in Slack’s app directory
`--long-description TEXT`	Set Slack’s long app description (175–4,000 characters)
`--long-description-file PATH`	Read the long app description from a UTF-8 text file (175–4,000 characters)
`--slashes-only`	Emit only the `features.slash_commands` array (for merging into an existing manifest manually)
`--no-assistant`	Omit Slack AI Assistant mode; DMs render as a flat chat where bare slash commands (`/help`, `/new`) work inline
`--agent-view`	Emit Slack’s Agent messaging experience instead of the legacy `assistant_view`; this cannot be reversed in Slack after applying the manifest

Common Scenarios

First-Time Setup

hermes slack manifest
# Outputs a complete manifest.json to stdout

# 1. Go to https://api.slack.com/apps
# 2. Create New App → From manifest
# 3. Paste the generated manifest
# 4. Install the app to your workspace

Saving to a File

hermes slack manifest --write
# Writes to $HERMES_HOME/slack-manifest.json

hermes slack manifest --write ./slack-manifest.json
# Or to a custom path

Customizing the Bot

hermes slack manifest --name "Hermes Bot" --description "AI assistant relayed through the Hermes gateway"

Merging Into an Existing Manifest

hermes slack manifest --slashes-only
# Emits only the slash_commands array to merge manually

Choosing the Messaging Experience

hermes slack manifest --agent-view
# Use Slack's Agent messaging experience (cannot be reverted in Slack later)

Tips

manifest is the only subcommand of hermes slack
--write with no PATH saves to $HERMES_HOME/slack-manifest.json
After applying a manifest, reinstall the app if Slack prompts for it
--agent-view changes Slack’s app messaging surface and cannot be reversed after applying
Use --slashes-only when you maintain an existing manifest by hand