AI Coding Tool Setup and Reference (7/7) — Hermes Agent Command Cheatsheet: 30+ Subcommands

Per the official /docs/reference/cli-commands — verbatim reference, 7 daily / 3 advanced / session controls


ํ•ต์‹ฌ ์š”์•ฝ

  • Audience: You installed Hermes Agent (#12) and now want a complete map of commands.
  • What you'll get: 30+ subcommands grouped into 9 categories, 11 global options, 10 hermes chat flags, session controls, slash commands, interrupt/recovery shortcuts.
  • Prerequisite: hermes works, basic setup done.

1. The daily 7

Command Effect When
hermes Interactive CLI (= hermes chat) Normal session
hermes chat -q "..." One-shot non-interactive Scripts / pipes
hermes -c / --continue Resume most recent session Terminal re-open
hermes -r <id> / --resume Resume specific session by ID or title Explicit selection
hermes status Agent / auth / platform status First check when something's off
hermes model Switch provider / model Need a different model
hermes doctor [--fix] Diagnose environment (can auto-fix) After install / upgrade

2. All subcommands — 9 categories

Per the official /docs/reference/cli-commands.

2.1 Session & chat (3)

Command Syntax Effect
hermes chat hermes chat [options] Interactive / one-shot chat
hermes sessions hermes sessions <sub> List / export / delete / rename
hermes insights hermes insights [--days N] [--source] Token / cost / activity analytics

2.2 Config & auth (6)

Command Syntax Effect
hermes setup hermes setup [section] Full / partial setup wizard
hermes model hermes model Choose provider + model
hermes auth hermes auth <sub> API keys, OAuth credentials
hermes config hermes config <sub> Show / edit / migrate config.yaml
hermes tools hermes tools [--summary] Per-platform tool toggles
hermes profile hermes profile <sub> Manage isolated instances

2.3 Gateway & channels (3)

Command Syntax Effect
hermes gateway hermes gateway <sub> Run / service management
hermes whatsapp hermes whatsapp WhatsApp bridge setup / pairing
hermes pairing hermes pairing <sub> Approve / revoke pairing codes

2.4 Extensions & knowledge (5)

Command Syntax Effect
hermes skills hermes skills <sub> Browse / install / publish / audit
hermes mcp hermes mcp <sub> MCP servers: add / remove / test
hermes plugins hermes plugins [sub] Plugin management
hermes memory hermes memory <sub> External memory provider
hermes honcho hermes honcho <sub> Honcho cross-session memory

2.5 Automation (2)

Command Syntax Effect
hermes cron hermes cron <sub> Scheduled jobs CRUD
hermes webhook hermes webhook <sub> Webhook subscriptions

2.6 Diagnostics & logs (4)

Command Syntax Effect
hermes status hermes status [--all] [--deep] Full status
hermes doctor hermes doctor [--fix] Environment diagnosis
hermes logs hermes logs [log_name] [options] Log view / filter
hermes debug hermes debug share [options] Upload logs for support

2.7 Backup & migration (3)

Command Syntax Effect
hermes backup hermes backup [options] Zip ~/.hermes/
hermes import hermes import <zipfile> Restore a backup
hermes claw hermes claw migrate [options] OpenClaw migration

2.8 Utilities (4)

Command Syntax Effect
hermes dump hermes dump [--show-keys] Copy-pasteable config summary
hermes dashboard hermes dashboard [options] Web dashboard
hermes completion hermes completion [bash\|zsh] Shell completion scripts
hermes acp hermes acp ACP stdio server for editors

2.9 Maintenance (3)

Command Syntax Effect
hermes version hermes version Show version
hermes update hermes update Pull latest + reinstall deps
hermes uninstall hermes uninstall [--full] [--yes] Remove from system

3. Global options (applies to all commands)

Option Effect
--version, -V Show version and exit
--profile <name>, -p <name> Select profile
--resume <session>, -r <session> Resume by ID or title
--continue [name], -c [name] Resume most recent session (optional name filter)
--worktree, -w Start in an isolated git worktree
--yolo Bypass dangerous-command approval prompts (risky)
--pass-session-id Include session ID in system prompt
--ignore-user-config Ignore ~/.hermes/config.yaml
--ignore-rules Skip auto-injection of rules + memory
--tui Launch the TUI instead of classic CLI
--dev Run TypeScript source directly via tsx

4. hermes chat options

Option Effect
-q, --query "..." One-shot non-interactive prompt
-m, --model <model> Override model for this run
-t, --toolsets <csv> Enable comma-separated toolsets
--provider <provider> Force a specific provider
-s, --skills <name> Preload skills (repeatable)
-v, --verbose Verbose output
-Q, --quiet Programmatic mode
--image <path> Attach a local image
--checkpoints Enable filesystem checkpoints
--max-turns <N> Cap tool iterations

Example — Anthropic model + preloaded skill:

hermes chat \
  --provider anthropic \
  --model "anthropic/claude-sonnet-4" \
  --toolsets "web,terminal,skills" \
  -s github-auth \
  -q "summarize my last 3 PRs"

5. Gateway subcommands

Sub Effect
run Run in foreground
start Start systemd/launchd service
stop Stop service or foreground
restart Restart service
status Service status
install Install as background service
uninstall Remove service registration
setup Interactive messenger setup

24/7 server: hermes gateway install && hermes gateway start.


6. Setup sections

hermes setup with no arg runs the full wizard. For a specific area:

Section Covers
model Provider + model
terminal Terminal backend + sandbox
gateway Messaging platforms
tools Per-platform tool toggles
agent Agent behavior

Flags: --non-interactive, --reset.


7. In-session slash commands

Command Effect
/help Help
/new New conversation
/reset Reset context
/model Show / change current model. --global persists
/personality [name] Session persona overlay
/retry Regenerate last response
/undo Rewind
/compress Summarize / compress conversation
/usage Tokens / cost
/insights Session analytics
/skills Loaded skills list
/skills browse Browse the skills hub
/tools List available tools
/background <prompt> Run a separate background session
/voice on Enable voice mode (record with Ctrl+B)
/voice tts Toggle TTS replies
/reasoning high Increase reasoning effort
/title My Session Name the current session
/verbose Cycle verbose modes (off → new → all → verbose)
/stop Stop the current operation

Case-insensitive: per the docs, /HELP and /help are equivalent.


8. Auth, cron, webhook subcommands

8.1 hermes auth

hermes auth add <provider> [--api-key <key> | --type oauth]
hermes auth list [provider]
hermes auth remove <provider> <index>
hermes auth reset <provider>   # reset cooldowns

Multiple keys per provider are supported (for rate-limit spreading).

8.2 hermes cron

Sub Effect
list List scheduled jobs
create Create job (can specify skills)
edit Update schedule / prompt / skills
pause / resume Suspend / resume
run Force-run on next tick
remove Delete
status Scheduler running?
tick Execute due jobs once and exit

8.3 hermes webhook

hermes webhook subscribe <name> \
  --prompt "Summarize incoming event" \
  --events "push,pr_merged" \
  --description "GitHub event summarizer" \
  --skills "github-summary" \
  --deliver telegram \
  --deliver-chat-id 123456 \
  --secret $WEBHOOK_SECRET

hermes webhook list
hermes webhook test <name>
hermes webhook remove <name>

9. Log queries

hermes logs                # Default (50 lines)
hermes logs agent          # Agent log
hermes logs errors         # Errors only
hermes logs gateway        # Gateway
hermes logs list           # List available logs

hermes logs -f
hermes logs -f --level ERROR

hermes logs --session abc123

hermes logs --since 30m
hermes logs --since 2h
hermes logs --since 1d

hermes logs --component gateway

10. Skills · MCP · Plugins

10.1 hermes skills

Sub Effect
browse Paginated registry browser
search Search registries
install Install
inspect Preview without installing
list Installed skills
check Check for upstream updates
update Apply upstream changes
audit Re-scan for issues
uninstall Remove
publish Publish to registry
snapshot Export / import configs
tap Manage custom skill sources
config Per-platform enable / disable

10.2 hermes mcp

hermes mcp add <name> [options]    # Add MCP server
hermes mcp list                    # List
hermes mcp test <name>             # Connection test
hermes mcp configure <name>        # Toggle tool selection
hermes mcp remove <name>           # Remove
hermes mcp serve [-v]              # Hermes as MCP server

10.3 hermes plugins

Sub Effect
(no arg) Composite UI: toggles + provider config
install Install from Git URL or owner/repo
update Pull latest
remove Remove
enable / disable Enable / disable
list List with status

11. Profiles — multiple isolated instances

Sub Syntax Effect
list hermes profile list List profiles
use hermes profile use <name> Set default profile
create hermes profile create <name> [--clone\|--clone-all\|--clone-from] Create
delete hermes profile delete <name> [-y] Delete
show hermes profile show <name> Details
alias hermes profile alias <name> [--remove\|--name] Manage wrappers
rename hermes profile rename <old> <new> Rename
export hermes profile export <name> [-o FILE] .tar.gz export
import hermes profile import <archive> [--name] Import

Profiles hold fully separated Hermes state (work / personal / etc.). Each at ~/.hermes/profiles/<name>/.


12. Memory providers

hermes memory setup     # Interactive selection
hermes memory status    # Current config
hermes memory off       # Disable external

Supported providers (official): honcho, openviking, mem0, hindsight, holographic, retaindb, byterover, supermemory.

Honcho dialectic model is managed separately via hermes honcho (peers / sessions / modes / tokens / etc.).


13. Shortcuts & interrupts

Key Effect
Enter (during agent work) Interrupt + feed new message
Ctrl+C Abort. Press twice within 2s to force-quit
Ctrl+Z (Unix) Suspend to background. fg resumes
Ctrl+B (voice on) Record audio

14. Session persistence — where and how

Per the docs:

  • State DB: ~/.hermes/state.db (SQLite)
  • Stores: metadata, message history, lineage, full-text indexes
  • Auto context compression: middle turns summarized; first 3 + last 4 turns always preserved

Session navigation:

hermes sessions list            # Recent
hermes sessions browse          # Interactive search
hermes sessions export          # JSONL
hermes sessions rename <id>     # Change title
hermes sessions prune --days 90 # Delete old
hermes sessions stats           # Store statistics

15. Ten useful combos

hermes chat -q "what caused this error?"

hermes chat -m "anthropic/claude-sonnet-4" -q "..."

hermes -c

hermes -s github-auth -q "list 3 recent open issues"

hermes dump | pbcopy   # macOS

hermes backup -o ~/hermes-backup-$(date +%Y%m%d).zip

hermes logs -f --level ERROR

hermes gateway install && hermes gateway start

hermes -p work chat -q "summarize this week's standups"

hermes claw migrate --dry-run
hermes claw migrate --preset full --migrate-secrets

16. Counter-scenarios — when this cheatsheet isn't needed

  • Simple CLI chat onlyhermes alone is enough; browse the rest as needed.
  • Early-version instability → Commands get added / renamed often post Feb 2026 release. Always check the last verified date.
  • Learning goal rather than automation → Just memorize hermes doctor + hermes status; pick up the rest as you run into situations.

17. What's next

With the map in hand:

  1. Install guide + SOUL.md — if not installed yet.
  2. Persistent memory FTS5 in practice (coming soon) — hermes memory / hermes honcho deep dive.
  3. OpenClaw → Hermes migration checklist (coming soon) — all hermes claw migrate options.

References


This is post 13/15 in the "AI Coding CLI Entry Guide" series.
last verified: 2026-04-25 (per hermes-agent.nousresearch.com/docs/reference/cli-commands + user-guide/cli).

Series overview: Series index

๋Œ“๊ธ€

์ด ๋ธ”๋กœ๊ทธ์˜ ์ธ๊ธฐ ๊ฒŒ์‹œ๋ฌผ

Agent Memory Engine (2/10) — Building an AI Agent Memory System with SQLite Alone

"ML Foundations (9/9) — PyTorch vs TensorFlow, and the Road to Local LLMs"

"RAG Core Study (14/26) — Evaluation Sets with RAGAS & DeepEval"

"ML Foundations (8/9) — Deep Learning Architectures: CNN, RNN, Attention"

"ML Foundations (7/9) — Deep Learning Training: Optimizers, Regularization, Initialization"

OpenClaw to Hermes Migration (2/13) — What to Preserve, Partially Port, or Discard

AI Agents I Built (5/7) — Building an Automated Blogger API Publishing System