mumuni-bot
c7af7c0689
Provenance: kanban t_02148213 (research) -> t_4265c369 (author) -> t_fefdf30b (review). Review verdict: APPROVED-WITH-FIXES, 7/7 checks PASS, 17/17 YouTube links oEmbed-verified, 26+ CLI commands re-run against v0.21.1, no Murray/JDS client data present. Artifact: deliverables/scot-hermes-playbook/HERMES-PLAYBOOK-FOR-SCOT.md 377 lines, sha256 b0966a649fec96da4975ec00e627fbaba3a92a62c4a92b33bc06589c47d25f7f Includes the research dossier and its raw verification evidence under research/. STATUS: written and reviewed, NOT delivered to the client. Delivery is gated on Kwame's approval and tracked as a separate blocked kanban card.
8.0 KiB
8.0 KiB
03 — Command Cheatsheet (every entry verified)
Verification method: each VERIFIED-LIVE entry was confirmed against hermes --help or hermes <cmd> --help on Hermes Agent v0.21.1 (2026.9.7), reference install (Syslog kagentz), 2026-09-11. Raw output: cli-help-dump.txt. DOC-ONLY entries come from the official docs (URL given). Nothing is invented.
(a) CLI — hermes ...
Setup & health
| Command | What it does | Tag |
|---|---|---|
hermes setup |
Interactive setup wizard | VERIFIED-LIVE |
hermes doctor [--fix] [--live] |
Diagnose config/deps; --fix auto-repairs |
VERIFIED-LIVE |
hermes status [--all] [--deep] |
Component status | VERIFIED-LIVE |
hermes config show/edit/get/set/unset/path/env-path/check/migrate |
View/edit config | VERIFIED-LIVE |
hermes update |
Update Hermes to latest | VERIFIED-LIVE |
The Claude Code bridge (highest value for Scot)
| Command | What it does | Tag |
|---|---|---|
hermes import-agent claude-code [--dry-run] [--overwrite] [--yes] |
One-command import of a Claude Code setup: maps CLAUDE.md/AGENTS.md instructions, permission allowlists, MCP servers, skills, memories into Hermes equivalents. Never imports API keys. | VERIFIED-LIVE |
hermes import-agent codex |
Same for Codex CLI setups | VERIFIED-LIVE |
hermes sessions import |
Import a Claude Code or Codex CLI session/conversation into Hermes | VERIFIED-LIVE (subcommand listed in hermes sessions --help) |
hermes skills trust |
Trust a repo so its project-local skills (./.hermes/skills) load — the Hermes analog of .claude/skills/ |
VERIFIED-LIVE |
Daily driving
| Command | What it does | Tag |
|---|---|---|
hermes / hermes chat |
Interactive session | VERIFIED-LIVE |
hermes -c [NAME] / hermes --resume <id|latest> |
Resume by name or ID | VERIFIED-LIVE |
hermes --in DIR --resume latest |
Resume the latest session for a directory | VERIFIED-LIVE |
hermes -z "PROMPT" |
One-shot: prints ONLY the final answer (scripting/CI); tools, memory, and AGENTS.md still load | VERIFIED-LIVE |
hermes chat -q "PROMPT" |
Single-query mode | VERIFIED-LIVE |
hermes -m MODEL --provider PROVIDER --reasoning LEVEL |
Per-run model/provider/reasoning overrides (none…ultra) |
VERIFIED-LIVE |
hermes -s SKILL1,SKILL2 |
Preload specific skills for the session | VERIFIED-LIVE |
hermes -t TOOLSETS |
Restrict toolsets for this run | VERIFIED-LIVE |
hermes -w |
Isolated git worktree session (parallel agents on one repo) | VERIFIED-LIVE |
hermes chat --checkpoints |
Enable filesystem checkpoints (/rollback to restore) |
VERIFIED-LIVE |
hermes chat --max-turns N / --run-budget SECONDS |
Cap loop iterations / wall-clock budget | VERIFIED-LIVE |
Context & memory management
| Command | What it does | Tag |
|---|---|---|
hermes memory setup/status/off/reset |
External memory provider management (built-in MEMORY.md/USER.md always active) | VERIFIED-LIVE |
hermes sessions list/browse/rename/pin/export/prune/stats |
Session store management | VERIFIED-LIVE |
hermes skills list/search/install/inspect/browse/config/check/update |
Skill management | VERIFIED-LIVE |
hermes skills trust/untrust |
Repo-local skill trust | VERIFIED-LIVE |
hermes curator status/run/pause/pin/... |
Background skill maintenance (auto-archive, backups) | VERIFIED-LIVE |
hermes prompt-size |
Byte breakdown of system prompt + tool schemas (context-bloat diagnosis) | VERIFIED-LIVE |
hermes insights [--days N] |
Usage analytics | VERIFIED-LIVE |
Tools, MCP, integrations
| Command | What it does | Tag |
|---|---|---|
hermes tools (interactive) / list/enable/disable |
Per-platform toolset toggles; MCP tools as server:tool |
VERIFIED-LIVE |
hermes mcp add/remove/list/test/configure/picker/catalog/install |
MCP server management (incl. one-click catalog installs) | VERIFIED-LIVE |
hermes mcp serve |
Run Hermes AS an MCP server for other agents | VERIFIED-LIVE |
hermes computer-use install/status/doctor |
Desktop-control backend (cua-driver) | VERIFIED-LIVE |
hermes gateway run/install/start/status/setup |
Messaging gateway (Telegram, Discord, Slack, WhatsApp, …) | VERIFIED-LIVE |
hermes send |
Send a message to a configured platform (scripts/cron/CI) | VERIFIED-LIVE |
Automation & multi-agent
| Command | What it does | Tag |
|---|---|---|
hermes cron list/create/edit/pause/resume/run/remove/doctor |
Scheduled jobs (durable, multi-platform delivery) | VERIFIED-LIVE |
hermes cron notepad |
Durable per-job key-value notepad across runs | VERIFIED-LIVE |
hermes kanban create/list/show/link/complete/swarm/... |
Durable multi-profile task board (40+ verbs) | VERIFIED-LIVE |
hermes kanban swarm |
Generate a parallel-workers → verifier → synthesizer task graph | VERIFIED-LIVE |
hermes project create/list/add-folder/bind-board |
Named multi-folder workspaces (desktop Projects) | VERIFIED-LIVE |
hermes profile list/create/use/alias/export/import |
Isolated Hermes instances | VERIFIED-LIVE |
hermes auth add/list/priority/reset |
Pooled credentials per provider (rotation) | VERIFIED-LIVE |
hermes fallback list/add/remove |
Fallback model chain (auto-rollover on failure) | VERIFIED-LIVE |
hermes model |
Interactive model/provider picker | VERIFIED-LIVE |
hermes -yolo |
Bypass command approval prompts (use with care) | VERIFIED-LIVE |
hermes pause / hermes resume |
Emergency stop / lift (pauses cron, kanban dispatch, gateway turns) | VERIFIED-LIVE |
(b) In-session slash commands
Source: official slash-commands reference https://hermes-agent.nousresearch.com/docs/reference/slash-commands (DOC-ONLY — slash commands run inside a chat session and were not exercised from this headless research run; the CLI subcommands they map to were verified live). DOC-ONLY.
Context & session
| Command | What it does |
|---|---|
/help |
List all commands (authoritative in your version) |
/new (/reset) |
Fresh session |
/resume [name] |
Resume a named/recent session |
/branch (/fork) |
Branch the current session |
/compress |
Manually compress context (auto-compression also exists) |
/undo |
Remove last exchange |
/retry |
Resend last message |
/title [name] |
Name the session |
/save |
Save conversation to file |
/history |
Show conversation history |
Power surfaces
| Command | What it does |
|---|---|
/skill <name> |
Load a skill into the session |
/skills |
Search/install skills |
/reload-skills |
Re-scan skill directory |
/tools / /toolsets |
Manage tools |
/goal [text] |
Set a standing goal the agent works toward across turns (/goal status/pause/clear to manage) |
/background <prompt> |
Run a prompt in the background |
/queue <prompt> |
Queue a prompt for the next turn |
/steer <prompt> |
Inject a course-correction after the next tool call without interrupting |
/agents |
Show active agents and running tasks |
/cron |
Manage cron jobs in-session |
/kanban |
Multi-profile collaboration board in-session |
/model [name] |
Show/change model mid-session |
/reasoning [level] |
Set reasoning effort |
/voice [on|off|tts] |
Voice mode |
/rollback [N] |
Restore filesystem checkpoint (needs --checkpoints) |
/usage |
Token usage |
/insights [days] |
Usage analytics |
/platforms |
Gateway platform status |
/compact-equivalent note |
Hermes compresses automatically near the context limit; no manual threshold watch needed like Claude Code's /context |
The "work alongside Claude Code" shortlist
hermes import-agent claude-code --dry-run→ migrate the setup (VERIFIED-LIVE)hermes sessions import→ bring the conversation history over (VERIFIED-LIVE)hermes skills trust→ load repo-local skills like.claude/skills/(VERIFIED-LIVE)hermes -c/hermes --in <repo> --resume latest→ per-directory session continuity (VERIFIED-LIVE)hermes mcp serve→ expose Hermes to Claude Code as an MCP server (VERIFIED-LIVE) — the reverse direction Claude Code can't do