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.
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)
| Command | Level | ||
|---|---|---|---|
hermesStart interactive session (TUI supported) | Basic | hermes | |
hermes --helpView help information | Basic | hermes --help | |
hermes --versionCheck version number | Basic | hermes --version | |
hermes doctorRun system diagnostics | Intermediate | hermes doctor | |
hermes updateCheck and install updates | Intermediate | hermes update | |
hermes sessionView current session | Basic | hermes session | |
hermes session listList all sessions | Intermediate | hermes session list | |
hermes session log <session-id>View session log | Intermediate | hermes session log sess-abc | |
hermes session clearClear current session | Intermediate | hermes session clear |
Messaging(7)
| Command | Level | ||
|---|---|---|---|
hermes send <message>Send message to default platform | Basic | hermes send "Hello, Hermes!" | |
hermes send --to feishu <message>Send message to Feishu | Intermediate | hermes send --to feishu "消息内容" | |
hermes send --to telegram <message>Send message to Telegram | Intermediate | hermes send --to telegram "Hello!" | |
hermes send --to discord <message>Send message to Discord | Intermediate | hermes send --to discord "Hello!" | |
hermes send --to whatsapp <message>Send message to WhatsApp | Intermediate | hermes send --to whatsapp "Hello!" | |
hermes send --to slack <message>Send message to Slack | Intermediate | hermes send --to slack "Hello!" | |
hermes send --to signal <message>Send message to Signal | Intermediate | hermes send --to signal "Hello!" |
Configuration(6)
| Command | Level | ||
|---|---|---|---|
hermes configView current configuration | Basic | hermes config | |
hermes config editEdit configuration file | Intermediate | hermes config edit | |
hermes config set <key> <value>Set a configuration key | Intermediate | hermes config set model.default gpt-4 | |
hermes profileManage configuration profiles | Intermediate | hermes profile | |
hermes profile switch <profile-name>Switch configuration profile | Expert | hermes profile switch work | |
hermes profile listList all configuration profiles | Basic | hermes profile list |
Model Management(5)
| Command | Level | ||
|---|---|---|---|
hermes modelList available models | Basic | hermes model | |
hermes model switch <model-name>Switch current model | Intermediate | hermes model switch gpt-4-turbo | |
hermes model currentView currently active model | Basic | hermes model current | |
hermes provider set <provider-name>Set LLM provider | Intermediate | hermes provider set openai | |
hermes provider listList all providers | Basic | hermes provider list |
Memory System(6)
| Command | Level | ||
|---|---|---|---|
hermes memoryView memories | Basic | hermes memory | |
hermes memory search <query>Search memories | Intermediate | hermes memory search project context | |
hermes memory add <content>Add new memory | Intermediate | hermes memory add "Project uses Python 3.12" | |
hermes memory remove <memory-id>Remove specific memory | Intermediate | hermes memory remove abc123 | |
hermes memory clearClear all memories | Expert | hermes memory clear | |
hermes memory statsView memory statistics | Intermediate | hermes memory stats |
Advanced Operations(12)
| Command | Level | ||
|---|---|---|---|
hermes skillList loaded skills | Basic | hermes skill | |
hermes skill view <skill-name>View skill details | Intermediate | hermes skill view web-search | |
skill_view(name='<skill-name>')Built-in skill — view skill documentation | Intermediate | skill_view(name='hermes-agent') | |
skill_manage(action='<action>')Built-in skill — manage skills (install/uninstall/update) | Expert | skill_manage(action='list') | |
web_search(query='<query>')Built-in skill — perform web search | Intermediate | web_search(query='Hermes Agent documentation') | |
web_extract(url='<url>')Built-in skill — extract web page content | Intermediate | web_extract(url='https://hermes-agent.nousresearch.com/docs') | |
terminal(command='<cmd>')Built-in skill — execute terminal command | Basic | terminal(command='ls -la') | |
delegate_task(task='<task>')Built-in skill — delegate subtask to agent | Expert | delegate_task(task='Analyze the log file and summarize errors') | |
read_file(path='<path>')Built-in skill — read file content | Intermediate | read_file(path='/etc/hosts') | |
search_files(pattern='<pattern>', path='<path>')Built-in skill — search files | Intermediate | search_files(pattern='*.py', path='./src') | |
write_file(path='<path>', content='<content>')Built-in skill — write file | Intermediate | write_file(path='output.txt', content='Hello World') | |
patch(path='<path>', old_string='<old>', new_string='<new>')Built-in skill — edit file content | Expert | patch(path='config.py', old_string='debug=False', new_string='debug=True') |
Cron Jobs(5)
| Command | Level | ||
|---|---|---|---|
hermes cron create --schedule '<cron>' --task '<task>'Create a cron job | Expert | hermes cron create --schedule "0 9 * * 1" --task "Send weekly report" | |
hermes cron listList all cron jobs | Intermediate | hermes cron list | |
hermes cron remove <cron-id>Remove a cron job | Intermediate | hermes cron remove cron-123 | |
hermes cron pause <cron-id>Pause a cron job | Expert | hermes cron pause cron-123 | |
hermes cron resume <cron-id>Resume a cron job | Expert | hermes cron resume cron-123 |