Hermes Command Cheat Sheet

A practical quick-reference for the Hermes Agent CLI, config, tools, skills, sessions, profiles, gateway, cron jobs, and in-chat slash commands.

Basic usage

hermes                         # Start interactive chat
hermes chat -q "your prompt"   # One-shot prompt
hermes --continue              # Continue most recent session
hermes --resume SESSION_ID     # Resume a specific session
hermes --profile NAME          # Run using a specific profile
hermes --skills skill1,skill2  # Preload skills
hermes --yolo                  # Skip command approvals
hermes --version               # Show version
hermes --help                  # Full help

Setup and health

hermes setup                   # Interactive setup wizard
hermes setup model             # Configure model/provider
hermes setup gateway           # Configure messaging gateway
hermes model                   # Pick/change model interactively
hermes doctor                  # Check config/dependencies
hermes doctor --fix            # Try to fix issues
hermes status                  # Show component status
hermes update                  # Update Hermes

Config

hermes config                  # View current config
hermes config edit             # Open config.yaml
hermes config path             # Print config file path
hermes config env-path         # Print .env path
hermes config check            # Check config
hermes config migrate          # Migrate/update config
hermes config set KEY VALUE    # Set config value

Common examples:

hermes config set model.provider openrouter
hermes config set model.default anthropic/claude-sonnet-4
hermes config set approvals.mode smart
hermes config set approvals.mode off
hermes config set memory.memory_enabled true

Auth and credentials

hermes auth                    # Interactive credential manager
hermes auth add openai-codex   # Add OpenAI Codex OAuth
hermes auth add anthropic      # Add Anthropic key
hermes auth add nous           # Add Nous credential
hermes auth list               # List credentials
hermes auth remove PROVIDER N  # Remove credential index
hermes auth reset PROVIDER     # Reset exhausted credential state

Tools

hermes tools                   # Interactive tool enable/disable
hermes tools list              # List tools/toolsets
hermes tools enable NAME       # Enable a toolset
hermes tools disable NAME      # Disable a toolset

Useful toolsets:

terminal       Shell access
file           Read/write/search/patch files
web            Web search/extract
browser        Browser automation
vision         Image analysis
image_gen      Image generation
tts            Text to speech
memory         Persistent memory
session_search Search old sessions
delegation     Subagents
cronjob        Scheduled jobs

Skills

hermes skills list             # List installed skills
hermes skills browse           # Browse skill catalog
hermes skills search QUERY     # Search skills
hermes skills inspect ID       # Preview a skill
hermes skills install ID       # Install a skill
hermes skills update           # Update skills
hermes skills check            # Check for updates
hermes skills uninstall NAME   # Remove a skill
hermes skills config           # Enable/disable skills per platform

Sessions

hermes sessions list           # List recent sessions
hermes sessions browse         # Interactive session picker
hermes sessions rename ID NAME # Rename session
hermes sessions delete ID      # Delete session
hermes sessions export OUT     # Export sessions to JSONL
hermes sessions prune          # Clean old sessions
hermes sessions stats          # Session DB stats

Profiles

hermes profile list            # List profiles
hermes profile create NAME     # Create profile
hermes profile use NAME        # Set default profile
hermes profile show NAME       # Show profile details
hermes profile delete NAME     # Delete profile
hermes profile rename OLD NEW  # Rename profile
hermes profile export NAME     # Export profile
hermes profile import FILE     # Import profile

Gateway and messaging

hermes gateway setup           # Configure messaging platforms
hermes gateway run             # Run gateway foreground
hermes gateway install         # Install as background service
hermes gateway start           # Start service
hermes gateway stop            # Stop service
hermes gateway restart         # Restart service
hermes gateway status          # Check gateway status

Cron jobs

hermes cron list               # List scheduled jobs
hermes cron create "30m"       # Create job every 30 minutes
hermes cron create "0 9 * * *" # Create daily 9am job
hermes cron edit ID            # Edit job
hermes cron pause ID           # Pause job
hermes cron resume ID          # Resume job
hermes cron run ID             # Run job now/next tick
hermes cron remove ID          # Delete job
hermes cron status             # Scheduler status

MCP servers

hermes mcp list                # List MCP servers
hermes mcp add NAME            # Add MCP server
hermes mcp remove NAME         # Remove MCP server
hermes mcp test NAME           # Test MCP server
hermes mcp configure NAME      # Select/toggle MCP tools
hermes mcp serve               # Run Hermes as MCP server

Desktop and web UI

hermes desktop                 # Launch desktop app
hermes gui                     # Alias for desktop
hermes dashboard               # Launch web dashboard
hermes proxy                   # OpenAI-compatible local proxy

Plugins

hermes plugins list            # List plugins
hermes plugins install NAME    # Install plugin
hermes plugins remove NAME     # Remove plugin

Memory

hermes memory setup            # Configure memory
hermes memory status           # Check memory status
hermes memory off              # Disable memory

Shell completions

hermes completion bash
hermes completion zsh

In-chat slash commands

Session control

/help                 Show help
/new or /reset        New session
/clear                Clear screen + new session
/retry                Retry last message
/undo                 Remove last exchange
/title NAME           Name session
/compress             Compress context
/quit or /exit or /q  Exit

Model and config

/model                Show/change model
/reasoning LEVEL      Set reasoning level
/verbose              Toggle verbosity
/yolo                 Toggle approval bypass
/config               Show config
/profile              Show active profile
/status               Session status
/usage                Token usage

Tools and skills

/tools                Manage tools
/toolsets             List toolsets
/skills               Search/install skills
/skill NAME           Load a skill
/reload-skills        Reload skills
/reload-mcp           Reload MCP servers
/cron                 Manage cron jobs

Background and subagents

/background PROMPT    Run prompt in background
/queue PROMPT         Queue prompt for next turn
/steer PROMPT         Inject steering after next tool call
/agents or /tasks     Show active agents/tasks
/stop                 Stop background processes

Gateway commands

/restart              Restart gateway
/sethome              Set current chat as home channel
/platforms            Show platform status
/approve              Approve pending command
/deny                 Deny pending command
/topic                Telegram topic/session tools

Useful paths

~/.hermes/config.yaml          # Main config
~/.hermes/.env                 # Secrets/API keys
~/.hermes/skills/              # Installed skills
~/.hermes/logs/                # Logs
~/.hermes/logs/gateway.log     # Gateway log
~/.hermes/state.db             # Session database
~/.hermes/auth.json            # OAuth/credential pools
~/.hermes/profiles/NAME/       # Profile-specific state

Quick troubleshooting commands

hermes doctor
hermes config check
hermes auth
hermes model
hermes tools
hermes gateway status
hermes gateway restart
hermes skills check
hermes skills update

For the authoritative full command list, run:

hermes --help
hermes COMMAND --help