* docs: comprehensive fallback providers documentation
- New dedicated page: user-guide/features/fallback-providers.md covering
both primary model fallback and auxiliary task fallback systems
- Updated configuration.md with fallback_model config section
- Updated environment-variables.md noting fallback is config-only
- Fleshed out developer-guide/provider-runtime.md fallback section with
internal architecture details (trigger points, activation flow, config flow)
- Added cross-reference from provider-routing.md distinguishing OpenRouter
sub-provider routing from Hermes-level model fallback
- Added new page to sidebar under Integrations
* docs: comprehensive /background command documentation
- Added Background Sessions section to cli.md covering how it works
(daemon threads, isolated sessions, config inheritance, Rich panel
output, bell notification, concurrent tasks)
- Added Background Sessions section to messaging/index.md covering
messaging-specific behavior (async execution, result delivery back
to same chat, fire-and-forget pattern)
- Documented background_process_notifications config
(all/result/error/off) in messaging docs and configuration.md
- Added HERMES_BACKGROUND_NOTIFICATIONS env var to reference page
- Fixed inconsistency in slash-commands.md: /background was listed as
messaging-only but works in both CLI and messaging. Moved it to the
'both surfaces' note.
- Expanded one-liner table descriptions with detail and cross-references
Complete reference for interactive CLI and messaging slash commands
Slash Commands Reference
Hermes has two slash-command surfaces:
Interactive CLI slash commands — handled by cli.py / hermes_cli/commands.py
Messaging slash commands — handled by gateway/run.py
Installed skills are also exposed as dynamic slash commands on both surfaces. That includes bundled skills like /plan, which opens plan mode and saves markdown plans under .hermes/plans/ relative to the active workspace/backend working directory.
Interactive CLI slash commands
Type / in the CLI to open the autocomplete menu. Built-in commands are case-insensitive.
Session
Command
Description
/new
Start a new conversation (reset history)
/reset
Reset conversation only (keep screen)
/clear
Clear screen and reset conversation (fresh start)
/history
Show conversation history
/save
Save the current conversation
/retry
Retry the last message (resend to agent)
/undo
Remove the last user/assistant exchange
/title
Set a title for the current session (usage: /title My Session Name)
List or restore filesystem checkpoints (usage: /rollback [number])
/background <prompt>
Run a prompt in a separate background session. The agent processes your prompt independently — your current session stays free for other work. Results appear as a panel when the task finishes. See CLI Background Sessions.
/plan [request]
Load the bundled plan skill to write a markdown plan instead of executing the work. Plans are saved under .hermes/plans/ relative to the active workspace/backend working directory.
Configuration
Command
Description
/config
Show current configuration
/model
Show or change the current model
/provider
Show available providers and current provider
/prompt
View/set custom system prompt
/personality
Set a predefined personality
/verbose
Cycle tool progress display: off → new → all → verbose
/reasoning
Manage reasoning effort and display (usage: /reasoning [level|show|hide])
Load any installed skill as an on-demand command. Example: /gif-search, /github-pr-workflow, /excalidraw.
/skills ...
Search, browse, inspect, install, audit, publish, and configure skills from registries and the official optional-skills catalog.
Quick commands
User-defined quick commands from quick_commands in ~/.hermes/config.yaml are also available as slash commands. These are resolved at dispatch time, not shown in the built-in autocomplete/help tables.
Messaging slash commands
The messaging gateway supports the following built-in commands inside Telegram, Discord, Slack, WhatsApp, Signal, Email, and Home Assistant chats:
Command
Description
/new
Start a new conversation.
/reset
Reset conversation history.
/status
Show session info.
/stop
Interrupt the running agent without queuing a follow-up prompt.
/model [provider:model]
Show or change the model, including provider switches.
/provider
Show provider availability and auth status.
/personality [name]
Set a personality overlay for the session.
/retry
Retry the last message.
/undo
Remove the last exchange.
/sethome
Mark the current chat as the platform home channel for deliveries.
/compress
Manually compress conversation context.
/title [name]
Set or show the session title.
/resume [name]
Resume a previously named session.
/usage
Show token usage for the current session.
/insights [days]
Show usage analytics.
/reasoning [level|show|hide]
Change reasoning effort or toggle reasoning display.
/voice [on|off|tts|join|channel|leave|status]
Control spoken replies in chat. join/channel/leave manage Discord voice-channel mode.
/rollback [number]
List or restore filesystem checkpoints.
/background <prompt>
Run a prompt in a separate background session. Results are delivered back to the same chat when the task finishes. See Messaging Background Sessions.
/plan [request]
Load the bundled plan skill to write a markdown plan instead of executing the work. Plans are saved under .hermes/plans/ relative to the active workspace/backend working directory.
/reload-mcp
Reload MCP servers from config.
/update
Update Hermes Agent to the latest version.
/help
Show messaging help.
/<skill-name>
Invoke any installed skill by name.
Notes
/skin, /tools, /toolsets, /config, /prompt, /cron, /skills, /platforms, /paste, and /verbose are CLI-only commands.
/status, /stop, /sethome, /resume, and /update are messaging-only commands.
/background, /voice, /reload-mcp, and /rollback work in both the CLI and the messaging gateway.
/voice join, /voice channel, and /voice leave are only meaningful on Discord.
Teknium
463239ed85