Skip to main content

Hermes Agent — Smart AI Agent by Nous Research

Hermes Agent is an open-source intelligent AI agent framework by Nous Research, supporting multi-platform messaging, extensible skills, memory systems, and cron jobs. This cheatsheet covers all core features from beginner to advanced.

Updated: 2026-07-17·50 commands

Basic Operations {#basic}

### View help ``bash hermes --help `

### Check version `bash hermes --version `

### Start interactive session `bash hermes `

### Run diagnostics `bash hermes doctor `

### Check for updates `bash hermes update `

### View sessions `bash hermes session `

### Launch TUI interface `bash hermes # TUI mode starts automatically if terminal supports it `

Messaging {#messaging}

### Send message (default platform) `bash hermes send "Hello, Hermes!" `

### Send to Feishu `bash hermes send --to feishu "Message content" `

### Send to Telegram `bash hermes send --to telegram "Hello from Hermes!" `

### Send to Discord `bash hermes send --to discord "Hello!" `

### Send to WhatsApp `bash hermes send --to whatsapp "Hello!" `

### Send to Slack `bash hermes send --to slack "Hello!" `

### Send to Signal `bash hermes send --to signal "Hello!" `

Configuration {#configuration}

### View current config `bash hermes config `

### Edit configuration `bash hermes config edit `

### Set config key `bash hermes config set `

### Manage profiles `bash hermes profile `

### Switch profile `bash hermes profile switch `

### List all profiles `bash hermes profile list `

Model Management {#model}

### List available models `bash hermes model `

### Switch model `bash hermes model switch `

### View current model `bash hermes model current `

### Set LLM provider `bash hermes provider set `

### List providers `bash hermes provider list `

Memory System {#memory}

### View memories `bash hermes memory `

### Search memories `bash hermes memory search `

### Add memory `bash hermes memory add "Memory content" `

### Remove memory `bash hermes memory remove `

### Clear all memories `bash hermes memory clear `

### View memory stats `bash hermes memory stats `

Skill Management {#skills}

### List loaded skills `bash hermes skill `

### View skill details `bash hermes skill view `

### List all available skills `bash hermes skill list `

### Built-in skill: View skill docs `bash skill_view(name="skill-name") `

### Built-in skill: Manage skills `bash skill_manage(action="list") `

### Built-in skill: Web search `bash web_search(query="search keywords") `

### Built-in skill: Web extract `bash web_extract(url="https://example.com") `

### Built-in skill: Execute terminal command `bash terminal(command="ls -la") `

### Built-in skill: Delegate task `bash delegate_task(task="complete task description") `

Cron Jobs {#cron}

### Create a cron job `bash hermes cron create --schedule "*/5 * * * *" --task "Check system status" `

### List all cron jobs `bash hermes cron list `

### Remove a cron job `bash hermes cron remove `

### Pause a cron job `bash hermes cron pause `

### Resume a cron job `bash hermes cron resume `

Advanced Operations {#advanced}

### Task delegation `bash delegate_task(task="Investigate database performance issue", context="Production MySQL slow queries") `

### Background process management `bash terminal(command="python server.py", background=true) `

### File read tool `bash read_file(path="/path/to/file") `

### File search tool `bash search_files(pattern="*.py", path="./src") `

### File write tool `bash write_file(path="output.txt", content="Hello World") `

### Code patch tool `bash patch(path="file.py", old_string="old_code", new_string="new_code") `

### Session management `bash hermes session list `

### View session logs `bash hermes session log `

### Clear session `bash hermes session clear ``

Basic Operations(9)

CommandLevel
hermes
Start interactive session (TUI supported)
Basic
hermes --help
View help information
Basic
hermes --version
Check version number
Basic
hermes doctor
Run system diagnostics
Intermediate
hermes update
Check and install updates
Intermediate
hermes session
View current session
Basic
hermes session list
List all sessions
Intermediate
hermes session log <session-id>
View session log
Intermediate
hermes session clear
Clear current session
Intermediate

Messaging(7)

CommandLevel
hermes send <message>
Send message to default platform
Basic
hermes send --to feishu <message>
Send message to Feishu
Intermediate
hermes send --to telegram <message>
Send message to Telegram
Intermediate
hermes send --to discord <message>
Send message to Discord
Intermediate
hermes send --to whatsapp <message>
Send message to WhatsApp
Intermediate
hermes send --to slack <message>
Send message to Slack
Intermediate
hermes send --to signal <message>
Send message to Signal
Intermediate

Configuration(6)

CommandLevel
hermes config
View current configuration
Basic
hermes config edit
Edit configuration file
Intermediate
hermes config set <key> <value>
Set a configuration key
Intermediate
hermes profile
Manage configuration profiles
Intermediate
hermes profile switch <profile-name>
Switch configuration profile
Expert
hermes profile list
List all configuration profiles
Basic

Model Management(5)

CommandLevel
hermes model
List available models
Basic
hermes model switch <model-name>
Switch current model
Intermediate
hermes model current
View currently active model
Basic
hermes provider set <provider-name>
Set LLM provider
Intermediate
hermes provider list
List all providers
Basic

Memory System(6)

CommandLevel
hermes memory
View memories
Basic
hermes memory search <query>
Search memories
Intermediate
hermes memory add <content>
Add new memory
Intermediate
hermes memory remove <memory-id>
Remove specific memory
Intermediate
hermes memory clear
Clear all memories
Expert
hermes memory stats
View memory statistics
Intermediate

Advanced Operations(12)

CommandLevel
hermes skill
List loaded skills
Basic
hermes skill view <skill-name>
View skill details
Intermediate
skill_view(name='<skill-name>')
Built-in skill — view skill documentation
Intermediate
skill_manage(action='<action>')
Built-in skill — manage skills (install/uninstall/update)
Expert
web_search(query='<query>')
Built-in skill — perform web search
Intermediate
web_extract(url='<url>')
Built-in skill — extract web page content
Intermediate
terminal(command='<cmd>')
Built-in skill — execute terminal command
Basic
delegate_task(task='<task>')
Built-in skill — delegate subtask to agent
Expert
read_file(path='<path>')
Built-in skill — read file content
Intermediate
search_files(pattern='<pattern>', path='<path>')
Built-in skill — search files
Intermediate
write_file(path='<path>', content='<content>')
Built-in skill — write file
Intermediate
patch(path='<path>', old_string='<old>', new_string='<new>')
Built-in skill — edit file content
Expert

Cron Jobs(5)

CommandLevel
hermes cron create --schedule '<cron>' --task '<task>'
Create a cron job
Expert
hermes cron list
List all cron jobs
Intermediate
hermes cron remove <cron-id>
Remove a cron job
Intermediate
hermes cron pause <cron-id>
Pause a cron job
Expert
hermes cron resume <cron-id>
Resume a cron job
Expert

FAQ

This cheatsheet is compiled from official tool documentation. Last updated: 2026-07-17.