mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-05-14 04:02:26 +00:00
docs(skill/hermes-agent): sync slash commands + add durable-systems section
Mirrors the AGENTS.md #20226 additions (Toolsets / Delegation / Curator / Cron / Kanban) into the user-facing hermes-agent skill, and closes the drift in the in-session slash command list. User report (wxrrior in Discord): the skill did not mention /goal, so a brand-new session answering "/hermes-agent do you have any info on /goal" confidently said it did not exist. Cross-check against the CommandDef registry found 16 commands missing from the static list: /goal, /agents, /busy, /copy, /curator, /debug, /footer, /gquota, /indicator, /kanban, /redraw, /reload, /reload-skills, /snapshot, /steer, /topic. Changes: - Slash Commands header now tells the reader to run /help or check the live docs reference as the source of truth, and names the registry of record (hermes_cli/commands.py) so future drift gets flagged honestly instead of answered confidently wrong. - Added all 16 missing commands, slotted into existing subsections (/goal and /steer in Session; /busy + /indicator + /footer in Configuration; /curator + /kanban + /reload-skills + /reload in Tools & Skills; /topic in Gateway; /copy in Utility; /gquota + /debug in Info). - Toolsets table updated to the authoritative 30-key list from toolsets.py (added kanban, yuanbao, spotify, safe, debugging, video, feishu_doc, feishu_drive, discord, discord_admin, clarify; previously stopped at 20 keys). - New "Durable & Background Systems" section before Troubleshooting covers Delegation, Cron, Curator, Kanban - each with a short rundown of CLI verbs, key invariants, and a pointer to the user-facing docs. Mirrors AGENTS.md #20226 but in the skill's user-facing register. - Bumped version 2.0.0 -> 2.1.0.
This commit is contained in:
parent
c28c2a2380
commit
0dc677f071
1 changed files with 129 additions and 5 deletions
|
|
@ -1,7 +1,7 @@
|
||||||
---
|
---
|
||||||
name: hermes-agent
|
name: hermes-agent
|
||||||
description: "Configure, extend, or contribute to Hermes Agent."
|
description: "Configure, extend, or contribute to Hermes Agent."
|
||||||
version: 2.0.0
|
version: 2.1.0
|
||||||
author: Hermes Agent + Teknium
|
author: Hermes Agent + Teknium
|
||||||
license: MIT
|
license: MIT
|
||||||
metadata:
|
metadata:
|
||||||
|
|
@ -227,7 +227,11 @@ hermes uninstall Uninstall Hermes
|
||||||
|
|
||||||
## Slash Commands (In-Session)
|
## Slash Commands (In-Session)
|
||||||
|
|
||||||
Type these during an interactive chat session.
|
Type these during an interactive chat session. New commands land fairly
|
||||||
|
often; if something below looks stale, run `/help` in-session for the
|
||||||
|
authoritative list or see the [live slash commands reference](https://hermes-agent.nousresearch.com/docs/reference/slash-commands).
|
||||||
|
The registry of record is `hermes_cli/commands.py` — every consumer
|
||||||
|
(autocomplete, Telegram menu, Slack mapping, `/help`) derives from it.
|
||||||
|
|
||||||
### Session Control
|
### Session Control
|
||||||
```
|
```
|
||||||
|
|
@ -239,9 +243,15 @@ Type these during an interactive chat session.
|
||||||
/compress Manually compress context
|
/compress Manually compress context
|
||||||
/stop Kill background processes
|
/stop Kill background processes
|
||||||
/rollback [N] Restore filesystem checkpoint
|
/rollback [N] Restore filesystem checkpoint
|
||||||
|
/snapshot [sub] Create or restore state snapshots of Hermes config/state (CLI)
|
||||||
/background <prompt> Run prompt in background
|
/background <prompt> Run prompt in background
|
||||||
/queue <prompt> Queue for next turn
|
/queue <prompt> Queue for next turn
|
||||||
|
/steer <prompt> Inject a message after the next tool call without interrupting
|
||||||
|
/agents (/tasks) Show active agents and running tasks
|
||||||
/resume [name] Resume a named session
|
/resume [name] Resume a named session
|
||||||
|
/goal [text|sub] Set a standing goal Hermes works on across turns until achieved
|
||||||
|
(subcommands: status, pause, resume, clear)
|
||||||
|
/redraw Force a full UI repaint (CLI)
|
||||||
```
|
```
|
||||||
|
|
||||||
### Configuration
|
### Configuration
|
||||||
|
|
@ -253,6 +263,11 @@ Type these during an interactive chat session.
|
||||||
/verbose Cycle: off → new → all → verbose
|
/verbose Cycle: off → new → all → verbose
|
||||||
/voice [on|off|tts] Voice mode
|
/voice [on|off|tts] Voice mode
|
||||||
/yolo Toggle approval bypass
|
/yolo Toggle approval bypass
|
||||||
|
/busy [sub] Control what Enter does while Hermes is working (CLI)
|
||||||
|
(subcommands: queue, steer, interrupt, status)
|
||||||
|
/indicator [style] Pick the TUI busy-indicator style (CLI)
|
||||||
|
(styles: kaomoji, emoji, unicode, ascii)
|
||||||
|
/footer [on|off] Toggle gateway runtime-metadata footer on final replies
|
||||||
/skin [name] Change theme (CLI)
|
/skin [name] Change theme (CLI)
|
||||||
/statusbar Toggle status bar (CLI)
|
/statusbar Toggle status bar (CLI)
|
||||||
```
|
```
|
||||||
|
|
@ -263,8 +278,12 @@ Type these during an interactive chat session.
|
||||||
/toolsets List toolsets (CLI)
|
/toolsets List toolsets (CLI)
|
||||||
/skills Search/install skills (CLI)
|
/skills Search/install skills (CLI)
|
||||||
/skill <name> Load a skill into session
|
/skill <name> Load a skill into session
|
||||||
/cron Manage cron jobs (CLI)
|
/reload-skills Re-scan ~/.hermes/skills/ for added/removed skills
|
||||||
|
/reload Reload .env variables into the running session (CLI)
|
||||||
/reload-mcp Reload MCP servers
|
/reload-mcp Reload MCP servers
|
||||||
|
/cron Manage cron jobs (CLI)
|
||||||
|
/curator [sub] Background skill maintenance (status, run, pin, archive, …)
|
||||||
|
/kanban [sub] Multi-profile collaboration board (tasks, links, comments)
|
||||||
/plugins List plugins (CLI)
|
/plugins List plugins (CLI)
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
@ -275,6 +294,7 @@ Type these during an interactive chat session.
|
||||||
/restart Restart gateway (gateway)
|
/restart Restart gateway (gateway)
|
||||||
/sethome Set current chat as home channel (gateway)
|
/sethome Set current chat as home channel (gateway)
|
||||||
/update Update Hermes to latest (gateway)
|
/update Update Hermes to latest (gateway)
|
||||||
|
/topic [sub] Enable or inspect Telegram DM topic sessions (gateway)
|
||||||
/platforms (/gateway) Show platform connection status (gateway)
|
/platforms (/gateway) Show platform connection status (gateway)
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
@ -285,6 +305,7 @@ Type these during an interactive chat session.
|
||||||
/browser Open CDP browser connection
|
/browser Open CDP browser connection
|
||||||
/history Show conversation history (CLI)
|
/history Show conversation history (CLI)
|
||||||
/save Save conversation to file (CLI)
|
/save Save conversation to file (CLI)
|
||||||
|
/copy [N] Copy the last assistant response to clipboard (CLI)
|
||||||
/paste Attach clipboard image (CLI)
|
/paste Attach clipboard image (CLI)
|
||||||
/image Attach local image file (CLI)
|
/image Attach local image file (CLI)
|
||||||
```
|
```
|
||||||
|
|
@ -295,8 +316,10 @@ Type these during an interactive chat session.
|
||||||
/commands [page] Browse all commands (gateway)
|
/commands [page] Browse all commands (gateway)
|
||||||
/usage Token usage
|
/usage Token usage
|
||||||
/insights [days] Usage analytics
|
/insights [days] Usage analytics
|
||||||
|
/gquota Show Google Gemini Code Assist quota usage (CLI)
|
||||||
/status Session info (gateway)
|
/status Session info (gateway)
|
||||||
/profile Active profile info
|
/profile Active profile info
|
||||||
|
/debug Upload debug report (system info + logs) and get shareable links
|
||||||
```
|
```
|
||||||
|
|
||||||
### Exit
|
### Exit
|
||||||
|
|
@ -378,12 +401,14 @@ Enable/disable via `hermes tools` (interactive) or `hermes tools enable/disable
|
||||||
| Toolset | What it provides |
|
| Toolset | What it provides |
|
||||||
|---------|-----------------|
|
|---------|-----------------|
|
||||||
| `web` | Web search and content extraction |
|
| `web` | Web search and content extraction |
|
||||||
|
| `search` | Web search only (subset of `web`) |
|
||||||
| `browser` | Browser automation (Browserbase, Camofox, or local Chromium) |
|
| `browser` | Browser automation (Browserbase, Camofox, or local Chromium) |
|
||||||
| `terminal` | Shell commands and process management |
|
| `terminal` | Shell commands and process management |
|
||||||
| `file` | File read/write/search/patch |
|
| `file` | File read/write/search/patch |
|
||||||
| `code_execution` | Sandboxed Python execution |
|
| `code_execution` | Sandboxed Python execution |
|
||||||
| `vision` | Image analysis |
|
| `vision` | Image analysis |
|
||||||
| `image_gen` | AI image generation |
|
| `image_gen` | AI image generation |
|
||||||
|
| `video` | Video analysis and generation |
|
||||||
| `tts` | Text-to-speech |
|
| `tts` | Text-to-speech |
|
||||||
| `skills` | Skill browsing and management |
|
| `skills` | Skill browsing and management |
|
||||||
| `memory` | Persistent cross-session memory |
|
| `memory` | Persistent cross-session memory |
|
||||||
|
|
@ -392,11 +417,21 @@ Enable/disable via `hermes tools` (interactive) or `hermes tools enable/disable
|
||||||
| `cronjob` | Scheduled task management |
|
| `cronjob` | Scheduled task management |
|
||||||
| `clarify` | Ask user clarifying questions |
|
| `clarify` | Ask user clarifying questions |
|
||||||
| `messaging` | Cross-platform message sending |
|
| `messaging` | Cross-platform message sending |
|
||||||
| `search` | Web search only (subset of `web`) |
|
|
||||||
| `todo` | In-session task planning and tracking |
|
| `todo` | In-session task planning and tracking |
|
||||||
|
| `kanban` | Multi-agent work-queue tools (gated to workers) |
|
||||||
|
| `debugging` | Extra introspection/debug tools (off by default) |
|
||||||
|
| `safe` | Minimal, low-risk toolset for locked-down sessions |
|
||||||
|
| `spotify` | Spotify playback and playlist control |
|
||||||
|
| `homeassistant` | Smart home control (off by default) |
|
||||||
|
| `discord` | Discord integration tools |
|
||||||
|
| `discord_admin` | Discord admin/moderation tools |
|
||||||
|
| `feishu_doc` | Feishu (Lark) document tools |
|
||||||
|
| `feishu_drive` | Feishu (Lark) drive tools |
|
||||||
|
| `yuanbao` | Yuanbao integration tools |
|
||||||
| `rl` | Reinforcement learning tools (off by default) |
|
| `rl` | Reinforcement learning tools (off by default) |
|
||||||
| `moa` | Mixture of Agents (off by default) |
|
| `moa` | Mixture of Agents (off by default) |
|
||||||
| `homeassistant` | Smart home control (off by default) |
|
|
||||||
|
Full enumeration lives in `toolsets.py` as the `TOOLSETS` dict; `_HERMES_CORE_TOOLS` is the default bundle most platforms inherit from.
|
||||||
|
|
||||||
Tool changes take effect on `/reset` (new session). They do NOT apply mid-conversation to preserve prompt caching.
|
Tool changes take effect on `/reset` (new session). They do NOT apply mid-conversation to preserve prompt caching.
|
||||||
|
|
||||||
|
|
@ -576,6 +611,95 @@ terminal(command="tmux new-session -d -s resumed 'hermes --resume 20260225_14305
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
## Durable & Background Systems
|
||||||
|
|
||||||
|
Four systems run alongside the main conversation loop. Quick reference
|
||||||
|
here; full developer notes live in `AGENTS.md`, user-facing docs under
|
||||||
|
`website/docs/user-guide/features/`.
|
||||||
|
|
||||||
|
### Delegation (`delegate_task`)
|
||||||
|
|
||||||
|
Synchronous subagent spawn — the parent waits for the child's summary
|
||||||
|
before continuing its own loop. Isolated context + terminal session.
|
||||||
|
|
||||||
|
- **Single:** `delegate_task(goal, context, toolsets)`.
|
||||||
|
- **Batch:** `delegate_task(tasks=[{goal, ...}, ...])` runs children in
|
||||||
|
parallel, capped by `delegation.max_concurrent_children` (default 3).
|
||||||
|
- **Roles:** `leaf` (default; cannot re-delegate) vs `orchestrator`
|
||||||
|
(can spawn its own workers, bounded by `delegation.max_spawn_depth`).
|
||||||
|
- **Not durable.** If the parent is interrupted, the child is
|
||||||
|
cancelled. For work that must outlive the turn, use `cronjob` or
|
||||||
|
`terminal(background=True, notify_on_complete=True)`.
|
||||||
|
|
||||||
|
Config: `delegation.*` in `config.yaml`.
|
||||||
|
|
||||||
|
### Cron (scheduled jobs)
|
||||||
|
|
||||||
|
Durable scheduler — `cron/jobs.py` + `cron/scheduler.py`. Drive it via
|
||||||
|
the `cronjob` tool, the `hermes cron` CLI (`list`, `add`, `edit`,
|
||||||
|
`pause`, `resume`, `run`, `remove`), or the `/cron` slash command.
|
||||||
|
|
||||||
|
- **Schedules:** duration (`"30m"`, `"2h"`), "every" phrase
|
||||||
|
(`"every monday 9am"`), 5-field cron (`"0 9 * * *"`), or ISO timestamp.
|
||||||
|
- **Per-job knobs:** `skills`, `model`/`provider` override, `script`
|
||||||
|
(pre-run data collection; `no_agent=True` makes the script the whole
|
||||||
|
job), `context_from` (chain job A's output into job B), `workdir`
|
||||||
|
(run in a specific dir with its `AGENTS.md` / `CLAUDE.md` loaded),
|
||||||
|
multi-platform delivery.
|
||||||
|
- **Invariants:** 3-minute hard interrupt per run, `.tick.lock` file
|
||||||
|
prevents duplicate ticks across processes, cron sessions pass
|
||||||
|
`skip_memory=True` by default, and cron deliveries are framed with a
|
||||||
|
header/footer instead of being mirrored into the target gateway
|
||||||
|
session (keeps role alternation intact).
|
||||||
|
|
||||||
|
User docs: https://hermes-agent.nousresearch.com/docs/user-guide/features/cron
|
||||||
|
|
||||||
|
### Curator (skill lifecycle)
|
||||||
|
|
||||||
|
Background maintenance for agent-created skills. Tracks usage, marks
|
||||||
|
idle skills stale, archives stale ones, keeps a pre-run tar.gz backup
|
||||||
|
so nothing is lost.
|
||||||
|
|
||||||
|
- **CLI:** `hermes curator <verb>` — `status`, `run`, `pause`, `resume`,
|
||||||
|
`pin`, `unpin`, `archive`, `restore`, `prune`, `backup`, `rollback`.
|
||||||
|
- **Slash:** `/curator <subcommand>` mirrors the CLI.
|
||||||
|
- **Scope:** only touches skills with `created_by: "agent"` provenance.
|
||||||
|
Bundled + hub-installed skills are off-limits. **Never deletes** —
|
||||||
|
max destructive action is archive. Pinned skills are exempt from
|
||||||
|
every auto-transition and every LLM review pass.
|
||||||
|
- **Telemetry:** sidecar at `~/.hermes/skills/.usage.json` holds
|
||||||
|
per-skill `use_count`, `view_count`, `patch_count`,
|
||||||
|
`last_activity_at`, `state`, `pinned`.
|
||||||
|
|
||||||
|
Config: `curator.*` (`enabled`, `interval_hours`, `min_idle_hours`,
|
||||||
|
`stale_after_days`, `archive_after_days`, `backup.*`).
|
||||||
|
User docs: https://hermes-agent.nousresearch.com/docs/user-guide/features/curator
|
||||||
|
|
||||||
|
### Kanban (multi-agent work queue)
|
||||||
|
|
||||||
|
Durable SQLite board for multi-profile / multi-worker collaboration.
|
||||||
|
Users drive it via `hermes kanban <verb>`; dispatcher-spawned workers
|
||||||
|
see a focused `kanban_*` toolset gated by `HERMES_KANBAN_TASK` so the
|
||||||
|
schema footprint is zero outside worker processes.
|
||||||
|
|
||||||
|
- **CLI verbs (common):** `init`, `create`, `list` (alias `ls`),
|
||||||
|
`show`, `assign`, `link`, `unlink`, `comment`, `complete`, `block`,
|
||||||
|
`unblock`, `archive`, `tail`. Less common: `watch`, `stats`, `runs`,
|
||||||
|
`log`, `dispatch`, `daemon`, `gc`.
|
||||||
|
- **Worker toolset:** `kanban_show`, `kanban_complete`, `kanban_block`,
|
||||||
|
`kanban_heartbeat`, `kanban_comment`, `kanban_create`, `kanban_link`.
|
||||||
|
- **Dispatcher** runs inside the gateway by default
|
||||||
|
(`kanban.dispatch_in_gateway: true`) — reclaims stale claims,
|
||||||
|
promotes ready tasks, atomically claims, spawns assigned profiles.
|
||||||
|
Auto-blocks a task after ~5 consecutive spawn failures.
|
||||||
|
- **Isolation:** board is the hard boundary (workers get
|
||||||
|
`HERMES_KANBAN_BOARD` pinned in env); tenant is a soft namespace
|
||||||
|
within a board for workspace-path + memory-key isolation.
|
||||||
|
|
||||||
|
User docs: https://hermes-agent.nousresearch.com/docs/user-guide/features/kanban
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## Troubleshooting
|
## Troubleshooting
|
||||||
|
|
||||||
### Voice not working
|
### Voice not working
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue