mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-11-06 05:17:15 +00:00
19 lines
2.6 KiB
YAML
19 lines
2.6 KiB
YAML
name: hermes-guide
|
|
repo: https://github.com/iap/hermes-guide
|
|
sha: 9690c41665c2de09043fa12f19c7c081247ab831
|
|
description: "Read-only diagnostics for Hermes configuration: /hermes-doctor in-session and hermes guide in a terminal. Ten read-only health checks (config, mcp, skills, commands, hooks, plugins, memories, sessions, storage, update) and points to 31 troubleshooting skills, installed separately as a skills tap, for what the built-in doctor doesn't cover. Complements — never replaces — hermes doctor. Disclosure — reads config.yaml, SKILL.md frontmatter, skill bundles, plugin manifests, the shell-hooks allowlist and the built-in MEMORY.md/USER.md stores read-only (the report quotes short memory snippets); the sessions scope reads the tail of logs/agent.log read-only for runaway-session signatures (session ids, model names and token counts appear in the report); the storage scope stats $HERMES_HOME/state.db for its size only (never opens it); the update scope reads the update-lock record in the co-located hermes-agent checkout under $HERMES_HOME and probes it — owner-PID liveness, then a brief lock acquisition it releases immediately, opening the lock file writable, with a read-only fallback for a root-owned lock on POSIX (writes no content, never deletes the lock); registers one read-only plugin skill, hermes-guide:start, listed in model sessions while the plugin is enabled; /hermes-doctor and hermes guide run hermes config path as a subprocess (argument list, no shell); the default hooks check reads hook configuration, consent state and the exec bit in-process and executes nothing, while hooks --deep runs hermes hooks doctor, which executes every approved shell hook once with a synthetic payload (--fast starts no subprocess and executes no hook); /hermes-doctor and hermes guide (except with --fast or --json) also run git ls-remote once per process against the plugin's GitHub repo to print a newer-release notice (no download, no local writes); with opt-in proactive: true it runs the checks (including the agent.log scan and the update-lock probe) in-process at each session start/end (no hooks executed, no subprocesses, no network). The 31 troubleshooting skills are not loaded by the plugin: they install separately from the repo as a skills tap, which this entry's pin does not cover."
|
|
maintainer: iap
|
|
tier: community
|
|
category: tools
|
|
requires_hermes: ">=0.21.0"
|
|
version: "0.9.3"
|
|
platforms: []
|
|
capabilities:
|
|
provides_tools: []
|
|
provides_hooks:
|
|
- on_session_start (opt-in proactive mode)
|
|
- on_session_end (opt-in proactive mode)
|
|
provides_middleware: []
|
|
requires_env: []
|
|
docs_url: https://github.com/iap/hermes-guide#readme
|