Hermes Agent Cheat Sheet

Quick Start

# Install
npm i -g hermes-agent
# or
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
# First run
hermes init
hermes start

CLI Commands

hermes init              # Create config directory
hermes start             # Start the agent
hermes status            # Check if running
hermes stop              # Stop the agent
hermes logs              # View logs
hermes model             # Switch provider/model
hermes profile           # List/switch profiles
hermes skill             # Manage skills
hermes cron              # List scheduled jobs

Profiles

Profiles isolate config, skills, plugins, and memory:

hermes profile list      # Show profiles
hermes profile switch work  # Switch to "work" profile
hermes profile create personal
hermes profile rm old-profile

Profiles live in ~/.hermes/profiles/<name>/ with their own skills/, plugins/, cron/, and memories/.

Skills

Skills are reusable procedures stored as markdown:

hermes skill list           # List installed skills
hermes skill view deploy    # View a skill's content
hermes skill create my-skill
hermes skill edit my-skill
hermes skill delete my-skill

Skills live in ~/.hermes/skills/ and load context when invoked.

Cron Jobs

Schedule recurring tasks:

hermes cron create --schedule "0 9   *" --prompt "Daily briefing"
hermes cron list
hermes cron pause job-id
hermes cron resume job-id
hermes cron remove job-id
hermes cron run job-id      # Run once immediately

Job delivery targets: origin (current chat), local (file only), all (every channel).

Memory

Persistent facts that survive across sessions:

hermes memory add "User prefers concise responses"
hermes memory list
hermes memory remove "User prefers"

Memory is injected into every turn. Good for preferences, environment details, conventions.

Tools

| Tool | Purpose | |------|---------| | terminal | Shell commands | | web_search | Search the web | | web_extract | Extract page content | | read_file / write_file | File operations | | patch | Find-and-replace edits | | search_files | Search file contents | | execute_code | Run Python scripts | | delegate_task | Spawn sub-agents | | cronjob | Schedule recurring tasks | | skill_manage | Create/update/delete skills | | memory | Save/recall facts | | vision_analyze | Analyze images |

Configuration

# ~/.hermes/config.yaml
provider: openrouter
model: deepseek/deepseek-chat
skills:
  auto_load: true
delegation:
  max_concurrent_children: 3
memory:
  max_chars: 8000