diff options
| author | Ogulcan Celik <ogulcancelik@gmail.com> | 2026-05-19 00:23:20 +0300 |
|---|---|---|
| committer | Ogulcan Celik <ogulcancelik@gmail.com> | 2026-05-19 00:26:05 +0300 |
| commit | e7f94a3f359fe1be94a0863b731d94d245093848 (patch) | |
| tree | f89459235e9a163bbafc68fb485d9355b6fd1e3f /docs/next/INTEGRATIONS.md | |
| parent | 19295b85e5d6c2c7a9bce5d52343d89749d9f628 (diff) | |
feat: support hermes agent integration
refs #144
Diffstat (limited to 'docs/next/INTEGRATIONS.md')
| -rw-r--r-- | docs/next/INTEGRATIONS.md | 44 |
1 files changed, 44 insertions, 0 deletions
diff --git a/docs/next/INTEGRATIONS.md b/docs/next/INTEGRATIONS.md index 23b41ab8..fc47bbc0 100644 --- a/docs/next/INTEGRATIONS.md +++ b/docs/next/INTEGRATIONS.md @@ -12,6 +12,7 @@ if you want to inspect the exact files herdr installs, they are versioned in thi - [claude code hook](./src/integration/assets/claude/herdr-agent-state.sh) - [codex hook](./src/integration/assets/codex/herdr-agent-state.sh) - [opencode plugin](./src/integration/assets/opencode/herdr-agent-state.js) +- [hermes plugin](./src/integration/assets/hermes/__init__.py) ## how herdr uses integrations @@ -30,6 +31,7 @@ herdr integration install pi herdr integration install claude herdr integration install codex herdr integration install opencode +herdr integration install hermes ``` ## uninstall commands @@ -39,6 +41,7 @@ herdr integration uninstall pi herdr integration uninstall claude herdr integration uninstall codex herdr integration uninstall opencode +herdr integration uninstall hermes ``` ## pi @@ -210,6 +213,47 @@ this removes: ~/.config/opencode/plugins/herdr-agent-state.js ``` +## hermes agent + +install: + +```bash +herdr integration install hermes +``` + +this: + +- writes the bundled plugin to `~/.hermes/plugins/herdr-agent-state/` +- updates `~/.hermes/config.yaml` so `plugins.enabled` contains `herdr-agent-state` + +bundled source: [`src/integration/assets/hermes/__init__.py`](./src/integration/assets/hermes/__init__.py) + +current plugin mapping: + +- `on_session_start` → `idle` +- `pre_llm_call` → `working` +- `pre_api_request` → `working` +- `pre_tool_call` → `working` +- `post_tool_call` → `working` +- `pre_approval_request` → `blocked` +- `post_approval_response` → `working` +- `post_llm_call` → `idle` +- `on_session_end` → `idle` +- `on_session_finalize` → `release` + +notes: + +- hermes plugins are opt-in, so install also enables the plugin in `config.yaml`. +- herdr still keeps native process detection and screen heuristics for hermes. the plugin improves state accuracy when the hook surface fires. + +uninstall: + +```bash +herdr integration uninstall hermes +``` + +this removes `~/.hermes/plugins/herdr-agent-state/` and removes the matching `plugins.enabled` entry from `~/.hermes/config.yaml`. + ## grok cli herdr does not currently install a grok hook or plugin. |