diff --git a/wizard-work/quill/hermes-quickstart-cheatsheet.md b/wizard-work/quill/hermes-quickstart-cheatsheet.md new file mode 100644 index 0000000..ff6d260 --- /dev/null +++ b/wizard-work/quill/hermes-quickstart-cheatsheet.md @@ -0,0 +1,82 @@ +# Hermes Agent Quick-Start Cheat Sheet +*Drafted by Quill — evidence-based, sourced from the hermes-agent skill (version 3.2.0).* + +## 1. Install +```bash +curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash +``` + +## 2. First Run +```bash +hermes # interactive chat +hermes chat -q "..." # single-shot query +hermes setup # guided setup wizard +hermes doctor # health check +``` + +## 3. Key Paths (Linux/macOS/WSL) +``` +~/.hermes/config.yaml # main settings +~/.hermes/.env # API keys / secrets +~/.hermes/skills/ # installed skills +~/.hermes/sessions/ # transcripts, gateway routing +~/.hermes/state.db # session store (SQLite + FTS5) +~/.hermes/profiles// # per-profile isolated layout +``` + +## 4. Surfaces +| Command | Surface | +|---|---| +| `hermes` / `hermes --tui` | CLI / Ink TUI | +| `hermes desktop` / `hermes gui` | Electron desktop app | +| `hermes dashboard` | web admin + chat | +| `hermes proxy` | OpenAI-compatible local proxy | + +## 5. Config (never hand-edit) +```bash +hermes config set KEY VAL +hermes config get KEY +hermes model # pick provider + model +``` + +## 6. Skills & Memory +```bash +# Skills are reusable procedures auto-loaded into future sessions. +# Memory persists who you are + lessons learned across sessions. +# Both live under $HERMES_HOME (never hardcode ~/.hermes in scripts). +``` + +## 7. Spawning Agents +```bash +# Quick subtasks — use delegate_task inside a session. +# Long autonomous missions — spawn a separate hermes process: + +# tmux backend agent +tmux new-session -d -s backend -x 120 -y 40 'hermes -w' + +# tmux frontend agent +tmux new-session -d -s frontend -x 120 -y 40 'hermes -w' +``` + +## 8. Bots & Scheduling +```bash +# Bots: chat, run routines, message each other (see docs: /user-guide/bot-mode) +# Cron: use the built-in cronjob tool for scheduled runs with delivery. +# Webhooks: event-driven agent runs (references/webhooks.md). +``` + +## 9. Extend +```bash +hermes mcp # manage MCP servers +hermes skin set # tweak active skin color +``` + +## 10. Hard Rules +- Secrets in `.env`, settings in `config.yaml` +- Use `hermes config set` — never edit `config.yaml` by hand +- Profile-safe paths: use `$HERMES_HOME`, not `~/.hermes` +- Never break prompt caching mid-conversation +- Message role alternation: no two assistant/user messages in a row + +--- +Source: hermes-agent skill v3.2.0 (Nous Research). Docs: https://hermes-agent.nousresearch.com/docs/