hermes-agent/website/docs/reference/cli-commands.md

sidebar_position, title, description

sidebar_position	title	description
1	CLI Commands Reference	Comprehensive reference for all hermes CLI commands and slash commands

CLI Commands Reference

Terminal Commands

These are commands you run from your shell.

Core Commands

Command	Description
hermes	Start interactive chat (default)
hermes chat -q "Hello"	Single query mode (non-interactive)
hermes --continue / -c	Resume the most recent session
hermes --resume <id> / -r <id>	Resume a specific session
hermes --model <name>	Use a specific model
hermes --provider <name>	Force a provider (nous, openrouter)
hermes --toolsets "web,terminal"	Use specific toolsets
hermes --verbose	Enable verbose/debug output

Provider & Model Management

Command	Description
hermes model	Switch provider and model interactively
hermes logout	Clear stored OAuth credentials

Configuration

Command	Description
hermes setup	Full setup wizard (provider, terminal, messaging)
hermes config	View current configuration
hermes config edit	Open config.yaml in your editor
hermes config set KEY VAL	Set a specific value
hermes config check	Check for missing config (useful after updates)
hermes config migrate	Interactively add missing options
hermes status	Show configuration status (including auth)
hermes doctor	Diagnose issues

Maintenance

Command	Description
hermes update	Update to latest version
hermes uninstall	Uninstall (can keep configs for later reinstall)
hermes version	Show version info

Gateway (Messaging + Cron)

Command	Description
hermes gateway	Run gateway in foreground
hermes gateway setup	Configure messaging platforms interactively
hermes gateway install	Install as system service (Linux/macOS)
hermes gateway start	Start the service
hermes gateway stop	Stop the service
hermes gateway restart	Restart the service
hermes gateway status	Check service status
hermes whatsapp	Pair WhatsApp via QR code

Skills

Command	Description
hermes skills search <query>	Search skill registries
hermes skills install <identifier>	Install a skill (with security scan)
hermes skills inspect <identifier>	Preview before installing
hermes skills list	List installed skills
hermes skills list --source hub	List hub-installed skills only
hermes skills audit	Re-scan all hub skills
hermes skills uninstall <name>	Remove a hub skill
hermes skills publish <path> --to github --repo owner/repo	Publish a skill
hermes skills snapshot export <file>	Export skill config
hermes skills snapshot import <file>	Import from snapshot
hermes skills tap add <repo>	Add a custom source
hermes skills tap remove <repo>	Remove a source
hermes skills tap list	List custom sources

Cron & Pairing

Command	Description
hermes cron list	View scheduled jobs
hermes cron status	Check if cron scheduler is running
hermes pairing list	View pending + approved users
hermes pairing approve <platform> <code>	Approve a pairing code
hermes pairing revoke <platform> <user_id>	Remove user access

Sessions

Command	Description
hermes sessions list	Browse past sessions

---

Slash Commands (Inside Chat)

Type / in the interactive CLI to see an autocomplete dropdown.

Navigation & Control

Command	Description
/help	Show available commands
/quit	Exit the CLI (aliases: /exit, /q)
/clear	Clear screen and reset conversation
/new	Start a new conversation
/reset	Reset conversation only (keep screen)

Tools & Configuration

Command	Description
/tools	List all available tools
/toolsets	List available toolsets
/model [name]	Show or change the current model
/config	Show current configuration
/prompt [text]	View/set custom system prompt
/personality [name]	Set a predefined personality

Conversation

Command	Description
/history	Show conversation history
/retry	Retry the last message
/undo	Remove the last user/assistant exchange
/save	Save the current conversation
/compress	Manually compress conversation context
/usage	Show token usage for this session

Skills & Scheduling

Command	Description
/cron	Manage scheduled tasks
/skills	Search, install, inspect, or manage skills
/platforms	Show gateway/messaging platform status
/verbose	Cycle tool progress: off → new → all → verbose
/<skill-name>	Invoke any installed skill

Gateway-Only Commands

These work in messaging platforms (Telegram, Discord, Slack, WhatsApp) but not the interactive CLI:

Command	Description
/stop	Stop the running agent (no follow-up message)
/sethome	Set this chat as the home channel
/status	Show session info
/reload-mcp	Reload MCP servers from config
/update	Update Hermes Agent to the latest version

---

Keybindings

Key	Action
Enter	Send message
Alt+Enter / Ctrl+J	New line (multi-line input)
Ctrl+C	Interrupt agent (double-press to force exit)
Ctrl+D	Exit
Tab	Autocomplete slash commands

:::tip Commands are case-insensitive — /HELP works the same as /help. :::