From 0240fa4a84123406a0e5e6e7262e5b772b43f0bd Mon Sep 17 00:00:00 2001 From: Teknium <127238744+teknium1@users.noreply.github.com> Date: Thu, 8 Oct 2026 01:08:17 -0700 Subject: [PATCH 01/91] fix(release): read the Hermes version line in the Nix check and accept rc.N attempt refs Two stable-release identity checks broke on the first pipeline cuts of v0.21.6: - nix.yml "Verify release package runtime identity" took the LAST token of the whole `hermes --version` output. That output ends with the OpenAI SDK line, so the check compared 0.21.6 against 2.24.0 and failed every release. Parse the first line ("Hermes Agent v ...") instead. - msix-shared.mjs releaseEpoch() still required the retired `vX.Y.Z-rc` claim name. Attempt refs are `rc.-vX.Y.Z` (versioning.parse_attempt_ref), so the Windows universal bundle threw "Stable claim tag differs from its payload tag". Accept exactly `rc.-`; a different version (rc.3-v0.27.10 for v0.27.1) still refuses. --- .github/workflows/nix.yml | 4 +++- apps/desktop/scripts/store-package-version.test.mjs | 8 +++++--- scripts/msix-shared.mjs | 3 ++- 3 files changed, 10 insertions(+), 5 deletions(-) diff --git a/.github/workflows/nix.yml b/.github/workflows/nix.yml index baf2901ba5..bf568cce3c 100644 --- a/.github/workflows/nix.yml +++ b/.github/workflows/nix.yml @@ -166,7 +166,9 @@ jobs: import os expected = os.environ["RELEASE_VERSION"] - actual = os.environ["ACTUAL_VERSION"].split()[-1].removeprefix("v") + # Line one is "Hermes Agent v (...)"; later lines (Python, OpenAI SDK) carry other versions. + first = os.environ["ACTUAL_VERSION"].splitlines()[0].split() + actual = first[2].removeprefix("v") if first[:2] == ["Hermes", "Agent"] and len(first) > 2 else "" if actual != expected: raise SystemExit(f"Nix package version mismatch: expected {expected}, got {actual}") PY diff --git a/apps/desktop/scripts/store-package-version.test.mjs b/apps/desktop/scripts/store-package-version.test.mjs index 60f4e5501e..997babcc3b 100644 --- a/apps/desktop/scripts/store-package-version.test.mjs +++ b/apps/desktop/scripts/store-package-version.test.mjs @@ -89,18 +89,20 @@ test('Store calendar ordering survives minute, hour, day and year boundaries and test('stable candidate identity uses the admitted claim epoch before the final tag exists', () => { const { root, app } = fixture() execFileSync('git', ['tag', '-d', 'v0.27.1'], { cwd: root, stdio: 'pipe' }) - execFileSync('git', ['tag', '-a', 'v0.27.1-rc', '-m', 'claim'], { + execFileSync('git', ['tag', '-a', 'rc.3-v0.27.1', '-m', 'claim'], { cwd: root, env: { ...process.env, ...gitIdentityEnv, GIT_COMMITTER_DATE: '2026-09-07T00:18:00Z' }, stdio: 'pipe' }) const epoch = Date.parse('2026-09-07T00:18:00Z') / 1000 - vi.stubEnv('RELEASE_CLAIM_TAG', 'v0.27.1-rc') - vi.stubEnv('RELEASE_CLAIM_OBJECT', execFileSync('git', ['rev-parse', 'v0.27.1-rc'], { + vi.stubEnv('RELEASE_CLAIM_TAG', 'rc.3-v0.27.1') + vi.stubEnv('RELEASE_CLAIM_OBJECT', execFileSync('git', ['rev-parse', 'rc.3-v0.27.1'], { cwd: root, encoding: 'utf8' }).trim()) try { expect(appIdentity(app, 'v0.27.1').version).toBe(storePackageVersionAt(epoch)) + vi.stubEnv('RELEASE_CLAIM_TAG', 'rc.3-v0.27.10') + expect(() => appIdentity(app, 'v0.27.1')).toThrow('Stable claim tag differs from its payload tag') } finally { vi.unstubAllEnvs() } diff --git a/scripts/msix-shared.mjs b/scripts/msix-shared.mjs index 745b925761..366f11377c 100644 --- a/scripts/msix-shared.mjs +++ b/scripts/msix-shared.mjs @@ -159,7 +159,8 @@ function releaseEpoch(tag, gitRoot) { return Number(supplied) } const claim = process.env.RELEASE_CLAIM_TAG - if (claim && claim !== `${tag}-rc`) throw new Error('Stable claim tag differs from its payload tag') + // Attempt refs read `rc.-vX.Y.Z` (scripts/releases/versioning.py::parse_attempt_ref). + if (claim && !new RegExp(`^rc\\.[1-9]\\d*-${tag.replaceAll('.', '\\.')}$`).test(claim)) throw new Error('Stable claim tag differs from its payload tag') const claimObject = process.env.RELEASE_CLAIM_OBJECT let timestamp let timestampTag = tag From ba30eda966dda7c462dc306ec07d17fce693826d Mon Sep 17 00:00:00 2001 From: imzacksong <184163833+imzacksong@users.noreply.github.com> Date: Wed, 16 Sep 2026 17:37:39 -0400 Subject: [PATCH 02/91] Add hermes-plex-music to plugin catalog --- plugin-catalog/hermes-plex-music.yaml | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) create mode 100644 plugin-catalog/hermes-plex-music.yaml diff --git a/plugin-catalog/hermes-plex-music.yaml b/plugin-catalog/hermes-plex-music.yaml new file mode 100644 index 0000000000..d7e95f7b5f --- /dev/null +++ b/plugin-catalog/hermes-plex-music.yaml @@ -0,0 +1,18 @@ +name: hermes-plex-music +repo: https://github.com/imzacksong/hermes-plex-music +sha: c583d6fdaac61d2108bada99b275460b4d08a993 +description: 'Mini-Plexamp for Hermes Desktop: statusbar player for your Plex music + library — likes synced to Liked Songs, custom playlists with rename/delete, + shuffle + repeat, sleep timer, queue editing, OS media keys. Needs only Plex + Media Server. Zero API keys, zero model tokens.' +maintainer: imzacksong +tier: community +category: desktop +requires_hermes: '>=0.21' +docs_url: https://github.com/imzacksong/hermes-plex-music +platforms: [windows] +capabilities: + provides_tools: [] + provides_hooks: [] + provides_middleware: [] + requires_env: [] From 3e572c5d45d98a2d34596d60daf965b72bcfd1e6 Mon Sep 17 00:00:00 2001 From: teknium1 Date: Thu, 8 Oct 2026 02:42:47 -0700 Subject: [PATCH 03/91] chore(catalog): review disclosure for hermes-plex-music --- plugin-catalog/hermes-plex-music.yaml | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/plugin-catalog/hermes-plex-music.yaml b/plugin-catalog/hermes-plex-music.yaml index d7e95f7b5f..6592391e42 100644 --- a/plugin-catalog/hermes-plex-music.yaml +++ b/plugin-catalog/hermes-plex-music.yaml @@ -1,10 +1,7 @@ name: hermes-plex-music repo: https://github.com/imzacksong/hermes-plex-music sha: c583d6fdaac61d2108bada99b275460b4d08a993 -description: 'Mini-Plexamp for Hermes Desktop: statusbar player for your Plex music - library — likes synced to Liked Songs, custom playlists with rename/delete, - shuffle + repeat, sleep timer, queue editing, OS media keys. Needs only Plex - Media Server. Zero API keys, zero model tokens.' +description: "Mini-Plexamp for Hermes Desktop: statusbar player for your Plex music library — likes synced to Liked Songs, custom playlists with rename/delete, shuffle + repeat, sleep timer, queue editing, OS media keys. Needs only Plex Media Server. Zero API keys, zero model tokens. Disclosure — talks only to the Plex Media Server you configure (default http://127.0.0.1:32400), sending your Plex token in the request URL as Plex requires; the token is stored in Desktop plugin storage, and the optional \"Get token…\" button reads the Plex `.LocalAdminToken` file you pick. Likes and playlist create/rename/delete write to your Plex server. No agent tools, no telemetry." maintainer: imzacksong tier: community category: desktop From 589ef7c96de63e025f9cb2d2cff97175774b4975 Mon Sep 17 00:00:00 2001 From: Nikola Hristov Date: Mon, 21 Sep 2026 23:10:11 +0300 Subject: [PATCH 04/91] feat(catalog): add aphrodite plugin entry --- plugin-catalog/aphrodite.yaml | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 plugin-catalog/aphrodite.yaml diff --git a/plugin-catalog/aphrodite.yaml b/plugin-catalog/aphrodite.yaml new file mode 100644 index 0000000000..8263176a41 --- /dev/null +++ b/plugin-catalog/aphrodite.yaml @@ -0,0 +1,35 @@ +name: aphrodite +repo: https://github.com/PlayForm/Aphrodite-Hermes +sha: 3baf19a4639f365de368a9bb40b33cce776ba4bc +description: CCR compression plugin - 28-type classifier, 13 tools, dylib hot-reload, context engine, TOML-driven templates. +maintainer: NikolaRHristov +tier: community +category: tools +requires_hermes: ">=0.16.0" +docs_url: https://github.com/PlayForm/Aphrodite-Hermes#readme +version: "2.1.5" +capabilities: + provides_tools: + - aphrodite_retrieve + - aphrodite_compress + - aphrodite_stats + - aphrodite_rebuild + - aphrodite_files + - aphrodite_diff + - aphrodite_search + - aphrodite_directive + - aphrodite_test + - aphrodite_catalog + - aphrodite_reclassify + - aphrodite_prefetch + - aphrodite_prefetch_status + provides_hooks: + - on_session_start + - transform_tool_result + - pre_llm_call + - transform_terminal_output + - post_llm_call + - pre_tool_call + provides_middleware: [] + requires_env: + - APHRODITE_API_KEY \ No newline at end of file From 44fcdb27c97546f8e2a9eda777840b2986bf22be Mon Sep 17 00:00:00 2001 From: Nikola Hristov Date: Tue, 6 Oct 2026 20:25:41 +0300 Subject: [PATCH 05/91] fix(aphrodite): update SHA and version in plugin catalog Signed-off-by: Nikola Hristov --- plugin-catalog/aphrodite.yaml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/plugin-catalog/aphrodite.yaml b/plugin-catalog/aphrodite.yaml index 8263176a41..240248d0ff 100644 --- a/plugin-catalog/aphrodite.yaml +++ b/plugin-catalog/aphrodite.yaml @@ -1,13 +1,13 @@ name: aphrodite repo: https://github.com/PlayForm/Aphrodite-Hermes -sha: 3baf19a4639f365de368a9bb40b33cce776ba4bc -description: CCR compression plugin - 28-type classifier, 13 tools, dylib hot-reload, context engine, TOML-driven templates. +sha: 17dfa4df9102d7e3dc6b02c8720d85f7fc3a3298 +description: CCR compression plugin - 28-type classifier, 13 tools, context engine, TOML-driven templates. maintainer: NikolaRHristov tier: community category: tools requires_hermes: ">=0.16.0" docs_url: https://github.com/PlayForm/Aphrodite-Hermes#readme -version: "2.1.5" +version: "2.2.5" capabilities: provides_tools: - aphrodite_retrieve From 02cf5cbcbc730b2b1885bf60d885dac21d24db42 Mon Sep 17 00:00:00 2001 From: Nikola Hristov Date: Wed, 7 Oct 2026 20:02:51 +0300 Subject: [PATCH 06/91] feat(catalog): update aphrodite to v2.2.6 (sha e95afcd9, requires_hermes >=0.20.2) --- plugin-catalog/aphrodite.yaml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/plugin-catalog/aphrodite.yaml b/plugin-catalog/aphrodite.yaml index 240248d0ff..1548604e5e 100644 --- a/plugin-catalog/aphrodite.yaml +++ b/plugin-catalog/aphrodite.yaml @@ -1,13 +1,13 @@ name: aphrodite repo: https://github.com/PlayForm/Aphrodite-Hermes -sha: 17dfa4df9102d7e3dc6b02c8720d85f7fc3a3298 -description: CCR compression plugin - 28-type classifier, 13 tools, context engine, TOML-driven templates. +sha: e95afcd9d99360fdf73ecdd2f540af7cd81597ec +description: "CCR compression plugin - 28-type classifier, 13 tools, opt-in context engine, TOML-driven templates. Disclosure - pre_tool_call auto-backgrounds long terminal/process commands (modify: background=true, notify_on_complete=true) and rewrites chained terminal commands when enabled." maintainer: NikolaRHristov tier: community category: tools -requires_hermes: ">=0.16.0" +requires_hermes: ">=0.20.2" docs_url: https://github.com/PlayForm/Aphrodite-Hermes#readme -version: "2.2.5" +version: "2.2.6" capabilities: provides_tools: - aphrodite_retrieve From 89af8eac9a2d356568f2bb193cc1126079e42a9e Mon Sep 17 00:00:00 2001 From: teknium1 Date: Thu, 8 Oct 2026 02:42:55 -0700 Subject: [PATCH 07/91] chore(catalog): review disclosure for aphrodite --- plugin-catalog/aphrodite.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/plugin-catalog/aphrodite.yaml b/plugin-catalog/aphrodite.yaml index 1548604e5e..4e34611ec1 100644 --- a/plugin-catalog/aphrodite.yaml +++ b/plugin-catalog/aphrodite.yaml @@ -1,7 +1,7 @@ name: aphrodite repo: https://github.com/PlayForm/Aphrodite-Hermes sha: e95afcd9d99360fdf73ecdd2f540af7cd81597ec -description: "CCR compression plugin - 28-type classifier, 13 tools, opt-in context engine, TOML-driven templates. Disclosure - pre_tool_call auto-backgrounds long terminal/process commands (modify: background=true, notify_on_complete=true) and rewrites chained terminal commands when enabled." +description: "CCR compression plugin - 28-type classifier, 13 tools, opt-in context engine, TOML-driven templates. Disclosure - pre_tool_call auto-backgrounds long terminal/process commands (modify: background=true, notify_on_complete=true) and rewrites chained terminal commands when enabled. Disclosure — hook and tool logic runs in prebuilt native binaries (libaphrodite_hermes + aphrodite proxy, v1.6.6) built from the public PlayForm/Aphrodite source and fetched by an explicit download.sh step checked against in-tree SHA-256 sums; register() starts a background proxy on 127.0.0.1:9797/9798 whose management routes are open to local processes unless APHRODITE_MGMT_TOKEN is set; pre_tool_call by default rewrites slow terminal commands (cargo/npm/pip/docker/curl…) to run in the background (background=true, notify_on_complete=true) and splits chained commands when enabled; aphrodite_prefetch reads files the model names into its store (refuses .env, auth.json, ~/.ssh and the Hermes home); requires its own APHRODITE_API_KEY for an upstream LLM endpoint (default api.openai.com)." maintainer: NikolaRHristov tier: community category: tools @@ -32,4 +32,4 @@ capabilities: - pre_tool_call provides_middleware: [] requires_env: - - APHRODITE_API_KEY \ No newline at end of file + - APHRODITE_API_KEY From 41d8b37cde0219ce1a5f200a8d1c74b493abd9df Mon Sep 17 00:00:00 2001 From: Mio Date: Fri, 25 Sep 2026 03:50:20 +0800 Subject: [PATCH 08/91] plugin-catalog: add commandcode-oauth --- plugin-catalog/commandcode-oauth.yaml | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 plugin-catalog/commandcode-oauth.yaml diff --git a/plugin-catalog/commandcode-oauth.yaml b/plugin-catalog/commandcode-oauth.yaml new file mode 100644 index 0000000000..d628a8351b --- /dev/null +++ b/plugin-catalog/commandcode-oauth.yaml @@ -0,0 +1,17 @@ +name: commandcode-oauth +repo: https://github.com/NanamiMio/hermes-commandcode-oauth +sha: 1a58050b460114a7b1f2e0bbe465048cae979aaf +description: Command Code (commandcode.ai) as a model provider for accounts that sign in with the Command Code CLI — the same endpoint and sign-in the CLI uses, plus a live model catalog, plan limits and failover classification, through documented Hermes plugin seams only. +maintainer: NanamiMio +tier: community +category: models +requires_hermes: ">=0.21" +docs_url: https://github.com/NanamiMio/hermes-commandcode-oauth#readme +version: "0.1.0" +readme: true +platforms: [] +capabilities: + provides_tools: [] + provides_hooks: [] + provides_middleware: [] + requires_env: [] From 57bbd9e3718fa326a24d630ae065074a04542bbc Mon Sep 17 00:00:00 2001 From: NanamiMio Date: Thu, 8 Oct 2026 11:29:56 +0800 Subject: [PATCH 09/91] fix(plugin-catalog): pin reviewed commandcode-oauth 0.1.1 Repin the read-only credential build, disclose its static-key CLI transport and the core compatibility requirements, and match the manifest version. Co-authored-by: Codex --- plugin-catalog/commandcode-oauth.yaml | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/plugin-catalog/commandcode-oauth.yaml b/plugin-catalog/commandcode-oauth.yaml index d628a8351b..c41cbcfc28 100644 --- a/plugin-catalog/commandcode-oauth.yaml +++ b/plugin-catalog/commandcode-oauth.yaml @@ -1,15 +1,18 @@ name: commandcode-oauth repo: https://github.com/NanamiMio/hermes-commandcode-oauth -sha: 1a58050b460114a7b1f2e0bbe465048cae979aaf -description: Command Code (commandcode.ai) as a model provider for accounts that sign in with the Command Code CLI — the same endpoint and sign-in the CLI uses, plus a live model catalog, plan limits and failover classification, through documented Hermes plugin seams only. +sha: ef99c1a3a860357f56b7e2b073d4dd428561019f +description: Command Code CLI-key model provider with live setup discovery, plan limits and failover classification. Disclosure — uses the CLI-internal api.commandcode.ai/alpha/generate endpoint and CLI client headers, sends the full conversation, tool schemas, cwd path and OS/Python version, and imports a static key from the read-only CLI credential file or a browser hand-off; no OAuth exchange takes place. Hermes also bundles commandcode for the documented Provider API. maintainer: NanamiMio tier: community category: models -requires_hermes: ">=0.21" +requires_hermes: ">=0.21.5" docs_url: https://github.com/NanamiMio/hermes-commandcode-oauth#readme -version: "0.1.0" +version: "0.1.1" readme: true platforms: [] +known_issues: + - Requires Hermes main containing f12e6b66d960a92d9d4779cfcc628ab9cb02555b (generic plugin OAuth auxiliary routing); the September 24, 2026 release lacks it. + - Live /model and Desktop catalog probing for non-api_key profiles depends on upstream PR 122203; hermes model setup already fetches the live account catalog. capabilities: provides_tools: [] provides_hooks: [] From a72a1909f538f66413b37cefb570cd9e10da98b1 Mon Sep 17 00:00:00 2001 From: NanamiMio Date: Thu, 8 Oct 2026 11:42:32 +0800 Subject: [PATCH 10/91] docs(plugin-catalog): note the pending doctor namespace fix Co-authored-by: Codex --- plugin-catalog/commandcode-oauth.yaml | 1 + 1 file changed, 1 insertion(+) diff --git a/plugin-catalog/commandcode-oauth.yaml b/plugin-catalog/commandcode-oauth.yaml index c41cbcfc28..14db9bf602 100644 --- a/plugin-catalog/commandcode-oauth.yaml +++ b/plugin-catalog/commandcode-oauth.yaml @@ -13,6 +13,7 @@ platforms: [] known_issues: - Requires Hermes main containing f12e6b66d960a92d9d4779cfcc628ab9cb02555b (generic plugin OAuth auxiliary routing); the September 24, 2026 release lacks it. - Live /model and Desktop catalog probing for non-api_key profiles depends on upstream PR 122203; hermes model setup already fetches the live account catalog. + - Older cores may incorrectly warn about this provider's vendor/model IDs in hermes doctor; generic profile namespace support is proposed in upstream PR 134900. capabilities: provides_tools: [] provides_hooks: [] From 52effeaf4c032596ea482ec73077aae167585357 Mon Sep 17 00:00:00 2001 From: NanamiMio Date: Thu, 8 Oct 2026 11:53:23 +0800 Subject: [PATCH 11/91] plugin-catalog: pin live-verified commandcode-oauth 0.1.2 Co-authored-by: Codex --- plugin-catalog/commandcode-oauth.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/plugin-catalog/commandcode-oauth.yaml b/plugin-catalog/commandcode-oauth.yaml index 14db9bf602..ce8e8dc906 100644 --- a/plugin-catalog/commandcode-oauth.yaml +++ b/plugin-catalog/commandcode-oauth.yaml @@ -1,13 +1,13 @@ name: commandcode-oauth repo: https://github.com/NanamiMio/hermes-commandcode-oauth -sha: ef99c1a3a860357f56b7e2b073d4dd428561019f +sha: 232f2d14d96ad4197a596feaec309c43c6aa9c84 description: Command Code CLI-key model provider with live setup discovery, plan limits and failover classification. Disclosure — uses the CLI-internal api.commandcode.ai/alpha/generate endpoint and CLI client headers, sends the full conversation, tool schemas, cwd path and OS/Python version, and imports a static key from the read-only CLI credential file or a browser hand-off; no OAuth exchange takes place. Hermes also bundles commandcode for the documented Provider API. maintainer: NanamiMio tier: community category: models requires_hermes: ">=0.21.5" docs_url: https://github.com/NanamiMio/hermes-commandcode-oauth#readme -version: "0.1.1" +version: "0.1.2" readme: true platforms: [] known_issues: From f9fad2d3e6edd1c1cea601afc184b1fa3fa04ede Mon Sep 17 00:00:00 2001 From: teknium1 Date: Thu, 8 Oct 2026 02:43:16 -0700 Subject: [PATCH 12/91] chore: map contributor email for NanamiMio --- contributors/emails/zhangshower@gmail.com | 1 + 1 file changed, 1 insertion(+) create mode 100644 contributors/emails/zhangshower@gmail.com diff --git a/contributors/emails/zhangshower@gmail.com b/contributors/emails/zhangshower@gmail.com new file mode 100644 index 0000000000..2c53c832eb --- /dev/null +++ b/contributors/emails/zhangshower@gmail.com @@ -0,0 +1 @@ +NanamiMio From d7bfd20e93653a89d1254f830a52298c70bd077a Mon Sep 17 00:00:00 2001 From: xiaohongshu-automation <807847218@qq.com> Date: Mon, 5 Oct 2026 16:00:54 +0800 Subject: [PATCH 13/91] chore(catalog): bump echarts-in-chat to 2.1.0 Bumps the reviewed pin to 9940080920ef8d5ffd9c06910a49fa5c690b28c2. What v2.1.0 adds: - Crosshair hover tooltip with series highlight rings and a value bubble; Tab + arrow-key keyboard equivalent, tap on touch, and an aria-live readout. - Readable Chinese error states for labels/values length mismatch, unparsable numbers, illegal types, malformed series and oversized ranges, with the raw directive kept copyable (no blank chart). - Compact data syntax: inclusive integer ranges (1..12) and whitespace as an equivalent separator; the original labels/values/series spelling is unchanged. - Unit tests (node --test tests/, 31 cases) plus a render-layer error/readout test, all zero-dependency. Local evidence: `hermes plugins validate . --install-deps` passes all checks (security scan safe, desktop surface stays inside the SDK surface), recorded in docs/validation-v2.1.0.txt at the pinned commit. Disclosure unchanged: no network calls, no shell commands, no stored credentials, no env vars, no background processes, nothing read/written outside the rendered message. The error block's copy control writes to the system clipboard only on an explicit click. Only sha and version are changed in this entry. --- plugin-catalog/echarts-in-chat.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/plugin-catalog/echarts-in-chat.yaml b/plugin-catalog/echarts-in-chat.yaml index bedb057166..afd303036a 100644 --- a/plugin-catalog/echarts-in-chat.yaml +++ b/plugin-catalog/echarts-in-chat.yaml @@ -1,13 +1,13 @@ name: echarts-in-chat repo: https://github.com/Tommy00748/hermes-plugin-echarts-in-chat -sha: 5e0924c528c4e4bd100c87f913f79300f8de2605 +sha: 9940080920ef8d5ffd9c06910a49fa5c690b28c2 description: "Render a chart inline in the Hermes Desktop transcript: the model emits ::echarts{labels=... values=...} and the plugin mounts an interactive SVG chart (dataZoom slider, click-to-filter legend, resize-aware, 280-560px height clamp) in the plugin SDK's transcript-directive slot. Disclosure — no network calls, no shell commands, no stored credentials, no environment variables, no background processes, and nothing read or written outside the message it renders; the chart is drawn locally as inline SVG with no third-party libraries." maintainer: Tommy00748 tier: community category: desktop requires_hermes: ">=0.21.5" docs_url: https://github.com/Tommy00748/hermes-plugin-echarts-in-chat#readme -version: "2.0.0" +version: "2.1.0" title: ECharts in Chat screenshots: - https://raw.githubusercontent.com/Tommy00748/hermes-plugin-echarts-in-chat/5e0924c528c4e4bd100c87f913f79300f8de2605/docs/echarts-in-chat-bar-line.png From 825ba84de9c73b1944436d46e8d0efe3811abc81 Mon Sep 17 00:00:00 2001 From: xiaohongshu-automation <807847218@qq.com> Date: Wed, 7 Oct 2026 22:59:06 +0800 Subject: [PATCH 14/91] fix(catalog): repin echarts-in-chat with English-first UI Adopt 6825178e277604594cd0a9b8f2789208e40ba59b with English-default strings, optional Chinese locale support and updated README. Align all three screenshot URLs with the reviewed source pin. --- plugin-catalog/echarts-in-chat.yaml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/plugin-catalog/echarts-in-chat.yaml b/plugin-catalog/echarts-in-chat.yaml index afd303036a..c2a14d7907 100644 --- a/plugin-catalog/echarts-in-chat.yaml +++ b/plugin-catalog/echarts-in-chat.yaml @@ -1,6 +1,6 @@ name: echarts-in-chat repo: https://github.com/Tommy00748/hermes-plugin-echarts-in-chat -sha: 9940080920ef8d5ffd9c06910a49fa5c690b28c2 +sha: 6825178e277604594cd0a9b8f2789208e40ba59b description: "Render a chart inline in the Hermes Desktop transcript: the model emits ::echarts{labels=... values=...} and the plugin mounts an interactive SVG chart (dataZoom slider, click-to-filter legend, resize-aware, 280-560px height clamp) in the plugin SDK's transcript-directive slot. Disclosure — no network calls, no shell commands, no stored credentials, no environment variables, no background processes, and nothing read or written outside the message it renders; the chart is drawn locally as inline SVG with no third-party libraries." maintainer: Tommy00748 tier: community @@ -10,9 +10,9 @@ docs_url: https://github.com/Tommy00748/hermes-plugin-echarts-in-chat#readme version: "2.1.0" title: ECharts in Chat screenshots: - - https://raw.githubusercontent.com/Tommy00748/hermes-plugin-echarts-in-chat/5e0924c528c4e4bd100c87f913f79300f8de2605/docs/echarts-in-chat-bar-line.png - - https://raw.githubusercontent.com/Tommy00748/hermes-plugin-echarts-in-chat/5e0924c528c4e4bd100c87f913f79300f8de2605/docs/echarts-in-chat-trend.png - - https://raw.githubusercontent.com/Tommy00748/hermes-plugin-echarts-in-chat/5e0924c528c4e4bd100c87f913f79300f8de2605/docs/echarts-in-chat-donut.png + - https://raw.githubusercontent.com/Tommy00748/hermes-plugin-echarts-in-chat/6825178e277604594cd0a9b8f2789208e40ba59b/docs/echarts-in-chat-bar-line.png + - https://raw.githubusercontent.com/Tommy00748/hermes-plugin-echarts-in-chat/6825178e277604594cd0a9b8f2789208e40ba59b/docs/echarts-in-chat-trend.png + - https://raw.githubusercontent.com/Tommy00748/hermes-plugin-echarts-in-chat/6825178e277604594cd0a9b8f2789208e40ba59b/docs/echarts-in-chat-donut.png platforms: [] capabilities: provides_tools: [] From bcd0710a7e0df68f66d27cde81bf13cfaf1c5803 Mon Sep 17 00:00:00 2001 From: Tuna Dev Date: Wed, 7 Oct 2026 16:16:26 +0800 Subject: [PATCH 15/91] plugin-catalog: add hyatlas (self-hosted 7-layer memory provider) Final pin: f92bfe0 (v4.3.2), which carries the embedder fix that made the v4.3.0 binaries unable to store a memory and the digest fix that let a client with a short timeout cancel a consolidation pass. The pin is the v4.3.2 tag commit, so the entry, the release binaries and the rendered docs describe one artifact. --- plugin-catalog/hyatlas.yaml | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 plugin-catalog/hyatlas.yaml diff --git a/plugin-catalog/hyatlas.yaml b/plugin-catalog/hyatlas.yaml new file mode 100644 index 0000000000..d17d8dd317 --- /dev/null +++ b/plugin-catalog/hyatlas.yaml @@ -0,0 +1,29 @@ +name: hyatlas +repo: https://github.com/tuancookiez-hub/HyAtlas-Memory +sha: f92bfe0f461c1dda0c80e3d0a0edb9266902ac9f +subdir: plugins/hyatlas +version: "4.3.2" +image: https://raw.githubusercontent.com/tuancookiez-hub/HyAtlas-Memory/f92bfe0f461c1dda0c80e3d0a0edb9266902ac9f/docs/images/banner.png +screenshots: + - https://raw.githubusercontent.com/tuancookiez-hub/HyAtlas-Memory/f92bfe0f461c1dda0c80e3d0a0edb9266902ac9f/docs/images/desktop-overview.png + - https://raw.githubusercontent.com/tuancookiez-hub/HyAtlas-Memory/f92bfe0f461c1dda0c80e3d0a0edb9266902ac9f/docs/images/desktop-graph.png +title: HyAtlas Memory +description: "HyAtlas v4 — self-hosted 7-layer memory provider backed by a pure-Go single-binary server you run yourself (chromem-go vectors, in-process BGE-small embeddings, bitemporal knowledge graph with source citations). Embeddings, the vector index and stored memories stay local. Ships agent tools (hyatlas_status/search/recent/add), a `hermes hyatlas` CLI, a Desktop pane with a starmap graph view, and a web dashboard. Disclosure — REQUIRES the separate hyatlas-go server binary, installed by the user from the repo's installer or GitHub release assets; the plugin never downloads or bundles it. NO LLM ENDPOINT IS ASSUMED, so extraction is opt-in: HYATLAS_LLM_BASE, HYATLAS_LLM_MODEL and HYATLAS_LLM_KEY are all unset by default, and without all three the server makes no LLM call — it stores the raw trace plus local embeddings and reports extraction_status \"unconfigured\". The installer, `hermes memory setup` and the Desktop settings form ask for these three and offer a free Nous Portal endpoint as a starting value you may accept or overwrite; accepting it is an explicit choice, not a default. CONVERSATION TEXT LEAVES THE MACHINE ONLY IF YOU CONFIGURE AN ENDPOINT: once configured, after each turn the plugin posts that turn (the current turn only, never the whole history) to the server, which sends it to your extraction LLM to derive facts, summaries and intentions. Set HYATLAS_MODE=lite for no LLM call at all regardless of configuration, or point the endpoint at a local OpenAI-compatible server to keep text on-machine. The mode sets what the system can reason about — lite fills L2 only, pro reasons within the turn just written and fills L1–L4 and L7, ultra adds a periodic pass over existing memories that merges contradictions, builds corroborated relations and generalises schemas, and is the only mode that fills L5 and L6. Blocking versus background extraction is a separate knob, HYATLAS_SYNC_EXTRACT. All other plugin traffic goes to the user-configured server (default 127.0.0.1:19528, loopback only). The plugin sets no HYATLAS_LLM_* variable, forwards no credential and invents no endpoint; the spawned server gets an explicitly allowlisted environment (OS essentials plus HYATLAS_* only) rather than a copy of the agent's, so provider tokens do not reach it. Optional subprocess spawn only when the auto_start setting is enabled (default off). No telemetry and no usage reporting; stored memories remain in the server's own data directory on the user's machine." +maintainer: tuancookiez-hub +tier: community +category: memory +requires_hermes: ">=0.21.4" +docs_url: https://github.com/tuancookiez-hub/HyAtlas-Memory/tree/f92bfe0f461c1dda0c80e3d0a0edb9266902ac9f/plugins/hyatlas +platforms: +- linux +- macos +- windows +capabilities: + provides_tools: [] + provides_hooks: [] + provides_middleware: [] + requires_env: [] +known_issues: + - "After enabling, select the provider with `hermes memory setup` (memory.provider: hyatlas) — installing and enabling alone does not activate memory." + - "The agent tools and hooks arrive through the MemoryProvider interface, not ctx.register_tool, so they do not appear in the plugin tool list." + - "Requires the separate hyatlas-go server binary (installed by the user); without a reachable server the provider reports unavailable and memory features degrade rather than fail." From e4cabf33180dd88d5a237e124e9c30285c009b31 Mon Sep 17 00:00:00 2001 From: teknium1 Date: Thu, 8 Oct 2026 02:54:11 -0700 Subject: [PATCH 16/91] chore(catalog): review disclosure for hyatlas --- plugin-catalog/hyatlas.yaml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/plugin-catalog/hyatlas.yaml b/plugin-catalog/hyatlas.yaml index d17d8dd317..1837417ba5 100644 --- a/plugin-catalog/hyatlas.yaml +++ b/plugin-catalog/hyatlas.yaml @@ -8,16 +8,16 @@ screenshots: - https://raw.githubusercontent.com/tuancookiez-hub/HyAtlas-Memory/f92bfe0f461c1dda0c80e3d0a0edb9266902ac9f/docs/images/desktop-overview.png - https://raw.githubusercontent.com/tuancookiez-hub/HyAtlas-Memory/f92bfe0f461c1dda0c80e3d0a0edb9266902ac9f/docs/images/desktop-graph.png title: HyAtlas Memory -description: "HyAtlas v4 — self-hosted 7-layer memory provider backed by a pure-Go single-binary server you run yourself (chromem-go vectors, in-process BGE-small embeddings, bitemporal knowledge graph with source citations). Embeddings, the vector index and stored memories stay local. Ships agent tools (hyatlas_status/search/recent/add), a `hermes hyatlas` CLI, a Desktop pane with a starmap graph view, and a web dashboard. Disclosure — REQUIRES the separate hyatlas-go server binary, installed by the user from the repo's installer or GitHub release assets; the plugin never downloads or bundles it. NO LLM ENDPOINT IS ASSUMED, so extraction is opt-in: HYATLAS_LLM_BASE, HYATLAS_LLM_MODEL and HYATLAS_LLM_KEY are all unset by default, and without all three the server makes no LLM call — it stores the raw trace plus local embeddings and reports extraction_status \"unconfigured\". The installer, `hermes memory setup` and the Desktop settings form ask for these three and offer a free Nous Portal endpoint as a starting value you may accept or overwrite; accepting it is an explicit choice, not a default. CONVERSATION TEXT LEAVES THE MACHINE ONLY IF YOU CONFIGURE AN ENDPOINT: once configured, after each turn the plugin posts that turn (the current turn only, never the whole history) to the server, which sends it to your extraction LLM to derive facts, summaries and intentions. Set HYATLAS_MODE=lite for no LLM call at all regardless of configuration, or point the endpoint at a local OpenAI-compatible server to keep text on-machine. The mode sets what the system can reason about — lite fills L2 only, pro reasons within the turn just written and fills L1–L4 and L7, ultra adds a periodic pass over existing memories that merges contradictions, builds corroborated relations and generalises schemas, and is the only mode that fills L5 and L6. Blocking versus background extraction is a separate knob, HYATLAS_SYNC_EXTRACT. All other plugin traffic goes to the user-configured server (default 127.0.0.1:19528, loopback only). The plugin sets no HYATLAS_LLM_* variable, forwards no credential and invents no endpoint; the spawned server gets an explicitly allowlisted environment (OS essentials plus HYATLAS_* only) rather than a copy of the agent's, so provider tokens do not reach it. Optional subprocess spawn only when the auto_start setting is enabled (default off). No telemetry and no usage reporting; stored memories remain in the server's own data directory on the user's machine." +description: "HyAtlas v4 — self-hosted 7-layer memory provider backed by a pure-Go single-binary server you run yourself (chromem-go vectors, in-process BGE-small embeddings, bitemporal knowledge graph with source citations). Embeddings, the vector index and stored memories stay local. Ships agent tools (hyatlas_status/search/recent/add), a `hermes hyatlas` CLI, a Desktop pane with a starmap graph view, and a web dashboard. Disclosure — requires the separate hyatlas-go server, installed by the user. The plugin never downloads or bundles it, and it talks only to the configured server (default 127.0.0.1:19528). Embeddings and stored memories stay local. Extraction is opt-in: the server has no default LLM endpoint and makes no LLM call until HYATLAS_LLM_BASE, HYATLAS_LLM_MODEL and HYATLAS_LLM_KEY are all set. The repo installer pre-fills a free Nous Portal endpoint that Enter accepts, but nothing is sent until you also enter a key. Once configured, each turn, including that turn's tool output, goes to that endpoint. In the default ultra mode the server also sends batches of up to 200 stored facts to it every 6 hours and deletes the facts the model marks merged or stale. HYATLAS_MODE=lite makes no LLM call. The spawned server gets an allowlisted environment (OS essentials plus HYATLAS_*), not the agent's keys. auto_start is off by default. On Windows, if a hyatlas-go.ps1 launcher is configured or sits beside the binary, `hermes hyatlas start/stop` runs it; the repo's sample launcher reads your Nous token from Hermes auth.json and points extraction at the Nous Portal. No telemetry." maintainer: tuancookiez-hub tier: community category: memory requires_hermes: ">=0.21.4" docs_url: https://github.com/tuancookiez-hub/HyAtlas-Memory/tree/f92bfe0f461c1dda0c80e3d0a0edb9266902ac9f/plugins/hyatlas platforms: -- linux -- macos -- windows + - linux + - macos + - windows capabilities: provides_tools: [] provides_hooks: [] From 6051efd81d0cee211a7b1567d7f56519b7819a08 Mon Sep 17 00:00:00 2001 From: Romain Date: Wed, 7 Oct 2026 13:44:18 +0200 Subject: [PATCH 17/91] catalog: update Vault View to 0.5.0 --- plugin-catalog/vault-view.yaml | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/plugin-catalog/vault-view.yaml b/plugin-catalog/vault-view.yaml index 7462b82509..95d2dd60d5 100644 --- a/plugin-catalog/vault-view.yaml +++ b/plugin-catalog/vault-view.yaml @@ -1,18 +1,18 @@ name: vault-view repo: https://github.com/ergocogn/hermes-desktop-plugin-vault-view -sha: 532c9b95f204cafb224e33c8075c4a774ad6f7eb -version: "0.4.8" +sha: 7cc1d6f67205ece2b57c17500a198e3841215ac2 +version: "0.5.0" title: Vault View -description: "Local Markdown vault workspace for Hermes Desktop: visual editing, progressive reading, cached image previews, shared tabs, tag search, links, backlinks and a graph. Compatible with Obsidian vaults. File transport requires a Linux/macOS gateway; Windows Desktop requires a WSL-hosted Unix backend, not a native Windows gateway; ffmpeg thumbnails are optional. Remote images and agent guidance are opt-in and disabled by default; automatic note-content sharing is disabled; direct Obsidian opening is temporarily hidden. Disclosure — reads and writes notes in the vault folder you choose through Desktop shell commands on the gateway host; remote Markdown images and agent navigation guidance stay off until you opt in." +description: "Local Markdown vault workspace for Hermes Desktop: visual editing, progressive reading, cached image previews, optional per-conversation workspaces, pinned tabs, explicit selection quoting, tag search, links, backlinks and a graph. Compatible with Obsidian vaults. File transport requires a Linux/macOS gateway; Windows Desktop requires a WSL-hosted Unix backend, not a native Windows gateway; ffmpeg thumbnails are optional. Remote images and agent guidance are independent opt-ins and disabled by default; automatic note-content sharing is disabled; direct Obsidian opening is temporarily hidden. Disclosure — reads and writes notes in the vault folder you choose through Desktop shell commands on the gateway host; remote Markdown images and agent navigation guidance stay off until you opt in." maintainer: ergocogn tier: community category: desktop docs_url: https://github.com/ergocogn/hermes-desktop-plugin-vault-view#readme readme: true -image: https://raw.githubusercontent.com/ergocogn/hermes-desktop-plugin-vault-view/532c9b95f204cafb224e33c8075c4a774ad6f7eb/assets/banner.png +image: https://raw.githubusercontent.com/ergocogn/hermes-desktop-plugin-vault-view/7cc1d6f67205ece2b57c17500a198e3841215ac2/assets/banner.png screenshots: - - https://raw.githubusercontent.com/ergocogn/hermes-desktop-plugin-vault-view/532c9b95f204cafb224e33c8075c4a774ad6f7eb/screenshots/vault-view-light.png - - https://raw.githubusercontent.com/ergocogn/hermes-desktop-plugin-vault-view/532c9b95f204cafb224e33c8075c4a774ad6f7eb/screenshots/vault-view-settings.png + - https://raw.githubusercontent.com/ergocogn/hermes-desktop-plugin-vault-view/7cc1d6f67205ece2b57c17500a198e3841215ac2/screenshots/vault-view-light.png + - https://raw.githubusercontent.com/ergocogn/hermes-desktop-plugin-vault-view/7cc1d6f67205ece2b57c17500a198e3841215ac2/screenshots/vault-view-settings.png platforms: [linux, macos] capabilities: provides_tools: [] From a7718fc1c8d64f77c6d3ae83cad15765360e507a Mon Sep 17 00:00:00 2001 From: D Yiapanis Date: Thu, 8 Oct 2026 02:57:25 -0700 Subject: [PATCH 18/91] =?UTF-8?q?chore(catalog):=20bump=20limbic=20to=200.?= =?UTF-8?q?6.0=20@=20d181a63=20=E2=80=94=20int8=20embedder=20+=20embedder-?= =?UTF-8?q?stamp=20mandatory-reindex?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- plugin-catalog/limbic.yaml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/plugin-catalog/limbic.yaml b/plugin-catalog/limbic.yaml index 447b64e419..24bcf5c1d0 100644 --- a/plugin-catalog/limbic.yaml +++ b/plugin-catalog/limbic.yaml @@ -1,13 +1,13 @@ name: limbic repo: https://github.com/dyiapanis/limbic -sha: 2aa69d02e1c0faa34e10b2a472647d4d10286e6f -description: "Self-organising memory provider (MemoryProvider ABC): local SQLite (WAL) with sqlite-vec KNN + FTS5 hybrid recall, adaptive trust scoring, activation maturation, interference-based forgetting, NLI-based correction detection and synaptic atrophy. No LLM cost — all lifecycle mechanisms are deterministic. Tools (remember/recall) and lifecycle hooks dispatch via the MemoryManager from the registered provider — this entry registers a MemoryProvider only, so provides_tools/provides_hooks are empty. Disclosure — on first use downloads ~2.5GB of ONNX models (Arctic Embed 2.0 L, MiniLMv2 NLI) from huggingface.co at pinned commits with hash checks into ~/.cache/limbic/ (outside HERMES_HOME); spaCy NER models are not downloaded and must be installed manually for entity extraction; memory stays local in limbic.db under HERMES_HOME, and hermes backup adds VACUUM snapshots under HERMES_HOME/backups; no telemetry. PolyForm Noncommercial 1.0.0 (commercial use requires a separate license)." +sha: d181a63e5c2e066781e6b1a5c25e6c99d16f0e8b +description: "Self-organising memory provider (MemoryProvider ABC): local SQLite (WAL) with sqlite-vec KNN + FTS5 hybrid recall, adaptive trust scoring, activation maturation, interference-based forgetting, NLI-based correction detection and synaptic atrophy. No LLM cost — all lifecycle mechanisms are deterministic. Tools (remember/recall) and lifecycle hooks dispatch via the MemoryManager from the registered provider — this entry registers a MemoryProvider only, so provides_tools/provides_hooks are empty. Disclosure — on first use downloads ~1.1GB of ONNX models (Arctic Embed 2.0 L int8 embedding, ~570MB; MiniLMv2 NLI, ~430MB) from huggingface.co at pinned commits with hash checks into ~/.cache/limbic/ (outside HERMES_HOME); spaCy NER models are not downloaded and must be installed manually for entity extraction; memory stays local in limbic.db under HERMES_HOME, and hermes backup adds VACUUM snapshots under HERMES_HOME/backups; no telemetry. Since 0.6.0 each store records the embedder identity that produced its vectors (the embedder stamp); after an embedder-changing update stats surfaces stale_embedder=true until the bundled reindex re-embeds, so upgrades can't silently degrade retrieval. PolyForm Noncommercial 1.0.0 (commercial use requires a separate license)." maintainer: dyiapanis tier: community category: memory requires_hermes: ">=0.21.4" docs_url: https://github.com/dyiapanis/limbic#readme -version: "0.5.1" +version: "0.6.0" image: https://raw.githubusercontent.com/dyiapanis/limbic/01c04e2404b40b2c007899b8a415c67235d225d9/assets/banner.png readme: true platforms: [] From 3a36ac0409e0b44bbe7e3e03f615678939ebab6b Mon Sep 17 00:00:00 2001 From: teknium1 Date: Thu, 8 Oct 2026 02:57:55 -0700 Subject: [PATCH 19/91] =?UTF-8?q?chore(catalog):=20limbic=20=E2=80=94=20re?= =?UTF-8?q?-pin=20to=20v0.6.0=20d181a637=20(PR=20sha=20did=20not=20exist)?= =?UTF-8?q?=20and=20correct=20the=20embedder-stamp=20disclosure?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- plugin-catalog/limbic.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/plugin-catalog/limbic.yaml b/plugin-catalog/limbic.yaml index 24bcf5c1d0..d9821b2287 100644 --- a/plugin-catalog/limbic.yaml +++ b/plugin-catalog/limbic.yaml @@ -1,7 +1,7 @@ name: limbic repo: https://github.com/dyiapanis/limbic -sha: d181a63e5c2e066781e6b1a5c25e6c99d16f0e8b -description: "Self-organising memory provider (MemoryProvider ABC): local SQLite (WAL) with sqlite-vec KNN + FTS5 hybrid recall, adaptive trust scoring, activation maturation, interference-based forgetting, NLI-based correction detection and synaptic atrophy. No LLM cost — all lifecycle mechanisms are deterministic. Tools (remember/recall) and lifecycle hooks dispatch via the MemoryManager from the registered provider — this entry registers a MemoryProvider only, so provides_tools/provides_hooks are empty. Disclosure — on first use downloads ~1.1GB of ONNX models (Arctic Embed 2.0 L int8 embedding, ~570MB; MiniLMv2 NLI, ~430MB) from huggingface.co at pinned commits with hash checks into ~/.cache/limbic/ (outside HERMES_HOME); spaCy NER models are not downloaded and must be installed manually for entity extraction; memory stays local in limbic.db under HERMES_HOME, and hermes backup adds VACUUM snapshots under HERMES_HOME/backups; no telemetry. Since 0.6.0 each store records the embedder identity that produced its vectors (the embedder stamp); after an embedder-changing update stats surfaces stale_embedder=true until the bundled reindex re-embeds, so upgrades can't silently degrade retrieval. PolyForm Noncommercial 1.0.0 (commercial use requires a separate license)." +sha: d181a6372646afcfc89616e28b44db8d029a2ce9 +description: "Self-organising memory provider (MemoryProvider ABC): local SQLite (WAL) with sqlite-vec KNN + FTS5 hybrid recall, adaptive trust scoring, activation maturation, interference-based forgetting, NLI-based correction detection and synaptic atrophy. No LLM cost — all lifecycle mechanisms are deterministic. Tools (remember/recall) and lifecycle hooks dispatch via the MemoryManager from the registered provider — this entry registers a MemoryProvider only, so provides_tools/provides_hooks are empty. Disclosure — on first use downloads ~1.0GB of ONNX models (Arctic Embed 2.0 L int8 embedding, ~570MB; MiniLMv2 NLI, ~430MB) from huggingface.co at pinned commits with hash checks into ~/.cache/limbic/ (outside HERMES_HOME; an older fp32 cache of ~2.2GB is left in place); spaCy NER models are not downloaded and must be installed manually for entity extraction; memory stays local in limbic.db under HERMES_HOME, and hermes backup adds VACUUM snapshots under HERMES_HOME/backups; no telemetry. Stores created or reindexed on 0.6.0+ record the embedder that produced their vectors and report stale_embedder=true after an embedder change until `hermes limbic reindex`; stores from 0.5.x keep serving their fp32 vectors unflagged until reindexed. PolyForm Noncommercial 1.0.0 (commercial use requires a separate license)." maintainer: dyiapanis tier: community category: memory From b022ff2dfc183e0179018af280f6fb79fcef0bea Mon Sep 17 00:00:00 2001 From: olric3015 <128940386+olric3015@users.noreply.github.com> Date: Tue, 6 Oct 2026 15:13:10 +0300 Subject: [PATCH 20/91] feat(plugin-catalog): bump error-ledger to 1.1.0 Time windows (/errors 6h, /errors 7d, any number of hours or days) and /errors recent, the newest ten failures with how long ago each happened. What the plugin records is unchanged. --- plugin-catalog/error-ledger.yaml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/plugin-catalog/error-ledger.yaml b/plugin-catalog/error-ledger.yaml index ca54cb8ea7..26bcbb1ce8 100644 --- a/plugin-catalog/error-ledger.yaml +++ b/plugin-catalog/error-ledger.yaml @@ -1,15 +1,15 @@ name: error-ledger repo: https://github.com/olric3015/hermes-plugins -sha: a6cf419d391a6c3ea79fe0300ff16fcbaf8f7a02 +sha: d8031eacf95a014334e719afbf1eb9c0c28e57c1 subdir: error-ledger -description: "Local ledger of failed provider calls (rate limits, overloads, timeouts, context overflows): /errors shows how many attempts failed per model, provider or cause, how many Hermes could retry, and the most common HTTP status, for the last 24 hours, the latest session or everything recorded. Disclosure — writes failed-attempt metadata (ids, provider, model, HTTP status, Hermes's failure class, exception class name, timings; no error message, request or prompt text) to plugin-data/error-ledger/errors.jsonl, trimmed to 5,000 rows past 2 MB; no network" +description: "Local ledger of failed provider calls (rate limits, overloads, timeouts, context overflows): /errors shows how many attempts failed per model, provider or cause, how many Hermes could retry, and the most common HTTP status, for the last 24 hours, any number of hours or days, the latest session or everything recorded; /errors recent lists the newest failures and how long ago each happened. Disclosure — writes failed-attempt metadata (ids, provider, model, HTTP status, Hermes's failure class, exception class name, timings; no error message, request or prompt text) to plugin-data/error-ledger/errors.jsonl, trimmed to 5,000 rows past 2 MB; no network" maintainer: olric3015 tier: community category: tools requires_hermes: ">=0.21.5" docs_url: https://github.com/olric3015/hermes-plugins/tree/main/error-ledger -version: "1.0.0" -image: https://raw.githubusercontent.com/olric3015/hermes-plugins/a6cf419d391a6c3ea79fe0300ff16fcbaf8f7a02/docs/error-ledger-card.png +version: "1.1.0" +image: https://raw.githubusercontent.com/olric3015/hermes-plugins/d8031eacf95a014334e719afbf1eb9c0c28e57c1/docs/error-ledger-card.png platforms: [] capabilities: provides_tools: [] From 14ad45c44238e3b5b4fa57ef87511a945f02bfbf Mon Sep 17 00:00:00 2001 From: Totoro <279883115+Totoro-qaq@users.noreply.github.com> Date: Wed, 7 Oct 2026 21:34:31 +0800 Subject: [PATCH 21/91] feat(catalog): bump Jot pin for the rewritten README Co-Authored-By: Claude Opus 5.5 --- plugin-catalog/jot.yaml | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/plugin-catalog/jot.yaml b/plugin-catalog/jot.yaml index 2ec4609687..ad6d0b23a0 100644 --- a/plugin-catalog/jot.yaml +++ b/plugin-catalog/jot.yaml @@ -1,7 +1,7 @@ name: jot repo: https://github.com/Totoro-qaq/hermes-jot -sha: '9e6f31616410a7282d18b6918b4b75a8672e0820' -description: Notes, checklists and documents beside Hermes that your agent can read and update safely, with revision checks and one-click undo. +sha: '4f80c96ddba74b46a3eadc9933258ec179f69eae' +description: Notes, checklists and documents beside Hermes that your agent can read and update safely, with revision checks and undo for AI edits. maintainer: Totoro-qaq tier: community category: desktop @@ -9,10 +9,10 @@ requires_hermes: '>=0.21.5' version: '0.2.0' title: 'Jot' readme: true -image: https://raw.githubusercontent.com/Totoro-qaq/hermes-jot/9e6f31616410a7282d18b6918b4b75a8672e0820/assets/readme/banner.png +image: https://raw.githubusercontent.com/Totoro-qaq/hermes-jot/4f80c96ddba74b46a3eadc9933258ec179f69eae/assets/readme/banner.png screenshots: - - https://raw.githubusercontent.com/Totoro-qaq/hermes-jot/9e6f31616410a7282d18b6918b4b75a8672e0820/assets/readme/workspace.en.jpg - - https://raw.githubusercontent.com/Totoro-qaq/hermes-jot/9e6f31616410a7282d18b6918b4b75a8672e0820/assets/readme/sidebar.en.jpg + - https://raw.githubusercontent.com/Totoro-qaq/hermes-jot/4f80c96ddba74b46a3eadc9933258ec179f69eae/assets/readme/workspace.en.jpg + - https://raw.githubusercontent.com/Totoro-qaq/hermes-jot/4f80c96ddba74b46a3eadc9933258ec179f69eae/assets/readme/sidebar.en.jpg known_issues: - Requires a current Hermes Desktop build with SandboxedFrame and gateway file-download SDK support. - Word attachments use download or the default application; the tested host does not render DOCX. From 9ac350b78e25138a6d68a9369e5b83493e504b47 Mon Sep 17 00:00:00 2001 From: Jeremy Coe Date: Wed, 7 Oct 2026 21:48:56 -0400 Subject: [PATCH 22/91] plugin-catalog: diaktoros 0.2.0 (renamed from hermes-review-loop) --- plugin-catalog/diaktoros.yaml | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 plugin-catalog/diaktoros.yaml diff --git a/plugin-catalog/diaktoros.yaml b/plugin-catalog/diaktoros.yaml new file mode 100644 index 0000000000..b904eb5bbe --- /dev/null +++ b/plugin-catalog/diaktoros.yaml @@ -0,0 +1,17 @@ +name: diaktoros +repo: https://github.com/coe0718/diaktoros +sha: 64dd33746733d7ab5823ec56de8f12051c988ccc +description: "Unattended GitHub pull-request review between two Hermes agents: one pushes fixes, a different one reviews, rounds are capped in verdicts, a watchdog reports silent stalls, and the loop never merges. Disclosure — runs unattended Hermes agent turns inside bubblewrap (terminal and file tools, no network, no credentials); a host-side broker and the CLI write to GitHub (reviews, comments, labels, issues, repo webhooks, opt-in fixer pushes) with repo-scope PAT files you provide; edits Hermes's webhook_subscriptions.json directly and its watchdog re-adds this loop's routes while armed; writes gate scripts into the seat profiles' scripts/ folders and creates one hermes cron job; downloads PR archives from codeload.github.com, failed CI job logs from GitHub's log storage (redirected, without the token) and Rust crates from crates.io on the host; deletes its own state and closed-PR review dirs in roots you configure; on OAuth seats its host proxy may force Hermes token refreshes that rewrite ~/.claude, ~/.codex, ~/.qwen and profile auth.json credentials, and on Claude subscription logins it identifies as Claude Code (Claude Code user-agent, x-app and OAuth beta headers). Nothing runs until you arm a loop. Linux only." +maintainer: coe0718 +tier: community +category: automation +requires_hermes: ">=0.21.5" +docs_url: https://github.com/coe0718/diaktoros#readme +version: "0.2.0" +platforms: + - linux +capabilities: + provides_tools: [] + provides_hooks: [] + provides_middleware: [] + requires_env: [] From e49a52ae95615ef610c926039532226265090b4b Mon Sep 17 00:00:00 2001 From: Jeremy Coe Date: Wed, 7 Oct 2026 21:48:58 -0400 Subject: [PATCH 23/91] plugin-catalog: delist hermes-review-loop (superseded by diaktoros) --- plugin-catalog/hermes-review-loop.yaml | 17 ----------------- 1 file changed, 17 deletions(-) delete mode 100644 plugin-catalog/hermes-review-loop.yaml diff --git a/plugin-catalog/hermes-review-loop.yaml b/plugin-catalog/hermes-review-loop.yaml deleted file mode 100644 index 0dfbb685d7..0000000000 --- a/plugin-catalog/hermes-review-loop.yaml +++ /dev/null @@ -1,17 +0,0 @@ -name: hermes-review-loop -repo: https://github.com/coe0718/hermes-review-loop -sha: 431e7853c9ea99f22c81c8ec060b23d027b4e3bc -description: "Unattended GitHub pull-request review between two Hermes agents: one pushes fixes, a different one reviews, rounds are capped in verdicts, a watchdog reports silent stalls, and the loop never merges. Disclosure — runs unattended Hermes agent turns inside bubblewrap (terminal and file tools, no network, no credentials); a host-side broker and the CLI write to GitHub (reviews, comments, labels, issues, repo webhooks, opt-in fixer pushes) with repo-scope PAT files you provide; edits Hermes's webhook_subscriptions.json directly and its watchdog re-adds this loop's routes while armed; writes gate scripts into the seat profiles' scripts/ folders and creates one hermes cron job; downloads PR archives from codeload.github.com and Rust crates from crates.io on the host; deletes its own state and closed-PR review dirs in roots you configure; on OAuth seats its host proxy may force Hermes token refreshes that rewrite ~/.claude, ~/.codex, ~/.qwen and profile auth.json credentials, and on Claude subscription logins it identifies as Claude Code (Claude Code user-agent, x-app and OAuth beta headers). Nothing runs until you arm a loop. Linux only." -maintainer: coe0718 -tier: community -category: automation -requires_hermes: ">=0.21.5" -docs_url: https://github.com/coe0718/hermes-review-loop#readme -version: "0.1.1" -platforms: - - linux -capabilities: - provides_tools: [] - provides_hooks: [] - provides_middleware: [] - requires_env: [] From e986dd2bdae0fcf0579733912784217d8c921287 Mon Sep 17 00:00:00 2001 From: teknium1 Date: Thu, 8 Oct 2026 02:52:00 -0700 Subject: [PATCH 24/91] chore(catalog): review disclosure for diaktoros --- plugin-catalog/diaktoros.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/diaktoros.yaml b/plugin-catalog/diaktoros.yaml index b904eb5bbe..cdb8a90ed0 100644 --- a/plugin-catalog/diaktoros.yaml +++ b/plugin-catalog/diaktoros.yaml @@ -1,7 +1,7 @@ name: diaktoros repo: https://github.com/coe0718/diaktoros sha: 64dd33746733d7ab5823ec56de8f12051c988ccc -description: "Unattended GitHub pull-request review between two Hermes agents: one pushes fixes, a different one reviews, rounds are capped in verdicts, a watchdog reports silent stalls, and the loop never merges. Disclosure — runs unattended Hermes agent turns inside bubblewrap (terminal and file tools, no network, no credentials); a host-side broker and the CLI write to GitHub (reviews, comments, labels, issues, repo webhooks, opt-in fixer pushes) with repo-scope PAT files you provide; edits Hermes's webhook_subscriptions.json directly and its watchdog re-adds this loop's routes while armed; writes gate scripts into the seat profiles' scripts/ folders and creates one hermes cron job; downloads PR archives from codeload.github.com, failed CI job logs from GitHub's log storage (redirected, without the token) and Rust crates from crates.io on the host; deletes its own state and closed-PR review dirs in roots you configure; on OAuth seats its host proxy may force Hermes token refreshes that rewrite ~/.claude, ~/.codex, ~/.qwen and profile auth.json credentials, and on Claude subscription logins it identifies as Claude Code (Claude Code user-agent, x-app and OAuth beta headers). Nothing runs until you arm a loop. Linux only." +description: "Unattended GitHub pull-request review between two Hermes agents: one pushes fixes, a different one reviews, rounds are capped in verdicts, a watchdog reports silent stalls, and the loop never merges. Disclosure — runs unattended Hermes agent turns inside bubblewrap (terminal and file tools, no network, no credentials); a host-side broker and the CLI write to GitHub (reviews, comments, labels, issues, repo webhooks, and opt-in fixer pushes, which may push CI fixes and merge commits of the base into a PR's own branch to resolve conflicts; it never merges a PR) with repo-scope PAT files you provide; edits Hermes's webhook_subscriptions.json directly and its watchdog re-adds this loop's routes while armed; writes gate scripts into the seat profiles' scripts/ folders and creates one hermes cron job (its migrate command replaces the old hermes-review-loop job and copies that plugin's settings); downloads PR archives from codeload.github.com, failed CI job logs from GitHub's log storage (redirected, without the token) and Rust crates from crates.io on the host; an opt-in observer feed posts loop notices to the chat you name; deletes its own state and closed-PR review dirs in roots you configure; on OAuth seats its host proxy may force Hermes token refreshes that rewrite ~/.claude, ~/.codex, ~/.qwen and profile auth.json credentials, and on Claude subscription logins it identifies as Claude Code (Claude Code user-agent, x-app and OAuth beta headers). Nothing runs until you arm a loop. Linux only." maintainer: coe0718 tier: community category: automation From 179b3f6de98dcfcea5922e5a158bf49e8d8bc6bd Mon Sep 17 00:00:00 2001 From: TakeshiTGAL Date: Thu, 8 Oct 2026 13:24:02 +0800 Subject: [PATCH 25/91] fix(plugin-catalog): update switchbot-control to eefc57c --- plugin-catalog/switchbot-control.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/switchbot-control.yaml b/plugin-catalog/switchbot-control.yaml index ab6dbf2a51..c1ea9ff4b0 100644 --- a/plugin-catalog/switchbot-control.yaml +++ b/plugin-catalog/switchbot-control.yaml @@ -1,6 +1,6 @@ name: switchbot-control repo: https://github.com/TakeshiTGAL/hermes-plugin-switchbot-control -sha: bb68cb4358b83ff01396a477834d766e9069aaff +sha: eefc57ccec19ca1c47bfc746ba633d490a66dae4 description: "SwitchBot OpenAPI v1.1, personal use. No Plug Mini on/off. Locks off unless enabled. setPosition only Curtain/Curtain3 (0=open). Disclosure — Controls real devices through the SwitchBot cloud API (api.switch-bot.com) using your SWITCHBOT_TOKEN and SWITCHBOT_SECRET. Every command asks for Hermes approval and is refused under cron, yolo, approvals off and unattended sessions. Lock and door devices stay refused unless you turn on safety_devices. The plugin has no user list of its own: anyone you allow on your Hermes gateway can request a command and approve it. Answering \"always\" adds an unused line to config.yaml each time. The optional watch is a cron job (a model turn every 5 minutes by default) that stays after uninstall until you run unschedule. Not tested on real devices." maintainer: TakeshiTGAL tier: community From 068effc346e62c39e3776fb95f1c482d564c7b09 Mon Sep 17 00:00:00 2001 From: quotumorg <337712588+quotumorg@users.noreply.github.com> Date: Thu, 8 Oct 2026 12:58:16 +0700 Subject: [PATCH 26/91] feat(plugin-catalog): quotum 0.2.0, seals tab --- plugin-catalog/quotum.yaml | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/plugin-catalog/quotum.yaml b/plugin-catalog/quotum.yaml index 8aa5ec63ff..81d9a13f45 100644 --- a/plugin-catalog/quotum.yaml +++ b/plugin-catalog/quotum.yaml @@ -1,15 +1,16 @@ name: quotum repo: https://github.com/qvotvm/hermes-quotum -sha: ac1642dc8c6a712e2fc306b7df8b17be7690d2b3 -description: "A quotum seat's Venice key as a provider. Private and anonymized models, with the seat's daily cap, spend and the 20:00 UTC bell in /usage. Disclosure — prompts and QUOTUM_SEAT_KEY go to api.venice.ai; /usage and Desktop usage send a 16-hex sha256 handle of the key to quotum.org; QUOTUM_X_SEARCH=1 swaps in its own client that drops Hermes web_search for Venice-side web and X search (billed per search); seats are funded by the QUOTUM crypto token" +sha: b27d42ea995567a66e64b2389b14a665c5a17611 +description: "A quotum seat's Venice key as a provider. Private and anonymized models, with the seat's daily cap, spend and the 20:00 UTC bell in /usage, and a Seals tab in hermes dashboard with the seat's record. Disclosure — prompts and QUOTUM_SEAT_KEY go to api.venice.ai; /usage, Desktop usage and the Seals tab send a 16-hex sha256 handle of the key to quotum.org, then the Seals tab reads the seat's public record from quotum.org (the key itself is never sent there); QUOTUM_X_SEARCH=1 swaps in its own client that drops Hermes web_search for Venice-side web and X search (billed per search); seats are funded by the QUOTUM crypto token" maintainer: quotum tier: community category: models -version: "0.1.2" +version: "0.2.0" requires_hermes: ">=0.21.5" docs_url: https://github.com/qvotvm/hermes-quotum#readme known_issues: - The optional QUOTUM_X_SEARCH mode supplies its own client through create_client, so it works with plugins.isolation in_process (the default) only; under host isolation leave it off. + - Hermes' bundled Achievements page has no hook for outside achievements, so the seat's seals live in the plugin's own Seals tab. capabilities: provides_tools: [] provides_hooks: [] From b1679a7e248f81556187663932d107c83791d368 Mon Sep 17 00:00:00 2001 From: Akloenx123 <119266119+Akloenx123@users.noreply.github.com> Date: Thu, 8 Oct 2026 09:08:56 +0200 Subject: [PATCH 27/91] feat(plugin-catalog): add public-holidays plugin --- plugin-catalog/public-holidays.yaml | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 plugin-catalog/public-holidays.yaml diff --git a/plugin-catalog/public-holidays.yaml b/plugin-catalog/public-holidays.yaml new file mode 100644 index 0000000000..3c98073c43 --- /dev/null +++ b/plugin-catalog/public-holidays.yaml @@ -0,0 +1,21 @@ +name: public-holidays +repo: https://github.com/Akloenx123/hermes-public-holidays +sha: d73f177b13c368c5c2445f6595f4008ed6c79a78 +description: "Public holidays for 200+ countries and their regions, plus workday checks, workday counts and deadline math (N working days after a date), computed in code instead of by the model. Disclosure — sends HTTPS GET requests to date.nager.at (Nager.Date, free, no key) carrying only a country code and a year; no redirects, 10 s timeout, responses cached in memory only. No credentials, no files written, no shell commands, no hooks, no background processes, no telemetry." +maintainer: Akloenx123 +tier: community +category: tools +requires_hermes: ">=0.21.5" +docs_url: https://github.com/Akloenx123/hermes-public-holidays#readme +version: "0.1.0" +readme: true +platforms: [] +capabilities: + provides_tools: + - holidays_list + - workday_check + - workdays_count + - workdays_add + provides_hooks: [] + provides_middleware: [] + requires_env: [] From 9607818125abe50fbc667eb789589b205b70702b Mon Sep 17 00:00:00 2001 From: Daniel Date: Wed, 7 Oct 2026 17:31:36 -0400 Subject: [PATCH 28/91] feat(plugin-catalog): make hermes-tenuo findable by security and permission searches --- plugin-catalog/hermes-tenuo.yaml | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/plugin-catalog/hermes-tenuo.yaml b/plugin-catalog/hermes-tenuo.yaml index bb3b2ea3a6..5e5e7f30b8 100644 --- a/plugin-catalog/hermes-tenuo.yaml +++ b/plugin-catalog/hermes-tenuo.yaml @@ -2,11 +2,15 @@ name: hermes-tenuo repo: https://github.com/tenuo-ai/hermes-tenuo sha: 8bce830c5df9dcd06d16688a954146d8edc0c562 description: >- - Per-call authorization for Hermes Agent tool calls. - Each call is checked against a signed, expiring warrant before the - handler runs, including argument constraints. + Security guardrails for Hermes tool calls: per-call authorization, so a + prompt injection cannot make the agent do more than you allowed. Each call + is checked against a signed, expiring permission slip (a warrant) before + the handler runs, down to the arguments (file paths, search queries, + spending limits), and every decision lands in a local audit log. Give cron + jobs, delegate_task subagents and gateway users their own policy. Disclosure — hermes-tenuo is a no-op until a warrant is configured and blocks every tool call in a kanban worker that has no per-task warrant; it appends every tool call's name and full arguments to $HERMES_HOME/tenuo/audit.jsonl (disable with audit_log: false); when TENUO_CONNECT_TOKEN or TENUO_CONTROL_PLANE_URL are set, the bundled tenuo SDK (compiled Rust core) streams those decisions, including arguments, to that control plane. +title: Tenuo maintainer: tenuo-ai tier: community category: tools From 21794e5dedfc25bc2f98a862dfb75e8f6de29097 Mon Sep 17 00:00:00 2001 From: "Viktor (Frihet-io)" Date: Wed, 7 Oct 2026 23:01:41 +0100 Subject: [PATCH 29/91] feat(plugin-catalog): add Frihet plugin entry (Frihet-io/hermes-frihet v0.1.0) Adds the standalone plugin entry to Hermes's plugin-catalog. Pinned to Frihet-io/hermes-frihet @ f3312087a8acda01ee3a5b089017f2a2657d2d5c (tag v0.1.0). The entry follows the union-of-schema pattern of the existing community entries (twenty-crm is the closest analogue): name frihet maintainer Frihet-io tier community (per catalog rules; 'official' = NousResearch) sha f3312087a8acda01ee3a5b089017f2a2657d2d5c (40-hex, mandatory pin) version 0.1.0 category tools requires_hermes '>=0.21.5' capabilities provides_tools: [] (canonical 158-op surface lives in @frihet/mcp-server, reached via Hermes native MCP client; NOT duplicated here) provides_hooks: ['pre_tool_call'] provides_middleware: [] requires_env: [] (credentials live on the mcp_servers.frihet block in config.yaml) The companion Connector entry (PR 134790) covers the Connectors discovery surface; this PR covers the Plugin Catalog installation surface. Two independent paths, identical quality bar. --- plugin-catalog/frihet.yaml | 39 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) create mode 100644 plugin-catalog/frihet.yaml diff --git a/plugin-catalog/frihet.yaml b/plugin-catalog/frihet.yaml new file mode 100644 index 0000000000..b985a4272f --- /dev/null +++ b/plugin-catalog/frihet.yaml @@ -0,0 +1,39 @@ +# Plugin-catalog entry for hermes-frihet v0.1.0. +# +# Per the catalog admission rules (plugin-catalog/README.md in +# NousResearch/hermes-agent): +# - The maintainer of the plugin repository (Frihet-io) is the only one +# authorised to submit this entry. +# - ``tier`` MUST be ``community`` — ``official`` in the catalog means +# "maintained by NousResearch". We describe ourselves as the +# "Official Hermes Agent integration for Frihet" in the description +# and README; the catalog's tier label is a Nous-internal trust +# signal, not a brand claim. +# - ``sha`` MUST be a 40-character full commit hash of a tagged, +# audited commit of Frihet-io/hermes-frihet. Update via a new PR +# whenever we ship a meaningful change (rule 4 of the admission +# policy). +name: frihet +repo: https://github.com/Frihet-io/hermes-frihet +# Pinned at v0.1.0 / Frihet-io/hermes-frihet @ f3312087a8acda01ee3a5b089017f2a2657d2d5c +# (feat(doctor): honour the Hermes OAuth token cache when no API key is set). +# 75 tests green, hermes plugins validate --install-deps 15/15, security scan safe. +sha: f3312087a8acda01ee3a5b089017f2a2657d2d5c +description: "Official Hermes Agent integration for Frihet — discoverability, setup, diagnostics, and operating guidance for the Frihet MCP. Zero duplicated tools; the canonical 158-operation Frihet surface stays in @frihet/mcp-server and the remote endpoint https://mcp.frihet.io/mcp." +maintainer: Frihet-io +tier: community +category: tools +docs_url: https://github.com/Frihet-io/hermes-frihet#readme +requires_hermes: ">=0.21.5" +version: "0.1.0" +# Capabilities mirror plugin.yaml exactly. Zero Python tools on purpose: +# the canonical Frihet surface (158 ops) lives in @frihet/mcp-server and +# is reached via the native Hermes MCP client. The plugin adds a skill, +# a /frihet slash command, and a pre_tool_call hook that escalates +# irreversible Frihet operations to the human approval gate. +capabilities: + provides_tools: [] + provides_hooks: + - pre_tool_call + provides_middleware: [] + requires_env: [] From 3d22ef9473fb9cb0aaa259f629ab01315bb5d900 Mon Sep 17 00:00:00 2001 From: "Viktor (Frihet-io)" Date: Thu, 8 Oct 2026 01:19:59 +0100 Subject: [PATCH 30/91] docs(plugin-catalog): bump SHA to b9a8067 with full supersession history The catalog entry in this PR was pinned to f331208 (the older doctor that read ~/.hermes/mcp-tokens). That SHA predates the hook-dispatcher regression fix, the doctor envelope-leak fix, the slash-command privacy fixes, the per-line redact() masking, and the connector default_enabled safety net. Bump to the current head and document the supersession in the comment block. --- plugin-catalog/frihet.yaml | 75 ++++++++++++++++++++++++++------------ 1 file changed, 51 insertions(+), 24 deletions(-) diff --git a/plugin-catalog/frihet.yaml b/plugin-catalog/frihet.yaml index b985a4272f..73a5fe3ba8 100644 --- a/plugin-catalog/frihet.yaml +++ b/plugin-catalog/frihet.yaml @@ -1,24 +1,45 @@ -# Plugin-catalog entry for hermes-frihet v0.1.0. +# Hermes plugin-catalog entry for hermes-frihet v0.1.0. # -# Per the catalog admission rules (plugin-catalog/README.md in -# NousResearch/hermes-agent): -# - The maintainer of the plugin repository (Frihet-io) is the only one -# authorised to submit this entry. -# - ``tier`` MUST be ``community`` — ``official`` in the catalog means -# "maintained by NousResearch". We describe ourselves as the -# "Official Hermes Agent integration for Frihet" in the description -# and README; the catalog's tier label is a Nous-internal trust -# signal, not a brand claim. -# - ``sha`` MUST be a 40-character full commit hash of a tagged, -# audited commit of Frihet-io/hermes-frihet. Update via a new PR -# whenever we ship a meaningful change (rule 4 of the admission -# policy). +# Catalog: NousResearch/hermes-agent/plugin-catalog/frihet.yaml +# Per the catalog rules (plugin-catalog/README.md): +# - The maintainer of the plugin repository (Frihet-io) is the only one +# authorised to submit the entry. +# - ``tier`` MUST be ``community`` — ``official`` in the catalog means +# "maintained by NousResearch". We describe ourselves as the "Official +# Hermes Agent integration for Frihet" in the description, not in the +# catalog's tier label. +# - The SHA must be a 40-character full commit hash of a tagged, audited +# commit of Frihet-io/hermes-frihet. Update via a new PR whenever we +# ship a meaningful change (rule 4 of the catalog admission policy). name: frihet repo: https://github.com/Frihet-io/hermes-frihet -# Pinned at v0.1.0 / Frihet-io/hermes-frihet @ f3312087a8acda01ee3a5b089017f2a2657d2d5c -# (feat(doctor): honour the Hermes OAuth token cache when no API key is set). -# 75 tests green, hermes plugins validate --install-deps 15/15, security scan safe. -sha: f3312087a8acda01ee3a5b089017f2a2657d2d5c +# Pinned SHA — Frihet-io/hermes-frihet @ v0.1.0 +# (ci: rename hermes-validate to manifest-validate; add live-hermes-validate). +# +# This SHA supersedes ``f331208`` (the older doctor that read the OAuth +# token cache) AND ``24a9612`` (the first privacy-only fix). It pins: +# * Hook dispatcher that passes the FULL tool name to the gate (no +# more silent bypass of the approval gate). +# * Doctor that derives auth evidence from ``ctx.call_mcp`` — the +# plugin never reads ~/.hermes/mcp-tokens. +# * Doctor that drops the list_invoices envelope from its output +# (no invoice/customer data leaks through /frihet doctor). +# * Setup that does NOT accept credentials as slash-command +# arguments (no transcript leak). +# * Slash-command rejection of unknown subcommands and unexpected +# positional arguments — neither branch echoes user input back. +# * redact() per-line masking: every Authorization: line is masked +# independently, including mislabelled secrets (token=, secret:, +# api_key:, password=). +# * Connector manifest tools.default_enabled with 50 read+create-draft +# operations, no pre-checked mutating ops. Users opt in to +# write tools via 'hermes mcp configure frihet'. +# * CI renamed to manifest-validate (schema-only) plus a manual +# live-hermes-validate (workflow_dispatch) for maintainers. +# +# Tests: 79 pass + 3 pre-existing skips. hermes plugins validate +# --install-deps 15/15 with security scan "safe". +sha: b9a806710511f6193f7eefa1819a2beb3d295387 description: "Official Hermes Agent integration for Frihet — discoverability, setup, diagnostics, and operating guidance for the Frihet MCP. Zero duplicated tools; the canonical 158-operation Frihet surface stays in @frihet/mcp-server and the remote endpoint https://mcp.frihet.io/mcp." maintainer: Frihet-io tier: community @@ -26,14 +47,20 @@ category: tools docs_url: https://github.com/Frihet-io/hermes-frihet#readme requires_hermes: ">=0.21.5" version: "0.1.0" -# Capabilities mirror plugin.yaml exactly. Zero Python tools on purpose: -# the canonical Frihet surface (158 ops) lives in @frihet/mcp-server and -# is reached via the native Hermes MCP client. The plugin adds a skill, -# a /frihet slash command, and a pre_tool_call hook that escalates -# irreversible Frihet operations to the human approval gate. +# Capabilities mirror plugin.yaml exactly. +# Provides zero Python tools on purpose: the canonical Frihet surface +# (158 operations) lives in @frihet/mcp-server and is reached via the +# native Hermes MCP client. The plugin adds: +# - a skill (skills/frihet/SKILL.md) that encodes the operating contract +# - a pre_tool_call hook that escalates irreversible Frihet operations +# to the human approval gate +# - a /frihet slash command for setup/status/doctor capabilities: provides_tools: [] provides_hooks: - pre_tool_call provides_middleware: [] - requires_env: [] + # No env vars required. Credentials (Bearer API key or OAuth 2.0+PKCE) + # live on the ``mcp_servers.frihet`` block in the user's config.yaml, + # not on the plugin itself. + requires_env: [] \ No newline at end of file From 34a5f1a5f3e9a653fafed52a05ea85602c52fec6 Mon Sep 17 00:00:00 2001 From: "Viktor (Frihet-io)" Date: Thu, 8 Oct 2026 01:32:57 +0100 Subject: [PATCH 31/91] docs(plugin-catalog): bump SHA to b77f5df (canonical externalSideEffects) The catalog pinned SHA was b9a8067 (slash-command + redact per-line + first connector safety net). The new SHA b77f5df is the result of the third sprint: tools.default_enabled reduced to 39 read-only operations, and the plugin classifier now reads the canonical Frihet MCP contract (vendor/frihet-mcp-onboarding.json) as the source of truth for externalSideEffects. 84 tests pass. --- plugin-catalog/frihet.yaml | 23 ++++++++++++++++------- 1 file changed, 16 insertions(+), 7 deletions(-) diff --git a/plugin-catalog/frihet.yaml b/plugin-catalog/frihet.yaml index 73a5fe3ba8..6516c1c64a 100644 --- a/plugin-catalog/frihet.yaml +++ b/plugin-catalog/frihet.yaml @@ -14,10 +14,12 @@ name: frihet repo: https://github.com/Frihet-io/hermes-frihet # Pinned SHA — Frihet-io/hermes-frihet @ v0.1.0 -# (ci: rename hermes-validate to manifest-validate; add live-hermes-validate). +# (fix(security): canonical Frihet externalSideEffects drives classification). # # This SHA supersedes ``f331208`` (the older doctor that read the OAuth -# token cache) AND ``24a9612`` (the first privacy-only fix). It pins: +# token cache), ``24a9612`` (first privacy fix), ``3c8325a`` (CI rename +# + first default_enabled), AND ``b9a8067`` (slash-command + redact +# per-line + first connector safety net). It pins: # * Hook dispatcher that passes the FULL tool name to the gate (no # more silent bypass of the approval gate). # * Doctor that derives auth evidence from ``ctx.call_mcp`` — the @@ -31,15 +33,22 @@ repo: https://github.com/Frihet-io/hermes-frihet # * redact() per-line masking: every Authorization: line is masked # independently, including mislabelled secrets (token=, secret:, # api_key:, password=). -# * Connector manifest tools.default_enabled with 50 read+create-draft -# operations, no pre-checked mutating ops. Users opt in to -# write tools via 'hermes mcp configure frihet'. +# * tools.default_enabled reduced to 39 read-only operations — +# every create_* was removed because the canonical Frihet MCP +# contract declares them under externalSideEffects (webhooks or +# fiscal). Users opt in to mutating ops via 'hermes mcp configure +# frihet'. +# * Plugin classifier reads vendor/frihet-mcp-onboarding.json — +# a frozen copy of Frihet-io/frihet-mcp/docs/agent-onboarding.json +# — and treats the humanAuthority.externalSideEffects table as +# the source of truth. Local pattern lists stay as a fallback +# for tools the contract has not yet named. # * CI renamed to manifest-validate (schema-only) plus a manual # live-hermes-validate (workflow_dispatch) for maintainers. # -# Tests: 79 pass + 3 pre-existing skips. hermes plugins validate +# Tests: 84 pass + 3 pre-existing skips. hermes plugins validate # --install-deps 15/15 with security scan "safe". -sha: b9a806710511f6193f7eefa1819a2beb3d295387 +sha: b77f5df4b269ada5296ee07fc9c03d118933cbc0 description: "Official Hermes Agent integration for Frihet — discoverability, setup, diagnostics, and operating guidance for the Frihet MCP. Zero duplicated tools; the canonical 158-operation Frihet surface stays in @frihet/mcp-server and the remote endpoint https://mcp.frihet.io/mcp." maintainer: Frihet-io tier: community From 2c6c0fcb41eb778e1a7825f6125746240c9ce9ae Mon Sep 17 00:00:00 2001 From: teknium1 Date: Thu, 8 Oct 2026 02:59:35 -0700 Subject: [PATCH 32/91] chore(catalog): review disclosure for frihet --- plugin-catalog/frihet.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/plugin-catalog/frihet.yaml b/plugin-catalog/frihet.yaml index 6516c1c64a..3bd9795dca 100644 --- a/plugin-catalog/frihet.yaml +++ b/plugin-catalog/frihet.yaml @@ -49,7 +49,7 @@ repo: https://github.com/Frihet-io/hermes-frihet # Tests: 84 pass + 3 pre-existing skips. hermes plugins validate # --install-deps 15/15 with security scan "safe". sha: b77f5df4b269ada5296ee07fc9c03d118933cbc0 -description: "Official Hermes Agent integration for Frihet — discoverability, setup, diagnostics, and operating guidance for the Frihet MCP. Zero duplicated tools; the canonical 158-operation Frihet surface stays in @frihet/mcp-server and the remote endpoint https://mcp.frihet.io/mcp." +description: "Official Hermes Agent integration for Frihet — discoverability, setup, diagnostics, and operating guidance for the Frihet MCP. Zero duplicated tools; the canonical 158-operation Frihet surface stays in @frihet/mcp-server and the remote endpoint https://mcp.frihet.io/mcp. Disclosure — /frihet setup and /frihet doctor send an unauthenticated MCP initialize to mcp.frihet.io (or FRIHET_MCP_URL); /frihet doctor also makes one read-only list_invoices call through Hermes's MCP client once you grant plugins.entries.frihet.mcp_allowlist; reads ~/.hermes/config.yaml only to check that an mcp_servers.frihet block exists; the pre_tool_call hook prompts before Frihet MCP calls it classifies as irreversible or unknown, but reads and draft-first creates pass without a prompt unless the server sets trust: untrusted." maintainer: Frihet-io tier: community category: tools @@ -72,4 +72,4 @@ capabilities: # No env vars required. Credentials (Bearer API key or OAuth 2.0+PKCE) # live on the ``mcp_servers.frihet`` block in the user's config.yaml, # not on the plugin itself. - requires_env: [] \ No newline at end of file + requires_env: [] From 328a75e2b140000069c5775e1fdf75a1a734dddc Mon Sep 17 00:00:00 2001 From: teknium1 Date: Thu, 8 Oct 2026 02:59:42 -0700 Subject: [PATCH 33/91] chore: map contributor emails for d8joseph, berthelius --- contributors/emails/daniel@tenuo.ai | 1 + contributors/emails/viktor@brthls.com | 1 + 2 files changed, 2 insertions(+) create mode 100644 contributors/emails/daniel@tenuo.ai create mode 100644 contributors/emails/viktor@brthls.com diff --git a/contributors/emails/daniel@tenuo.ai b/contributors/emails/daniel@tenuo.ai new file mode 100644 index 0000000000..85884927c1 --- /dev/null +++ b/contributors/emails/daniel@tenuo.ai @@ -0,0 +1 @@ +d8joseph diff --git a/contributors/emails/viktor@brthls.com b/contributors/emails/viktor@brthls.com new file mode 100644 index 0000000000..c7acea18b0 --- /dev/null +++ b/contributors/emails/viktor@brthls.com @@ -0,0 +1 @@ +berthelius From 41a406a722c2332b61175ff6c5e1ba966bb8c9fc Mon Sep 17 00:00:00 2001 From: PromptClickRun <59135406+promptclickrun@users.noreply.github.com> Date: Thu, 8 Oct 2026 02:20:27 -0500 Subject: [PATCH 34/91] feat(plugin-catalog): add govee --- plugin-catalog/govee.yaml | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) create mode 100644 plugin-catalog/govee.yaml diff --git a/plugin-catalog/govee.yaml b/plugin-catalog/govee.yaml new file mode 100644 index 0000000000..72432e6103 --- /dev/null +++ b/plugin-catalog/govee.yaml @@ -0,0 +1,18 @@ +name: govee +repo: https://github.com/promptclickrun/hermes-govee +sha: 2d552cd1c67421cd5c9bbd8dd9b267f6dd5f0a0a +description: "Discover and control Govee lights (power, brightness, color, white temperature, scenes) through Govee's developer API. Every command is checked against the model's advertised capabilities and ranges, then confirmed by a state read-back. Disclosure — sends device IDs and control commands to openapi.api.govee.com with your Govee API key; the model can change light state; stores nothing on disk." +maintainer: promptclickrun +tier: community +category: tools +version: "0.1.0" +requires_hermes: ">=0.21.2" +docs_url: https://github.com/promptclickrun/hermes-govee#readme +platforms: [] +capabilities: + provides_tools: + - govee_lights + provides_hooks: [] + provides_middleware: [] + requires_env: + - GOVEE_API_KEY From 82b9bfedd6e1dc7075d69a2340600d2821fbe332 Mon Sep 17 00:00:00 2001 From: teknium1 Date: Thu, 8 Oct 2026 03:15:59 -0700 Subject: [PATCH 35/91] fix(plugins): enabling a plugin from Desktop/TUI/dashboard no longer strips the core tools With no saved platform_toolsets, _toggle_plugin_toolset seeded platform_toolsets.cli: []. A list naming only plugin keys replaces the hermes-cli composite, so the model lost every built-in tool (26 -> 1, no terminal). The seed is dropped: an unknown plugin toolset is already on by default when no list is saved. plugins remove now clears the plugin's toolset from saved lists even when plugin.yaml has no provides_tools (the toggle already no-ops without a toolset); before, hermes config check warned about an unknown toolset. Docs: say what provides_tools actually drives. --- hermes_cli/plugins_cmd.py | 10 +++---- hermes_cli/plugins_cmd_remove.py | 3 +- .../test_plugins_cmd_activation_keys.py | 28 +++++++++++++++++++ .../test_plugins_cmd_remove_bookkeeping.py | 25 +++++++++++++++++ website/docs/developer-guide/plugins/index.md | 7 +++++ .../current/developer-guide/plugins/index.md | 7 +++++ 6 files changed, 72 insertions(+), 8 deletions(-) diff --git a/hermes_cli/plugins_cmd.py b/hermes_cli/plugins_cmd.py index 1e6bb076a1..5148b6be36 100644 --- a/hermes_cli/plugins_cmd.py +++ b/hermes_cli/plugins_cmd.py @@ -917,8 +917,10 @@ def _get_plugin_toolset_key(name: str) -> Optional[str]: def _toggle_plugin_toolset(name: str, *, enable: bool) -> None: - """Add/remove a plugin's toolset in ``platform_toolsets`` for all platforms (no-op when the - plugin provides no tools).""" + """Add/remove a plugin's toolset in every SAVED ``platform_toolsets`` list (no-op when the plugin + provides no tools). Platforms with no saved list are left alone: a plugin toolset is already on + there by default, and seeding ``[]`` would replace the core composite and strip every + built-in tool.""" toolset_key = _get_plugin_toolset_key(name) if not toolset_key: return @@ -935,10 +937,6 @@ def _toggle_plugin_toolset(name: str, *, enable: bool) -> None: (ts_list.append if enable else ts_list.remove)(toolset_key) platform_toolsets[platform] = ts_list changed = True - # Enabling with no platform lists yet: seed "cli" at minimum. - if enable and not changed and not platform_toolsets: - platform_toolsets["cli"] = [toolset_key] - changed = True if changed: save_config(config) diff --git a/hermes_cli/plugins_cmd_remove.py b/hermes_cli/plugins_cmd_remove.py index b18fe083e1..4bcdccf844 100644 --- a/hermes_cli/plugins_cmd_remove.py +++ b/hermes_cli/plugins_cmd_remove.py @@ -133,8 +133,7 @@ def _remove_user_plugin(plugins_dir: Path, name: str, target: Path) -> dict[str, entry = next((e for e in _pc()._discover_all_plugins() if Path(str(e[4])) == target), None) key = entry[5] if entry else target.name aliases = _pc()._plugin_aliases(key) | {target.name} - if _pc()._read_manifest(target).get("provides_tools"): - _pc()._toggle_plugin_toolset(key, enable=False) + _pc()._toggle_plugin_toolset(key, enable=False) _remove_plugin_core(target) return {"ok": True, "name": name, **_pc()._forget_plugin_config(aliases)} diff --git a/tests/hermes_cli/test_plugins_cmd_activation_keys.py b/tests/hermes_cli/test_plugins_cmd_activation_keys.py index d05f39fd89..c57d31c013 100644 --- a/tests/hermes_cli/test_plugins_cmd_activation_keys.py +++ b/tests/hermes_cli/test_plugins_cmd_activation_keys.py @@ -22,6 +22,17 @@ def _write_plugin(root, rel, name, extra=""): return d +def _write_tool_plugin(root, name): + """User plugin registering one tool in its own toolset, WITHOUT ``provides_tools`` in plugin.yaml.""" + d = _write_plugin(root, name, name) + (d / "__init__.py").write_text( + "def register(ctx):\n" + f" ctx.register_tool(name='{name}_tool', toolset='{name}_ts', handler=lambda args, **kw: '{{}}',\n" + f" schema={{'name': '{name}_tool', 'description': 'probe', 'parameters': {{'type': 'object', 'properties': {{}}}}}})\n", + encoding="utf-8") + return d + + @pytest.fixture def home(tmp_path, monkeypatch): hermes_home = tmp_path / "hermes-home" @@ -85,6 +96,23 @@ def test_dashboard_toggle_writes_canonical_key_and_clears_stale_aliases(home): assert again["unchanged"] is True and again["restart_required"] is False +def test_dashboard_enable_on_a_fresh_config_keeps_the_core_tools(home): + """Desktop/TUI/dashboard enable with no saved ``platform_toolsets`` must not write one: the old + seed ``platform_toolsets.cli: []`` replaced the ``hermes-cli`` composite, so the model + lost every built-in tool (27 -> 2, no ``terminal``). The plugin toolset is on by default anyway.""" + from hermes_cli.tools_config import _get_platform_tools + from tools.registry import registry + + _write_tool_plugin(home / "plugins", "zzseed") + try: + assert plugins_cmd.dashboard_set_agent_plugin_enabled("zzseed", enabled=True)["ok"] is True + cfg = load_config() + assert not cfg.get("platform_toolsets") + assert {"terminal", "file", "zzseed_ts"} <= _get_platform_tools(cfg, "cli") + finally: + registry.deregister("zzseed_tool") + + def test_status_reports_bundled_defaults_and_the_live_memory_provider(home): """Bundled backends (auto-load) and the plugin selected by ``memory.provider`` run without a ``plugins.enabled`` entry; status must not call them "not enabled" (#73131, #82898).""" diff --git a/tests/hermes_cli/test_plugins_cmd_remove_bookkeeping.py b/tests/hermes_cli/test_plugins_cmd_remove_bookkeeping.py index 8300615188..f929fd56d8 100644 --- a/tests/hermes_cli/test_plugins_cmd_remove_bookkeeping.py +++ b/tests/hermes_cli/test_plugins_cmd_remove_bookkeeping.py @@ -55,6 +55,31 @@ def test_remove_forgets_every_config_trace_and_resets_the_memory_provider(home): assert not cfg["memory"]["provider"] +def test_remove_clears_the_toolset_of_a_plugin_without_provides_tools(home): + """``remove`` drops the plugin's toolset from a saved ``platform_toolsets`` list even when + plugin.yaml never declared ``provides_tools``; otherwise ``hermes config check`` warns about an + unknown toolset forever.""" + from tools.registry import registry + + d = _write_plugin(home / "plugins", "zznodecl", "zznodecl") + (d / "__init__.py").write_text( + "def register(ctx):\n" + " ctx.register_tool(name='zznodecl_tool', toolset='zznodecl_ts', handler=lambda args, **kw: '{}',\n" + " schema={'name': 'zznodecl_tool', 'description': 'probe',\n" + " 'parameters': {'type': 'object', 'properties': {}}})\n", + encoding="utf-8") + (home / "config.yaml").write_text(yaml.safe_dump({ + "plugins": {"enabled": ["zznodecl"]}, + "platform_toolsets": {"cli": ["hermes-cli", "zznodecl_ts"], "telegram": ["hermes-telegram"]}, + }), encoding="utf-8") + try: + assert plugins_cmd.dashboard_remove_user_plugin("zznodecl")["ok"] is True + finally: + registry.deregister("zznodecl_tool") + + assert _config(home)["platform_toolsets"] == {"cli": ["hermes-cli"], "telegram": ["hermes-telegram"]} + + def test_remove_of_a_symlink_inside_the_plugins_dir_unlinks_only_the_link(home): """A dev alias pointing at a sibling install resolves INSIDE the plugins dir, so the containment check passes; removing the alias must not delete the sibling (or its install metadata).""" diff --git a/website/docs/developer-guide/plugins/index.md b/website/docs/developer-guide/plugins/index.md index 20cd97d25f..80751ac727 100644 --- a/website/docs/developer-guide/plugins/index.md +++ b/website/docs/developer-guide/plugins/index.md @@ -280,6 +280,13 @@ provides_hooks: This tells Hermes: "I'm a plugin called calculator, I provide tools and hooks." The `provides_tools` and `provides_hooks` fields are lists of what the plugin registers. +List every tool your `register()` registers in `provides_tools`. The field does **not** decide whether a user-installed plugin's tools load: once the plugin is enabled, everything `register()` registers is available, declared or not. What it does drive: + +- **`hermes plugins validate`**: the "declared tools" check fails when the registered tools don't match the list, which blocks catalog admission. +- **Catalog listing**: the "N tools" chips and tool-name search in the catalog and the dashboard/Desktop Plugins page. +- **Dashboard auth hint**: only declared tools' availability checks are used to show "needs auth" and the `hermes auth ` command. +- **Bundled `kind: platform` plugins only**: the field is the switch that loads `tools.py` in CLI/TUI sessions while the adapter stays deferred. See [Outbound client tools](../adding-platform-adapters.md#outbound-client-tools-provides_tools). + Optional fields you could add: ```yaml author: Your Name diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/developer-guide/plugins/index.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/developer-guide/plugins/index.md index 3dcbf12bf6..486ec4e8c9 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/developer-guide/plugins/index.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/developer-guide/plugins/index.md @@ -67,6 +67,13 @@ provides_hooks: 这告诉 Hermes:"我是一个名为 calculator 的插件,我提供工具和钩子。" `provides_tools` 和 `provides_hooks` 字段是插件注册内容的列表。 +请在 `provides_tools` 中列出 `register()` 注册的每一个工具。该字段**不**决定用户安装的插件的工具是否加载:插件启用后,`register()` 注册的所有工具都可用,无论是否声明。它实际影响的是: + +- **`hermes plugins validate`**:注册的工具与列表不一致时,“declared tools”检查失败,插件无法进入目录(catalog)。 +- **目录展示**:目录及仪表盘/桌面端插件页中的“N 个工具”标签和按工具名搜索。 +- **仪表盘认证提示**:只有已声明工具的可用性检查会用于显示“需要认证”及 `hermes auth ` 命令。 +- **仅限内置的 `kind: platform` 插件**:该字段决定是否在 CLI/TUI 会话中加载 `tools.py`(适配器本身仍延迟加载)。参见 [添加平台适配器](../adding-platform-adapters.md)。 + 可选字段示例: ```yaml author: Your Name From 818c13be1dc4fd28987e1e881a9408224afd4535 Mon Sep 17 00:00:00 2001 From: Teknium <127238744+teknium1@users.noreply.github.com> Date: Thu, 8 Oct 2026 03:25:36 -0700 Subject: [PATCH 36/91] fix(release): give the Nix release build its commit and push Docker images under the attempt ref Two stable-release failures on rc.3-v0.21.6 (run 37753841932): - nix: the stamped release source is a `path:` flake with no git metadata, so self.rev is null, install-stamp.json carries no commit and the packaged `hermes --version` reports "unknown". Pass the commit as `?rev=$GITHUB_SHA` (verified on Nix 2.35: path:?rev= sets self.rev). - docker: the versioned images were pushed under the final vX.Y.Z, which does not exist until publish. rc.1 created `:v0.21.6`, and every later attempt hit "versioned Docker manifest differs" against it. scripts/releases/docker.py (published_digest, promote_stable) already reads the attempt-ref tag, so pass claim-tag to both docker.yml calls. --- .github/workflows/docker.yml | 2 +- .github/workflows/nix.yml | 7 +++++-- .github/workflows/stable-release.yml | 4 ++-- tests/ci/test_stable_release_graph.py | 13 +++++++++++++ 4 files changed, 21 insertions(+), 5 deletions(-) diff --git a/.github/workflows/docker.yml b/.github/workflows/docker.yml index c404f9be69..4f8207c97f 100644 --- a/.github/workflows/docker.yml +++ b/.github/workflows/docker.yml @@ -25,7 +25,7 @@ on: type: string default: '' tag: - description: "Exact stable tag (vX.Y.Z) under release. The caller is dispatched on this tag, so github.sha is the release candidate." + description: "Attempt ref (rc.N-vX.Y.Z) under release; the versioned images carry this tag. The caller is dispatched on it, so github.sha is the release candidate." required: false type: string default: '' diff --git a/.github/workflows/nix.yml b/.github/workflows/nix.yml index bf568cce3c..8a2a65fad6 100644 --- a/.github/workflows/nix.yml +++ b/.github/workflows/nix.yml @@ -152,14 +152,17 @@ jobs: - name: nix flake check # --print-build-logs: a check that fails then prints the assertion # that failed, and not only the derivation that failed to build. - run: nix flake check "${{ inputs.release == true && format('path:{0}/release-source', runner.temp) || '.' }}" --print-build-logs + # A path: flake has no git metadata, so the release source names its + # commit with ?rev=: without it self.rev is null, the install stamp + # carries no commit, and the packaged CLI reports "unknown". + run: nix flake check "${{ inputs.release == true && format('path:{0}/release-source?rev={1}', runner.temp, github.sha) || '.' }}" --print-build-logs - name: Verify release package runtime identity if: inputs.release == true env: RELEASE_VERSION: ${{ inputs.version }} run: | - source="path:$RUNNER_TEMP/release-source" + source="path:$RUNNER_TEMP/release-source?rev=$GITHUB_SHA" package="$(nix build "$source#default" --no-link --print-out-paths)" actual="$("$package/bin/hermes" --version)" ACTUAL_VERSION="$actual" python3 - <<'PY' diff --git a/.github/workflows/stable-release.yml b/.github/workflows/stable-release.yml index 727f9ac72e..e8cbcd24b4 100644 --- a/.github/workflows/stable-release.yml +++ b/.github/workflows/stable-release.yml @@ -87,7 +87,7 @@ jobs: with: release-phase: test skip-tests: ${{ needs.admit.outputs.skip-tests == 'true' }} - tag: ${{ needs.admit.outputs.tag }} + tag: ${{ needs.admit.outputs.claim-tag }} version: ${{ needs.admit.outputs.version }} nix: @@ -523,7 +523,7 @@ jobs: secrets: inherit with: release-phase: publish - tag: ${{ needs.admit.outputs.tag }} + tag: ${{ needs.admit.outputs.claim-tag }} version: ${{ needs.admit.outputs.version }} publish-bundles: diff --git a/tests/ci/test_stable_release_graph.py b/tests/ci/test_stable_release_graph.py index 1ed2997c4c..86bd0206cf 100644 --- a/tests/ci/test_stable_release_graph.py +++ b/tests/ci/test_stable_release_graph.py @@ -247,6 +247,19 @@ def test_release_gates_extract_consumer_facing_versions(): ) assert '"$package/bin/hermes" --version' in nix_check assert "actual != expected" in nix_check + # A path: flake has no git metadata; without ?rev= the stamp has no commit + # and the packaged CLI reports "unknown". + assert 'release-source?rev=$GITHUB_SHA' in nix_check + flake_check = next(step["run"] for step in nix["flake-check"]["steps"] if step.get("name") == "nix flake check") + assert "release-source?rev={1}" in flake_check and "github.sha" in flake_check + + +def test_versioned_docker_images_belong_to_one_attempt(): + # The final vX.Y.Z does not exist until publish; a second attempt pushing + # under it collides with the first attempt's immutable manifest list. + jobs = workflow("stable-release.yml")["jobs"] + for name in ("docker", "publish-docker"): + assert jobs[name]["with"]["tag"] == "${{ needs.admit.outputs.claim-tag }}" def test_packaged_stamp_writers_receive_versions_without_rewriting_python_metadata(): From e8a81ed854f4d31f7196cba023637f5b2505bc1a Mon Sep 17 00:00:00 2001 From: Kame696 Date: Mon, 5 Oct 2026 12:09:07 -0300 Subject: [PATCH 37/91] plugin-catalog: add hermes-kame-api-rotation and hermes-kame-provider 1.8.1.9 Rebind-free resubmission after #131918: the key rotation now reaches Hermes through ProviderProfile.create_client (companion model-provider plugin) instead of runtime overrides. Co-Authored-By: Claude Opus 5.5 --- plugin-catalog/hermes-kame-api-rotation.yaml | 24 ++++++++++++++++++++ plugin-catalog/hermes-kame-provider.yaml | 17 ++++++++++++++ 2 files changed, 41 insertions(+) create mode 100644 plugin-catalog/hermes-kame-api-rotation.yaml create mode 100644 plugin-catalog/hermes-kame-provider.yaml diff --git a/plugin-catalog/hermes-kame-api-rotation.yaml b/plugin-catalog/hermes-kame-api-rotation.yaml new file mode 100644 index 0000000000..083bfee65f --- /dev/null +++ b/plugin-catalog/hermes-kame-api-rotation.yaml @@ -0,0 +1,24 @@ +name: hermes-kame-api-rotation +repo: https://github.com/Kame696/kame-api-rotation-for-hermes +sha: eb879a99e3e703ccfe8bd30455edeef9262bf0bb +subdir: hermes-kame-api-rotation +description: "Smart API key rotation: the healthiest key for every call, each 429 / RESOURCE_EXHAUSTED / quota refusal sized from its own evidence. Install with its companion hermes-kame-provider, which hands Hermes this plugin's rotating client through ProviderProfile.create_client; no core override. Disclosure — /kame-keys add|import|split write keys to auth.json through Hermes' pool API after a plaintext backup (last 5 kept); key-redacted local logs and a status file per profile." +maintainer: Kame696 +tier: community +category: models +requires_hermes: ">=0.21.4" +version: "1.8.1.9" +docs_url: https://github.com/Kame696/kame-api-rotation-for-hermes#readme +image: https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/eb879a99e3e703ccfe8bd30455edeef9262bf0bb/assets/kame-banner.png +screenshots: + - https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/eb879a99e3e703ccfe8bd30455edeef9262bf0bb/assets/panel-overview.png + - https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/eb879a99e3e703ccfe8bd30455edeef9262bf0bb/assets/panel-events.png + - https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/eb879a99e3e703ccfe8bd30455edeef9262bf0bb/assets/panel-settings.png +readme: true +capabilities: + provides_tools: [] + provides_hooks: + - transform_api_error_classification + - post_api_request + provides_middleware: [] + requires_env: [] diff --git a/plugin-catalog/hermes-kame-provider.yaml b/plugin-catalog/hermes-kame-provider.yaml new file mode 100644 index 0000000000..e32492ac55 --- /dev/null +++ b/plugin-catalog/hermes-kame-provider.yaml @@ -0,0 +1,17 @@ +name: hermes-kame-provider +repo: https://github.com/Kame696/kame-api-rotation-for-hermes +sha: eb879a99e3e703ccfe8bd30455edeef9262bf0bb +subdir: hermes-kame-provider +description: "Companion to hermes-kame-api-rotation (install both). A model-provider plugin that re-registers Hermes' bundled API-key chat-completions profiles unchanged except for create_client, which returns the rotation plugin's key-rotating client; otherwise None and Hermes builds its own. Same endpoints as Hermes, no third-party service, no core override." +maintainer: Kame696 +tier: community +category: models +requires_hermes: ">=0.21.4" +version: "1.8.1.9" +docs_url: https://github.com/Kame696/kame-api-rotation-for-hermes/tree/main/hermes-kame-provider#readme +readme: true +capabilities: + provides_tools: [] + provides_hooks: [] + provides_middleware: [] + requires_env: [] From 8a69c000c4c37d3aab2f67b8f0da94777bf2b4b4 Mon Sep 17 00:00:00 2001 From: Kame696 Date: Mon, 5 Oct 2026 21:01:10 -0300 Subject: [PATCH 38/91] plugin-catalog: KAME 1.8.1.9 at a6460ac - every wire, status line, disclosure of multi-key sync Co-Authored-By: Claude Opus 5.5 --- plugin-catalog/hermes-kame-api-rotation.yaml | 13 +++++++------ plugin-catalog/hermes-kame-provider.yaml | 4 ++-- 2 files changed, 9 insertions(+), 8 deletions(-) diff --git a/plugin-catalog/hermes-kame-api-rotation.yaml b/plugin-catalog/hermes-kame-api-rotation.yaml index 083bfee65f..5cc72d230d 100644 --- a/plugin-catalog/hermes-kame-api-rotation.yaml +++ b/plugin-catalog/hermes-kame-api-rotation.yaml @@ -1,24 +1,25 @@ name: hermes-kame-api-rotation repo: https://github.com/Kame696/kame-api-rotation-for-hermes -sha: eb879a99e3e703ccfe8bd30455edeef9262bf0bb +sha: a6460ac6cd059eaacd0a28bf3f9415fbbc8d4516 subdir: hermes-kame-api-rotation -description: "Smart API key rotation: the healthiest key for every call, each 429 / RESOURCE_EXHAUSTED / quota refusal sized from its own evidence. Install with its companion hermes-kame-provider, which hands Hermes this plugin's rotating client through ProviderProfile.create_client; no core override. Disclosure — /kame-keys add|import|split write keys to auth.json through Hermes' pool API after a plaintext backup (last 5 kept); key-redacted local logs and a status file per profile." +description: "Smart API key rotation: the healthiest key for every call, each 429 / RESOURCE_EXHAUSTED / quota refusal sized from its own evidence. Install with its companion hermes-kame-provider, which hands Hermes this plugin's rotating client through ProviderProfile.create_client (and create_messages_client where Hermes offers it); no core override. Disclosure — /kame-keys add|import|split, and on start a key variable holding several comma-joined keys, write one auth.json pool row per key through Hermes' pool API after a plaintext backup (last 5 kept; switch: resolver_disabled); key-redacted local logs and a status file per profile." maintainer: Kame696 tier: community category: models requires_hermes: ">=0.21.4" version: "1.8.1.9" docs_url: https://github.com/Kame696/kame-api-rotation-for-hermes#readme -image: https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/eb879a99e3e703ccfe8bd30455edeef9262bf0bb/assets/kame-banner.png +image: https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/a6460ac6cd059eaacd0a28bf3f9415fbbc8d4516/assets/kame-banner.png screenshots: - - https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/eb879a99e3e703ccfe8bd30455edeef9262bf0bb/assets/panel-overview.png - - https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/eb879a99e3e703ccfe8bd30455edeef9262bf0bb/assets/panel-events.png - - https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/eb879a99e3e703ccfe8bd30455edeef9262bf0bb/assets/panel-settings.png + - https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/a6460ac6cd059eaacd0a28bf3f9415fbbc8d4516/assets/panel-overview.png + - https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/a6460ac6cd059eaacd0a28bf3f9415fbbc8d4516/assets/panel-events.png + - https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/a6460ac6cd059eaacd0a28bf3f9415fbbc8d4516/assets/panel-settings.png readme: true capabilities: provides_tools: [] provides_hooks: - transform_api_error_classification - post_api_request + - on_session_reset provides_middleware: [] requires_env: [] diff --git a/plugin-catalog/hermes-kame-provider.yaml b/plugin-catalog/hermes-kame-provider.yaml index e32492ac55..53a0f93e70 100644 --- a/plugin-catalog/hermes-kame-provider.yaml +++ b/plugin-catalog/hermes-kame-provider.yaml @@ -1,8 +1,8 @@ name: hermes-kame-provider repo: https://github.com/Kame696/kame-api-rotation-for-hermes -sha: eb879a99e3e703ccfe8bd30455edeef9262bf0bb +sha: a6460ac6cd059eaacd0a28bf3f9415fbbc8d4516 subdir: hermes-kame-provider -description: "Companion to hermes-kame-api-rotation (install both). A model-provider plugin that re-registers Hermes' bundled API-key chat-completions profiles unchanged except for create_client, which returns the rotation plugin's key-rotating client; otherwise None and Hermes builds its own. Same endpoints as Hermes, no third-party service, no core override." +description: "Companion to hermes-kame-api-rotation (install both). A model-provider plugin that re-registers Hermes' bundled API-key profiles unchanged except for create_client and create_messages_client, which return the rotation plugin's key-rotating client; otherwise None and Hermes builds its own. Same endpoints as Hermes, no third-party service, no core override." maintainer: Kame696 tier: community category: models From 1f47609c8d71bcb7745e201590de4c2d447516f5 Mon Sep 17 00:00:00 2001 From: Kame696 Date: Tue, 6 Oct 2026 20:15:09 -0300 Subject: [PATCH 39/91] plugin-catalog: KAME 1.8.2.0 at 9e75fba - panel on the SDK only, opt-in total wait bound, capped 0600 logs Co-Authored-By: Claude Opus 5.5 --- plugin-catalog/hermes-kame-api-rotation.yaml | 16 ++++++++-------- plugin-catalog/hermes-kame-provider.yaml | 6 +++--- 2 files changed, 11 insertions(+), 11 deletions(-) diff --git a/plugin-catalog/hermes-kame-api-rotation.yaml b/plugin-catalog/hermes-kame-api-rotation.yaml index 5cc72d230d..a8f13bd941 100644 --- a/plugin-catalog/hermes-kame-api-rotation.yaml +++ b/plugin-catalog/hermes-kame-api-rotation.yaml @@ -1,19 +1,19 @@ name: hermes-kame-api-rotation repo: https://github.com/Kame696/kame-api-rotation-for-hermes -sha: a6460ac6cd059eaacd0a28bf3f9415fbbc8d4516 +sha: 9e75fbac1e2298a378276178f5b787a99834aa5f subdir: hermes-kame-api-rotation -description: "Smart API key rotation: the healthiest key for every call, each 429 / RESOURCE_EXHAUSTED / quota refusal sized from its own evidence. Install with its companion hermes-kame-provider, which hands Hermes this plugin's rotating client through ProviderProfile.create_client (and create_messages_client where Hermes offers it); no core override. Disclosure — /kame-keys add|import|split, and on start a key variable holding several comma-joined keys, write one auth.json pool row per key through Hermes' pool API after a plaintext backup (last 5 kept; switch: resolver_disabled); key-redacted local logs and a status file per profile." +description: "Smart API key rotation: the healthiest key for every call, each 429 / RESOURCE_EXHAUSTED / quota refusal sized from its own evidence. Install with its companion hermes-kame-provider, which hands Hermes this plugin's rotating client through ProviderProfile.create_client (and create_messages_client where Hermes offers it); no core override. Disclosure — /kame-keys add|import|split, and on start a key variable holding several comma-joined keys, write one auth.json pool row per key through Hermes' pool API after a plaintext backup (last 5 kept; switch: resolver_disabled); key-redacted, size-capped owner-only local logs and a status file per profile; the Desktop panel reads that file and queues its settings requests through its own dashboard/plugin_api.py route (GET /state, POST /control, this plugin's plugin-data folder only)." maintainer: Kame696 tier: community category: models requires_hermes: ">=0.21.4" -version: "1.8.1.9" -docs_url: https://github.com/Kame696/kame-api-rotation-for-hermes#readme -image: https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/a6460ac6cd059eaacd0a28bf3f9415fbbc8d4516/assets/kame-banner.png +version: "1.8.2.0" +docs_url: https://github.com/Kame696/kame-api-rotation-for-hermes/tree/v1.8.2.0#readme +image: https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/9e75fbac1e2298a378276178f5b787a99834aa5f/assets/kame-banner.png screenshots: - - https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/a6460ac6cd059eaacd0a28bf3f9415fbbc8d4516/assets/panel-overview.png - - https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/a6460ac6cd059eaacd0a28bf3f9415fbbc8d4516/assets/panel-events.png - - https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/a6460ac6cd059eaacd0a28bf3f9415fbbc8d4516/assets/panel-settings.png + - https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/9e75fbac1e2298a378276178f5b787a99834aa5f/assets/panel-overview.png + - https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/9e75fbac1e2298a378276178f5b787a99834aa5f/assets/panel-events.png + - https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/9e75fbac1e2298a378276178f5b787a99834aa5f/assets/panel-settings.png readme: true capabilities: provides_tools: [] diff --git a/plugin-catalog/hermes-kame-provider.yaml b/plugin-catalog/hermes-kame-provider.yaml index 53a0f93e70..cf135292f8 100644 --- a/plugin-catalog/hermes-kame-provider.yaml +++ b/plugin-catalog/hermes-kame-provider.yaml @@ -1,14 +1,14 @@ name: hermes-kame-provider repo: https://github.com/Kame696/kame-api-rotation-for-hermes -sha: a6460ac6cd059eaacd0a28bf3f9415fbbc8d4516 +sha: 9e75fbac1e2298a378276178f5b787a99834aa5f subdir: hermes-kame-provider description: "Companion to hermes-kame-api-rotation (install both). A model-provider plugin that re-registers Hermes' bundled API-key profiles unchanged except for create_client and create_messages_client, which return the rotation plugin's key-rotating client; otherwise None and Hermes builds its own. Same endpoints as Hermes, no third-party service, no core override." maintainer: Kame696 tier: community category: models requires_hermes: ">=0.21.4" -version: "1.8.1.9" -docs_url: https://github.com/Kame696/kame-api-rotation-for-hermes/tree/main/hermes-kame-provider#readme +version: "1.8.2.0" +docs_url: https://github.com/Kame696/kame-api-rotation-for-hermes/tree/v1.8.2.0/hermes-kame-provider#readme readme: true capabilities: provides_tools: [] From 96795fc349735657b857b2e8a753496b65d4ad73 Mon Sep 17 00:00:00 2001 From: Kame696 Date: Wed, 7 Oct 2026 10:04:46 -0300 Subject: [PATCH 40/91] plugin-catalog: KAME 1.8.2.1 at d723324 - cron runs bounded at 300 s when unset, bridge marked unsupported Co-Authored-By: Claude Opus 5.5 --- plugin-catalog/hermes-kame-api-rotation.yaml | 14 +++++++------- plugin-catalog/hermes-kame-provider.yaml | 6 +++--- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/plugin-catalog/hermes-kame-api-rotation.yaml b/plugin-catalog/hermes-kame-api-rotation.yaml index a8f13bd941..b386847a61 100644 --- a/plugin-catalog/hermes-kame-api-rotation.yaml +++ b/plugin-catalog/hermes-kame-api-rotation.yaml @@ -1,19 +1,19 @@ name: hermes-kame-api-rotation repo: https://github.com/Kame696/kame-api-rotation-for-hermes -sha: 9e75fbac1e2298a378276178f5b787a99834aa5f +sha: d723324774c2fdd068d4071062436b3bdba0a249 subdir: hermes-kame-api-rotation description: "Smart API key rotation: the healthiest key for every call, each 429 / RESOURCE_EXHAUSTED / quota refusal sized from its own evidence. Install with its companion hermes-kame-provider, which hands Hermes this plugin's rotating client through ProviderProfile.create_client (and create_messages_client where Hermes offers it); no core override. Disclosure — /kame-keys add|import|split, and on start a key variable holding several comma-joined keys, write one auth.json pool row per key through Hermes' pool API after a plaintext backup (last 5 kept; switch: resolver_disabled); key-redacted, size-capped owner-only local logs and a status file per profile; the Desktop panel reads that file and queues its settings requests through its own dashboard/plugin_api.py route (GET /state, POST /control, this plugin's plugin-data folder only)." maintainer: Kame696 tier: community category: models requires_hermes: ">=0.21.4" -version: "1.8.2.0" -docs_url: https://github.com/Kame696/kame-api-rotation-for-hermes/tree/v1.8.2.0#readme -image: https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/9e75fbac1e2298a378276178f5b787a99834aa5f/assets/kame-banner.png +version: "1.8.2.1" +docs_url: https://github.com/Kame696/kame-api-rotation-for-hermes/tree/v1.8.2.1#readme +image: https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/d723324774c2fdd068d4071062436b3bdba0a249/assets/kame-banner.png screenshots: - - https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/9e75fbac1e2298a378276178f5b787a99834aa5f/assets/panel-overview.png - - https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/9e75fbac1e2298a378276178f5b787a99834aa5f/assets/panel-events.png - - https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/9e75fbac1e2298a378276178f5b787a99834aa5f/assets/panel-settings.png + - https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/d723324774c2fdd068d4071062436b3bdba0a249/assets/panel-overview.png + - https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/d723324774c2fdd068d4071062436b3bdba0a249/assets/panel-events.png + - https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/d723324774c2fdd068d4071062436b3bdba0a249/assets/panel-settings.png readme: true capabilities: provides_tools: [] diff --git a/plugin-catalog/hermes-kame-provider.yaml b/plugin-catalog/hermes-kame-provider.yaml index cf135292f8..c1d6da9903 100644 --- a/plugin-catalog/hermes-kame-provider.yaml +++ b/plugin-catalog/hermes-kame-provider.yaml @@ -1,14 +1,14 @@ name: hermes-kame-provider repo: https://github.com/Kame696/kame-api-rotation-for-hermes -sha: 9e75fbac1e2298a378276178f5b787a99834aa5f +sha: d723324774c2fdd068d4071062436b3bdba0a249 subdir: hermes-kame-provider description: "Companion to hermes-kame-api-rotation (install both). A model-provider plugin that re-registers Hermes' bundled API-key profiles unchanged except for create_client and create_messages_client, which return the rotation plugin's key-rotating client; otherwise None and Hermes builds its own. Same endpoints as Hermes, no third-party service, no core override." maintainer: Kame696 tier: community category: models requires_hermes: ">=0.21.4" -version: "1.8.2.0" -docs_url: https://github.com/Kame696/kame-api-rotation-for-hermes/tree/v1.8.2.0/hermes-kame-provider#readme +version: "1.8.2.1" +docs_url: https://github.com/Kame696/kame-api-rotation-for-hermes/tree/v1.8.2.1/hermes-kame-provider#readme readme: true capabilities: provides_tools: [] From a29039eee2b8cf983b1520181fe5355f1e020bfa Mon Sep 17 00:00:00 2001 From: Kame696 Date: Wed, 7 Oct 2026 14:02:27 -0300 Subject: [PATCH 41/91] plugin-catalog: KAME 1.8.2.2 at cab5372 - fixes from real use (settings reach every process, panel reads serialized) Co-Authored-By: Claude Opus 5.5 --- plugin-catalog/hermes-kame-api-rotation.yaml | 14 +++++++------- plugin-catalog/hermes-kame-provider.yaml | 6 +++--- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/plugin-catalog/hermes-kame-api-rotation.yaml b/plugin-catalog/hermes-kame-api-rotation.yaml index b386847a61..2880cba4bc 100644 --- a/plugin-catalog/hermes-kame-api-rotation.yaml +++ b/plugin-catalog/hermes-kame-api-rotation.yaml @@ -1,19 +1,19 @@ name: hermes-kame-api-rotation repo: https://github.com/Kame696/kame-api-rotation-for-hermes -sha: d723324774c2fdd068d4071062436b3bdba0a249 +sha: cab5372d18d233da905c9f84a343359d2bc26564 subdir: hermes-kame-api-rotation description: "Smart API key rotation: the healthiest key for every call, each 429 / RESOURCE_EXHAUSTED / quota refusal sized from its own evidence. Install with its companion hermes-kame-provider, which hands Hermes this plugin's rotating client through ProviderProfile.create_client (and create_messages_client where Hermes offers it); no core override. Disclosure — /kame-keys add|import|split, and on start a key variable holding several comma-joined keys, write one auth.json pool row per key through Hermes' pool API after a plaintext backup (last 5 kept; switch: resolver_disabled); key-redacted, size-capped owner-only local logs and a status file per profile; the Desktop panel reads that file and queues its settings requests through its own dashboard/plugin_api.py route (GET /state, POST /control, this plugin's plugin-data folder only)." maintainer: Kame696 tier: community category: models requires_hermes: ">=0.21.4" -version: "1.8.2.1" -docs_url: https://github.com/Kame696/kame-api-rotation-for-hermes/tree/v1.8.2.1#readme -image: https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/d723324774c2fdd068d4071062436b3bdba0a249/assets/kame-banner.png +version: "1.8.2.2" +docs_url: https://github.com/Kame696/kame-api-rotation-for-hermes/tree/v1.8.2.2#readme +image: https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/cab5372d18d233da905c9f84a343359d2bc26564/assets/kame-banner.png screenshots: - - https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/d723324774c2fdd068d4071062436b3bdba0a249/assets/panel-overview.png - - https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/d723324774c2fdd068d4071062436b3bdba0a249/assets/panel-events.png - - https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/d723324774c2fdd068d4071062436b3bdba0a249/assets/panel-settings.png + - https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/cab5372d18d233da905c9f84a343359d2bc26564/assets/panel-overview.png + - https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/cab5372d18d233da905c9f84a343359d2bc26564/assets/panel-events.png + - https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/cab5372d18d233da905c9f84a343359d2bc26564/assets/panel-settings.png readme: true capabilities: provides_tools: [] diff --git a/plugin-catalog/hermes-kame-provider.yaml b/plugin-catalog/hermes-kame-provider.yaml index c1d6da9903..d019dd6c49 100644 --- a/plugin-catalog/hermes-kame-provider.yaml +++ b/plugin-catalog/hermes-kame-provider.yaml @@ -1,14 +1,14 @@ name: hermes-kame-provider repo: https://github.com/Kame696/kame-api-rotation-for-hermes -sha: d723324774c2fdd068d4071062436b3bdba0a249 +sha: cab5372d18d233da905c9f84a343359d2bc26564 subdir: hermes-kame-provider description: "Companion to hermes-kame-api-rotation (install both). A model-provider plugin that re-registers Hermes' bundled API-key profiles unchanged except for create_client and create_messages_client, which return the rotation plugin's key-rotating client; otherwise None and Hermes builds its own. Same endpoints as Hermes, no third-party service, no core override." maintainer: Kame696 tier: community category: models requires_hermes: ">=0.21.4" -version: "1.8.2.1" -docs_url: https://github.com/Kame696/kame-api-rotation-for-hermes/tree/v1.8.2.1/hermes-kame-provider#readme +version: "1.8.2.2" +docs_url: https://github.com/Kame696/kame-api-rotation-for-hermes/tree/v1.8.2.2/hermes-kame-provider#readme readme: true capabilities: provides_tools: [] From 1f74f63b2127af65bcb24509cd0d62c02e018eea Mon Sep 17 00:00:00 2001 From: teknium1 Date: Thu, 8 Oct 2026 02:43:24 -0700 Subject: [PATCH 42/91] chore(catalog): review disclosure for hermes-kame-api-rotation, hermes-kame-provider --- plugin-catalog/hermes-kame-api-rotation.yaml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/plugin-catalog/hermes-kame-api-rotation.yaml b/plugin-catalog/hermes-kame-api-rotation.yaml index 2880cba4bc..5fa75c8db7 100644 --- a/plugin-catalog/hermes-kame-api-rotation.yaml +++ b/plugin-catalog/hermes-kame-api-rotation.yaml @@ -2,7 +2,7 @@ name: hermes-kame-api-rotation repo: https://github.com/Kame696/kame-api-rotation-for-hermes sha: cab5372d18d233da905c9f84a343359d2bc26564 subdir: hermes-kame-api-rotation -description: "Smart API key rotation: the healthiest key for every call, each 429 / RESOURCE_EXHAUSTED / quota refusal sized from its own evidence. Install with its companion hermes-kame-provider, which hands Hermes this plugin's rotating client through ProviderProfile.create_client (and create_messages_client where Hermes offers it); no core override. Disclosure — /kame-keys add|import|split, and on start a key variable holding several comma-joined keys, write one auth.json pool row per key through Hermes' pool API after a plaintext backup (last 5 kept; switch: resolver_disabled); key-redacted, size-capped owner-only local logs and a status file per profile; the Desktop panel reads that file and queues its settings requests through its own dashboard/plugin_api.py route (GET /state, POST /control, this plugin's plugin-data folder only)." +description: "Smart API key rotation: the healthiest key for every call, each 429 / RESOURCE_EXHAUSTED / quota refusal sized from its own evidence. Install with its companion hermes-kame-provider, which hands Hermes this plugin's rotating client through ProviderProfile.create_client (and create_messages_client where Hermes offers it); no core override. Disclosure — /kame-keys add|import|split, and on start a key variable holding several comma-joined keys, write one auth.json pool row per key through Hermes' pool API after a plaintext backup (last 5 kept; switch: resolver_disabled); key-redacted, size-capped owner-only local logs and a status file per profile; the Desktop panel reads that file and queues its settings requests through its own dashboard/plugin_api.py route (GET /state, POST /control, this plugin's plugin-data folder only); while every key is resting, chats (CLI, Desktop, messaging gateway) keep waiting with no total limit (each key's rest capped by max_hold_seconds) and cron runs give up after 300 s with the provider's refusal unless max_total_wait_seconds is set." maintainer: Kame696 tier: community category: models @@ -18,8 +18,8 @@ readme: true capabilities: provides_tools: [] provides_hooks: - - transform_api_error_classification - - post_api_request - - on_session_reset + - transform_api_error_classification + - post_api_request + - on_session_reset provides_middleware: [] requires_env: [] From 106a53ca07aada0953c23ac0dd9f289503c4bf0a Mon Sep 17 00:00:00 2001 From: teknium1 Date: Thu, 8 Oct 2026 02:43:24 -0700 Subject: [PATCH 43/91] chore: map contributor email for Kame696 --- contributors/emails/Kame696@users.noreply.github.com | 1 + 1 file changed, 1 insertion(+) create mode 100644 contributors/emails/Kame696@users.noreply.github.com diff --git a/contributors/emails/Kame696@users.noreply.github.com b/contributors/emails/Kame696@users.noreply.github.com new file mode 100644 index 0000000000..938dfd7d83 --- /dev/null +++ b/contributors/emails/Kame696@users.noreply.github.com @@ -0,0 +1 @@ +Kame696 From 1f72ffe2465a9375c26ff66cb8efef892e5e587b Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Mon, 5 Oct 2026 21:51:27 -0600 Subject: [PATCH 44/91] plugin-catalog: list alans-way Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 plugin-catalog/alans-way.yaml diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml new file mode 100644 index 0000000000..ea2291e60e --- /dev/null +++ b/plugin-catalog/alans-way.yaml @@ -0,0 +1,22 @@ +name: alans-way +repo: https://github.com/capthvnsen/alans-way-agents +sha: 01f9e638260cb830e386226a63c4f04edb29ddd2 +subdir: alans-way +version: "0.4.1" +title: "Alan's Way" +description: Proactive primary bot for Hermes. After install, the workspace-setup skill walks the agent through a separate Mac app and Tailscale setup. +maintainer: capthvnsen +tier: community +category: automation +requires_hermes: ">=0.21" +docs_url: https://github.com/capthvnsen/alans-way +readme: true +platforms: [linux, macos] +known_issues: + - "The Mac app is not part of this plugin. Ask the agent to set up Alan's Way; the workspace-setup skill fetches the app repo and walks through it." +capabilities: + provides_tools: + - proactive_control + provides_hooks: [] + provides_middleware: [] + requires_env: [] From e19c061b95e2909f9af7df58d0d6b6c554162a76 Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Mon, 5 Oct 2026 21:59:37 -0600 Subject: [PATCH 45/91] plugin-catalog: say alans-way installs on the remote Hermes host Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index ea2291e60e..78919c1c43 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -4,16 +4,16 @@ sha: 01f9e638260cb830e386226a63c4f04edb29ddd2 subdir: alans-way version: "0.4.1" title: "Alan's Way" -description: Proactive primary bot for Hermes. After install, the workspace-setup skill walks the agent through a separate Mac app and Tailscale setup. +description: Proactive primary bot for a Hermes gateway running on a remote Linux machine. After install, the workspace-setup skill walks that agent through a separate Mac app and Tailscale setup. maintainer: capthvnsen tier: community category: automation requires_hermes: ">=0.21" docs_url: https://github.com/capthvnsen/alans-way readme: true -platforms: [linux, macos] +platforms: [linux] known_issues: - - "The Mac app is not part of this plugin. Ask the agent to set up Alan's Way; the workspace-setup skill fetches the app repo and walks through it." + - "Install this on the remote Linux machine that runs Hermes, not on the Mac. The Mac runs the separate app. Ask the agent to set up Alan's Way; the workspace-setup skill walks through it." capabilities: provides_tools: - proactive_control From 481e42e1b17ba2f3e5a080463c987c5c7b6c4664 Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Mon, 5 Oct 2026 22:09:12 -0600 Subject: [PATCH 46/91] plugin-catalog: pin alans-way to the hook-in-plugin commit Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index 78919c1c43..e73269c5eb 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: 01f9e638260cb830e386226a63c4f04edb29ddd2 +sha: 3a74614aa6ef43353500553526325c2fc33da9e5 subdir: alans-way version: "0.4.1" title: "Alan's Way" @@ -13,7 +13,7 @@ docs_url: https://github.com/capthvnsen/alans-way readme: true platforms: [linux] known_issues: - - "Install this on the remote Linux machine that runs Hermes, not on the Mac. The Mac runs the separate app. Ask the agent to set up Alan's Way; the workspace-setup skill walks through it." + - "Install this on the remote Linux machine that runs Hermes, not on the Mac. The Mac app is Apple Silicon only. Ask the agent to set up Alan's Way. If the plugin is already installed, that setup must pass --skip-plugin so this pin stays." capabilities: provides_tools: - proactive_control From f27f158b1bfbc537155b11d9f6adeb5a76a4ccb2 Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 00:09:41 -0600 Subject: [PATCH 47/91] plugin-catalog: pin alans-way to the connector tool names Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index e73269c5eb..10e78759d3 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: 3a74614aa6ef43353500553526325c2fc33da9e5 +sha: fad319100ffd58dbf5149cb539a8239aa8d50b8a subdir: alans-way version: "0.4.1" title: "Alan's Way" From c3f42a20f7759833ecd09e06dbd44ae590e33ff9 Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 00:26:06 -0600 Subject: [PATCH 48/91] plugin-catalog: pin alans-way to the window-screenshot skill --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index 10e78759d3..4e632da5b7 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: fad319100ffd58dbf5149cb539a8239aa8d50b8a +sha: 500178994ea53a7170bebba3a0b034a0ae01fd3d subdir: alans-way version: "0.4.1" title: "Alan's Way" From 7ca9d921fb0164238d984b3489c3eed0d8d5b1c1 Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 00:48:06 -0600 Subject: [PATCH 49/91] plugin-catalog: pin alans-way to the Linux desktop tree Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index 4e632da5b7..12ba6e5d69 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: 500178994ea53a7170bebba3a0b034a0ae01fd3d +sha: a538eabc7dad1685c3fbf0de636ecfa99cdac279 subdir: alans-way version: "0.4.1" title: "Alan's Way" From 35d3d47387b97ff9eb52bf7fff46515252d01d44 Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 01:04:50 -0600 Subject: [PATCH 50/91] plugin-catalog: pin alans-way to the cheap desktop snapshot --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index 12ba6e5d69..94d312dae6 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: a538eabc7dad1685c3fbf0de636ecfa99cdac279 +sha: 210a47066d01373bec214d4b1b446616df2b30a0 subdir: alans-way version: "0.4.1" title: "Alan's Way" From 94847a868a58973840acd4b5cc024d7dac9d04cd Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 01:18:41 -0600 Subject: [PATCH 51/91] plugin-catalog: pin alans-way to the action tree Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index 94d312dae6..a290ce4664 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: 210a47066d01373bec214d4b1b446616df2b30a0 +sha: 3ec2d9dcea0ee8d07ea1ae7d25d5b05bc974f02e subdir: alans-way version: "0.4.1" title: "Alan's Way" From c718a3f0c7e21d7e750c00fe070558cc42d7e136 Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 01:34:37 -0600 Subject: [PATCH 52/91] plugin-catalog: pin alans-way to the Linux coordinate click --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index a290ce4664..90f79ee106 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: 3ec2d9dcea0ee8d07ea1ae7d25d5b05bc974f02e +sha: 25751c021b0ff071187ee1074ff724fab99b9db7 subdir: alans-way version: "0.4.1" title: "Alan's Way" From 2bfeadb223d40c8a6c727ae59720cc75cf93e7ca Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 01:50:44 -0600 Subject: [PATCH 53/91] plugin-catalog: pin alans-way to the connector reload --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index 90f79ee106..782c937730 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: 25751c021b0ff071187ee1074ff724fab99b9db7 +sha: feaca97433c4ddc28336793ffb3b0d6ff8046aef subdir: alans-way version: "0.4.1" title: "Alan's Way" From d6006e859db1899c8aca1af0a42dcb2a3ebb35a5 Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 02:05:15 -0600 Subject: [PATCH 54/91] plugin-catalog: pin alans-way to the Linux slider drag Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index 782c937730..ec6465b7a5 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: feaca97433c4ddc28336793ffb3b0d6ff8046aef +sha: b287f31ddd39187abfe94ae4263032f36a225e7b subdir: alans-way version: "0.4.1" title: "Alan's Way" From 06f675dd1bff0385418722472810a7d656cc8e5f Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 02:20:35 -0600 Subject: [PATCH 55/91] plugin-catalog: pin alans-way to desktop text entry Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index ec6465b7a5..638ce03a67 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: b287f31ddd39187abfe94ae4263032f36a225e7b +sha: 415bcfbd0373bdc8f154a203e03e1bcf9b9115d2 subdir: alans-way version: "0.4.1" title: "Alan's Way" From 835da03dd62af23eac87a49f50dc7d7af234b0b2 Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 02:37:23 -0600 Subject: [PATCH 56/91] plugin-catalog: pin alans-way to the scroll bar drag --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index 638ce03a67..f98713b4b2 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: 415bcfbd0373bdc8f154a203e03e1bcf9b9115d2 +sha: 5cb16281f38569a1464e4b6a6b932f1abba25870 subdir: alans-way version: "0.4.1" title: "Alan's Way" From 901061fc5a9a71c7cdc670d988a92467fe9c7097 Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 02:52:17 -0600 Subject: [PATCH 57/91] plugin-catalog: pin alans-way to the Mac slider drag Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index f98713b4b2..08bcd45733 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: 5cb16281f38569a1464e4b6a6b932f1abba25870 +sha: ddf8a1b4013dc02229c509c29a7e3131752d32c7 subdir: alans-way version: "0.4.1" title: "Alan's Way" From 41ee8c0d1887b45c1f6843dbb7867e5e476f7b27 Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 03:06:10 -0600 Subject: [PATCH 58/91] plugin-catalog: pin alans-way to check box state in the snapshot Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index 08bcd45733..9cd6fd88b7 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: ddf8a1b4013dc02229c509c29a7e3131752d32c7 +sha: 87597bd080d5e31dd541fc64bbf0807e702e8ac5 subdir: alans-way version: "0.4.1" title: "Alan's Way" From 3cb1bfafa036ff8a1c56ec918b81227014b0536e Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 03:20:26 -0600 Subject: [PATCH 59/91] plugin-catalog: pin alans-way to disabled controls in the snapshot Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index 9cd6fd88b7..3c883bd6e1 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: 87597bd080d5e31dd541fc64bbf0807e702e8ac5 +sha: 9da38ee51e5b26330163110e425f2131c081d7ee subdir: alans-way version: "0.4.1" title: "Alan's Way" From cadf0c3d2d924bf94b610ddb98054b6288666eb3 Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 03:37:50 -0600 Subject: [PATCH 60/91] plugin-catalog: pin alans-way to web snapshot control names --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index 3c883bd6e1..606292d3c6 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: 9da38ee51e5b26330163110e425f2131c081d7ee +sha: 4a6ec80e2b0fbfe13eae7041c9e372308feccce0 subdir: alans-way version: "0.4.1" title: "Alan's Way" From fead2120520e65e6dbb6edc00aa9d131e81b292b Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 03:51:20 -0600 Subject: [PATCH 61/91] plugin-catalog: pin alans-way to open and closed web sections Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index 606292d3c6..a492d743ad 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: 4a6ec80e2b0fbfe13eae7041c9e372308feccce0 +sha: b9231c49a07511a0420b1a8c5ff202073cebb67f subdir: alans-way version: "0.4.1" title: "Alan's Way" From 6c90e4eefbbfc359ebe032c47ec1bee85561bc81 Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 04:04:06 -0600 Subject: [PATCH 62/91] plugin-catalog: pin alans-way to selected tabs and current links Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index a492d743ad..4f51e5e175 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: b9231c49a07511a0420b1a8c5ff202073cebb67f +sha: 01cab0d5777441c1cf4dc6e33cbeb8356fd3bc79 subdir: alans-way version: "0.4.1" title: "Alan's Way" From a5540bc6e1de8c4bf211651fe158c8c9069c7c1d Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 04:36:44 -0600 Subject: [PATCH 63/91] plugin-catalog: pin alans-way to controls returned by a web action Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index 4f51e5e175..3383bb5fb2 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: 01cab0d5777441c1cf4dc6e33cbeb8356fd3bc79 +sha: 4f90412c9cd2ef29379a5c7d24b17c96faa78d25 subdir: alans-way version: "0.4.1" title: "Alan's Way" From ae3990b6654e939722e7c674447ddff15a8517fe Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 05:08:35 -0600 Subject: [PATCH 64/91] plugin-catalog: pin alans-way to named menu items and clickable divs Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index 3383bb5fb2..882cc38a70 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: 4f90412c9cd2ef29379a5c7d24b17c96faa78d25 +sha: dd28c1b6253bc1268be05fa815f9c484600e4ba6 subdir: alans-way version: "0.4.1" title: "Alan's Way" From 73edff0cd6469c0de65f1c8f2a5eef5a599a209d Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 05:24:16 -0600 Subject: [PATCH 65/91] plugin-catalog: pin alans-way to open shadow root controls Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index 882cc38a70..9f73c20361 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: dd28c1b6253bc1268be05fa815f9c484600e4ba6 +sha: 8adb6fd1b3e6633c32cfccea2b94c110bb999831 subdir: alans-way version: "0.4.1" title: "Alan's Way" From ef33083ef5a34b037ae34228417d265237ed0d6d Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 05:39:01 -0600 Subject: [PATCH 66/91] plugin-catalog: pin alans-way to same-origin frame controls Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index 9f73c20361..555fa10427 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: 8adb6fd1b3e6633c32cfccea2b94c110bb999831 +sha: 555a33e9de7c17d23aea2b4cb2e3015e4ff043c9 subdir: alans-way version: "0.4.1" title: "Alan's Way" From 0bd1bbfd8070827b012b25b82e847cddebbd362c Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 05:54:12 -0600 Subject: [PATCH 67/91] plugin-catalog: pin alans-way to aria-labelledby control names Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index 555fa10427..82068dbc08 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: 555a33e9de7c17d23aea2b4cb2e3015e4ff043c9 +sha: 734f911240b730bcde92c2b653b2d4a57e56d96b subdir: alans-way version: "0.4.1" title: "Alan's Way" From f013aae929a113dee555c647863386f0cba42771 Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 06:10:19 -0600 Subject: [PATCH 68/91] plugin-catalog: pin alans-way to pressed toggle names Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index 82068dbc08..1180ec3ffe 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: 734f911240b730bcde92c2b653b2d4a57e56d96b +sha: 55a320485b57e8f575e4e5b7c0c086dd28cce004 subdir: alans-way version: "0.4.1" title: "Alan's Way" From 280c6305f58eae82dff2e6f2724735e7c2482deb Mon Sep 17 00:00:00 2001 From: capthvnsen Date: Tue, 6 Oct 2026 06:18:34 -0600 Subject: [PATCH 69/91] plugin-catalog: pin alans-way to b14dec5, version 0.4.2 --- plugin-catalog/alans-way.yaml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index 1180ec3ffe..8c2d26fce0 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,14 +1,14 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: 55a320485b57e8f575e4e5b7c0c086dd28cce004 +sha: b14dec5e4fcdc810326480c3c4428709058ec7b5 subdir: alans-way -version: "0.4.1" +version: "0.4.2" title: "Alan's Way" description: Proactive primary bot for a Hermes gateway running on a remote Linux machine. After install, the workspace-setup skill walks that agent through a separate Mac app and Tailscale setup. maintainer: capthvnsen tier: community category: automation -requires_hermes: ">=0.21" +requires_hermes: ">=0.21.5" docs_url: https://github.com/capthvnsen/alans-way readme: true platforms: [linux] From 1fb6e5880d18904e091bf34c8f42b48751e3c7d7 Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 06:20:39 -0600 Subject: [PATCH 70/91] plugin-catalog: pin alans-way to Mac-first browser use Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index 8c2d26fce0..5b3e087b8d 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: b14dec5e4fcdc810326480c3c4428709058ec7b5 +sha: c21a5a097b8584fd2cf5467f220804d13f606571 subdir: alans-way version: "0.4.2" title: "Alan's Way" From 448e13dac953c85132e79e08ae34db9d8f62c616 Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 06:35:28 -0600 Subject: [PATCH 71/91] plugin-catalog: pin alans-way to continue work when the Mac drops Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index 5b3e087b8d..52911b4bbe 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: c21a5a097b8584fd2cf5467f220804d13f606571 +sha: 555ce90f36b816bdfda29c0a52a4394367463926 subdir: alans-way version: "0.4.2" title: "Alan's Way" From bbe8da5fdfdb012e2b439d845efef1a8c32cc53f Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 06:50:23 -0600 Subject: [PATCH 72/91] plugin-catalog: pin alans-way to resume the last Mac page Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index 52911b4bbe..b238cb2349 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: 555ce90f36b816bdfda29c0a52a4394367463926 +sha: 84d42724f3fafb3d5e50202386aa0f41c9f41395 subdir: alans-way version: "0.4.2" title: "Alan's Way" From 7f4b0c084ef75528f3cbc3a50e0f52961557d972 Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 07:05:53 -0600 Subject: [PATCH 73/91] plugin-catalog: pin alans-way to resume the page being worked Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index b238cb2349..d72e1540be 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: 84d42724f3fafb3d5e50202386aa0f41c9f41395 +sha: 2dec2e95afaedf23d811e2377fcf8198b7f8c009 subdir: alans-way version: "0.4.2" title: "Alan's Way" From 14153bb71115193dae76ed8f3c56bcc546cd7f13 Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 07:59:59 -0600 Subject: [PATCH 74/91] plugin-catalog: pin alans-way to shorter snapshot reads Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index d72e1540be..8fa6ea96f1 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: 2dec2e95afaedf23d811e2377fcf8198b7f8c009 +sha: d3721e10c6e6719f48f67fa20f26c1d144fe6f7c subdir: alans-way version: "0.4.2" title: "Alan's Way" From 58c1aee3d12dfd89ab006cf420d7b760915132d6 Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 08:18:09 -0600 Subject: [PATCH 75/91] plugin-catalog: pin alans-way to continue the last Mac page Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index 8fa6ea96f1..fdf1902f60 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: d3721e10c6e6719f48f67fa20f26c1d144fe6f7c +sha: 1db3581d397f9de448f5b5a1219f559081af8d87 subdir: alans-way version: "0.4.2" title: "Alan's Way" From 47592090b09d6608b045e2510dc191abd693d931 Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 08:35:30 -0600 Subject: [PATCH 76/91] plugin-catalog: pin alans-way to name the continued VPS tab Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index fdf1902f60..22ed0bc56f 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: 1db3581d397f9de448f5b5a1219f559081af8d87 +sha: d672923a7c1ac34733b4a696426d576fa04a8d0a subdir: alans-way version: "0.4.2" title: "Alan's Way" From 066574370a3a2fe5d1e3d9cd9338c66b0de72784 Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 08:50:20 -0600 Subject: [PATCH 77/91] plugin-catalog: pin alans-way to carry a Mac tab onto the VPS page Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index 22ed0bc56f..cc7040988f 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: d672923a7c1ac34733b4a696426d576fa04a8d0a +sha: cf86e86f24462d4f3d891041d05b42ca7912730e subdir: alans-way version: "0.4.2" title: "Alan's Way" From d8e9ffa5dbcdf2b8df5a078c7cce3a3fc155a0c8 Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 09:04:07 -0600 Subject: [PATCH 78/91] plugin-catalog: pin alans-way to carry an action onto the VPS tab Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index cc7040988f..ba4617cc9d 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: cf86e86f24462d4f3d891041d05b42ca7912730e +sha: 2ba75365af1c152dffae624859da5c5f299c535f subdir: alans-way version: "0.4.2" title: "Alan's Way" From 91109dcfc309be53d0e15037f36981a95c1c786e Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 09:18:40 -0600 Subject: [PATCH 79/91] plugin-catalog: pin alans-way to continue a page without waiting for load Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index ba4617cc9d..d694180981 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: 2ba75365af1c152dffae624859da5c5f299c535f +sha: 6d7b404669e8843afa81ea2614cd920cdab86503 subdir: alans-way version: "0.4.2" title: "Alan's Way" From 594c995ec688ee8cbe3155434599283596fad112 Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 09:48:31 -0600 Subject: [PATCH 80/91] plugin-catalog: pin alans-way to return controls when a Mac ref misses Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index d694180981..a2f55f2204 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: 6d7b404669e8843afa81ea2614cd920cdab86503 +sha: 5d35c7e7881a281ba8ef1d290b21aa072a55c34b subdir: alans-way version: "0.4.2" title: "Alan's Way" From 046200c6aeafd985dc4f07769d63d96dabf7c182 Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 10:04:57 -0600 Subject: [PATCH 81/91] plugin-catalog: pin alans-way to a smaller default screenshot Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index a2f55f2204..1cf44fc544 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: 5d35c7e7881a281ba8ef1d290b21aa072a55c34b +sha: caddad921cf526d9e22ce187f2d21878cc3a50e9 subdir: alans-way version: "0.4.2" title: "Alan's Way" From 3e1a9b2177b833bc5939b4de6733b9080b955346 Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 10:20:44 -0600 Subject: [PATCH 82/91] plugin-catalog: pin alans-way to shorter snapshot links Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index 1cf44fc544..b6c11f3fbb 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: caddad921cf526d9e22ce187f2d21878cc3a50e9 +sha: b33a983e1c499f8a28a1fcf747893fb1d977a81f subdir: alans-way version: "0.4.2" title: "Alan's Way" From 5cdd25ca438166428ad80114674f44bb950cf6c8 Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 11:06:25 -0600 Subject: [PATCH 83/91] plugin-catalog: pin alans-way to shorter frame addresses Co-authored-by: Cursor --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index b6c11f3fbb..9771b7a55d 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: b33a983e1c499f8a28a1fcf747893fb1d977a81f +sha: 73cf09767695b714edc03606d5605bd206a1a34e subdir: alans-way version: "0.4.2" title: "Alan's Way" From 92662d709b7d622ecea7d3358e0bbcaa7bb92add Mon Sep 17 00:00:00 2001 From: capthvnsen Date: Tue, 6 Oct 2026 11:41:55 -0600 Subject: [PATCH 84/91] plugin-catalog: pin alans-way to the multi-OS plugin commit --- plugin-catalog/alans-way.yaml | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index 9771b7a55d..8be9be6bb1 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,19 +1,19 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: 73cf09767695b714edc03606d5605bd206a1a34e +sha: 9e2b928241364fb23becea0419d9eb0db2e97fb6 subdir: alans-way -version: "0.4.2" +version: "0.5.0" title: "Alan's Way" -description: Proactive primary bot for a Hermes gateway running on a remote Linux machine. After install, the workspace-setup skill walks that agent through a separate Mac app and Tailscale setup. +description: Proactive primary bot for a Hermes gateway running on a remote Linux machine or a macOS VM. After install, the workspace-setup skill walks that agent through a separate companion app and Tailscale setup on the user's computer (macOS or Windows). maintainer: capthvnsen tier: community category: automation requires_hermes: ">=0.21.5" docs_url: https://github.com/capthvnsen/alans-way readme: true -platforms: [linux] +platforms: [linux, macos] known_issues: - - "Install this on the remote Linux machine that runs Hermes, not on the Mac. The Mac app is Apple Silicon only. Ask the agent to set up Alan's Way. If the plugin is already installed, that setup must pass --skip-plugin so this pin stays." + - "Install this on the machine that runs Hermes — a remote Linux host or a macOS guest VM — not on the user's primary computer. The companion app runs on Apple Silicon macOS or Windows x64. Ask the agent to set up Alan's Way. If the plugin is already installed, that setup must pass --skip-plugin so this pin stays." capabilities: provides_tools: - proactive_control From 413c74eac74fee73bf9722e18b897cad58fbf0eb Mon Sep 17 00:00:00 2001 From: capthvnsen Date: Tue, 6 Oct 2026 16:14:16 -0600 Subject: [PATCH 85/91] chore(catalog): repin alans-way to a4cd39a --- plugin-catalog/alans-way.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index 8be9be6bb1..d76c981eb3 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,6 +1,6 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: 9e2b928241364fb23becea0419d9eb0db2e97fb6 +sha: a4cd39ad41a6da68149e74bd0876cf7945c0ba63 subdir: alans-way version: "0.5.0" title: "Alan's Way" From da762e717bc54fd6573eacbe12a97bd46a082746 Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Tue, 6 Oct 2026 19:19:48 -0600 Subject: [PATCH 86/91] plugin-catalog: pin alans-way to 09c6d3c (0.6.0) and add alans-way-computer Co-Authored-By: Claude Sonnet 5.5 --- plugin-catalog/alans-way-computer.yaml | 31 ++++++++++++++++++++++++++ plugin-catalog/alans-way.yaml | 14 ++++++++---- 2 files changed, 41 insertions(+), 4 deletions(-) create mode 100644 plugin-catalog/alans-way-computer.yaml diff --git a/plugin-catalog/alans-way-computer.yaml b/plugin-catalog/alans-way-computer.yaml new file mode 100644 index 0000000000..1aefbb855b --- /dev/null +++ b/plugin-catalog/alans-way-computer.yaml @@ -0,0 +1,31 @@ +name: alans-way-computer +repo: https://github.com/capthvnsen/alans-way-agents +sha: 09c6d3c2682013123be042ed8a9e4a3dba54fca8 +subdir: alans-way-computer +version: "0.6.0" +title: "Alan's Way Computer" +description: >- + Computer-use provider for Hermes: the stock computer_use tool drives desktop apps on the user's computer + through the Alan's Way app, and on the VM's own desktop when the computer is offline. Needs the alans-way + plugin's workspace setup. Select it with computer_use.backend: alans-way-computer. + Disclosure: starts the workspace router from the profile's workspace_browser MCP block as a long-running + node child and talks to it over stdio (app screenshots, element lists and input actions); the router reaches the + user's computer over SSH on the user's tailnet. It never takes the focused window, and Hermes's computer_use + approval gate is unchanged. +maintainer: capthvnsen +tier: community +category: tools +requires_hermes: ">=0.21.5" +docs_url: https://github.com/capthvnsen/alans-way-agents/tree/09c6d3c2682013123be042ed8a9e4a3dba54fca8/alans-way-computer +readme: true +platforms: [linux, macos] +known_issues: + - "Needs a Hermes build with the pluggable computer-use API (merged to main after 0.21.5). On older Hermes the plugin installs and does nothing. Install alans-way first and run its workspace setup, which writes the workspace_browser block this provider reuses." + - "Hermes asks for approval on every computer_use action type until it is granted. For an unattended Telegram bot, grant them once with Always in Telegram, or add cua::background entries to command_allowlist (see the README). Takes effect after a gateway restart." + - "Runs only in the plugin host: it cannot load under plugins.isolation: host, because the provider hands Hermes a live router session." + - "Typing without a target field is not available because the app never takes focus: the agent uses set_value on a field instead." +capabilities: + provides_tools: [] + provides_hooks: [] + provides_middleware: [] + requires_env: [] diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index d76c981eb3..3c087aee2f 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,10 +1,15 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: a4cd39ad41a6da68149e74bd0876cf7945c0ba63 +sha: 09c6d3c2682013123be042ed8a9e4a3dba54fca8 subdir: alans-way -version: "0.5.0" +version: "0.6.0" title: "Alan's Way" -description: Proactive primary bot for a Hermes gateway running on a remote Linux machine or a macOS VM. After install, the workspace-setup skill walks that agent through a separate companion app and Tailscale setup on the user's computer (macOS or Windows). +description: >- + Proactive primary bot for a Hermes gateway running on a Linux machine or a macOS guest VM. After install, + the workspace-setup skill walks that agent through a separate companion app and Tailscale setup on the + user's computer (macOS, Windows or Linux). Setup configures every bot profile and turns off the stock + browser and computer_use toolsets in favor of the workspace tools. Watches are propose-only: a proposed + watch runs only after the user approves it. maintainer: capthvnsen tier: community category: automation @@ -13,7 +18,8 @@ docs_url: https://github.com/capthvnsen/alans-way readme: true platforms: [linux, macos] known_issues: - - "Install this on the machine that runs Hermes — a remote Linux host or a macOS guest VM — not on the user's primary computer. The companion app runs on Apple Silicon macOS or Windows x64. Ask the agent to set up Alan's Way. If the plugin is already installed, that setup must pass --skip-plugin so this pin stays." + - "Install this on the machine that runs Hermes (a Linux host or a macOS guest VM), not on the user's primary computer. Windows guests are new and untested on real hardware. If the plugin is already installed from the catalog, setup leaves it as it is, so this pin stays." + - "Setup turns off Hermes's browser and computer_use toolsets for Telegram so the agent uses the workspace tools. Pass --keep-browser or --keep-computer-use to leave them on." capabilities: provides_tools: - proactive_control From 5107e65edcf347ea3aa146cc488fc3c2723fcff3 Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Wed, 7 Oct 2026 11:16:53 -0600 Subject: [PATCH 87/91] plugin-catalog: pin alans-way and alans-way-computer to 0.6.1 Co-Authored-By: Claude Opus 5.5 (1M context) --- plugin-catalog/alans-way-computer.yaml | 6 +++--- plugin-catalog/alans-way.yaml | 11 ++++++----- 2 files changed, 9 insertions(+), 8 deletions(-) diff --git a/plugin-catalog/alans-way-computer.yaml b/plugin-catalog/alans-way-computer.yaml index 1aefbb855b..77c2c24686 100644 --- a/plugin-catalog/alans-way-computer.yaml +++ b/plugin-catalog/alans-way-computer.yaml @@ -1,8 +1,8 @@ name: alans-way-computer repo: https://github.com/capthvnsen/alans-way-agents -sha: 09c6d3c2682013123be042ed8a9e4a3dba54fca8 +sha: 8948c75c7192906e8853afffd1c8d826e52f8206 subdir: alans-way-computer -version: "0.6.0" +version: "0.6.1" title: "Alan's Way Computer" description: >- Computer-use provider for Hermes: the stock computer_use tool drives desktop apps on the user's computer @@ -16,7 +16,7 @@ maintainer: capthvnsen tier: community category: tools requires_hermes: ">=0.21.5" -docs_url: https://github.com/capthvnsen/alans-way-agents/tree/09c6d3c2682013123be042ed8a9e4a3dba54fca8/alans-way-computer +docs_url: https://github.com/capthvnsen/alans-way-agents/tree/8948c75c7192906e8853afffd1c8d826e52f8206/alans-way-computer readme: true platforms: [linux, macos] known_issues: diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index 3c087aee2f..e5de4d7672 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,25 +1,26 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: 09c6d3c2682013123be042ed8a9e4a3dba54fca8 +sha: 8948c75c7192906e8853afffd1c8d826e52f8206 subdir: alans-way -version: "0.6.0" +version: "0.6.1" title: "Alan's Way" description: >- Proactive primary bot for a Hermes gateway running on a Linux machine or a macOS guest VM. After install, the workspace-setup skill walks that agent through a separate companion app and Tailscale setup on the user's computer (macOS, Windows or Linux). Setup configures every bot profile and turns off the stock - browser and computer_use toolsets in favor of the workspace tools. Watches are propose-only: a proposed + browser toolset in favor of the workspace browser. Desktop input goes only through Hermes's approval-gated + computer_use tool. Watches are propose-only: a proposed watch runs only after the user approves it. maintainer: capthvnsen tier: community category: automation requires_hermes: ">=0.21.5" -docs_url: https://github.com/capthvnsen/alans-way +docs_url: https://github.com/capthvnsen/alans-way-agents/tree/8948c75c7192906e8853afffd1c8d826e52f8206/alans-way readme: true platforms: [linux, macos] known_issues: - "Install this on the machine that runs Hermes (a Linux host or a macOS guest VM), not on the user's primary computer. Windows guests are new and untested on real hardware. If the plugin is already installed from the catalog, setup leaves it as it is, so this pin stays." - - "Setup turns off Hermes's browser and computer_use toolsets for Telegram so the agent uses the workspace tools. Pass --keep-browser or --keep-computer-use to leave them on." + - "Setup turns off Hermes's stock browser toolset for Telegram and cron so the agent uses the workspace browser (pass --keep-browser to leave it on). It never turns off computer_use: on Hermes with the computer-use provider API, desktop input goes through the gated computer_use tool and its alans-way-computer provider." capabilities: provides_tools: - proactive_control From 0e1c490ff66039b143a88b8180daf20b6b0ab36c Mon Sep 17 00:00:00 2001 From: capthvnsen <211575922+capthvnsen@users.noreply.github.com> Date: Wed, 7 Oct 2026 14:58:37 -0600 Subject: [PATCH 88/91] plugin-catalog: pin alans-way and alans-way-computer to 0.6.2 Co-Authored-By: Claude Opus 5.5 (1M context) --- plugin-catalog/alans-way-computer.yaml | 6 +++--- plugin-catalog/alans-way.yaml | 6 +++--- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/plugin-catalog/alans-way-computer.yaml b/plugin-catalog/alans-way-computer.yaml index 77c2c24686..284eb49157 100644 --- a/plugin-catalog/alans-way-computer.yaml +++ b/plugin-catalog/alans-way-computer.yaml @@ -1,8 +1,8 @@ name: alans-way-computer repo: https://github.com/capthvnsen/alans-way-agents -sha: 8948c75c7192906e8853afffd1c8d826e52f8206 +sha: bb7dfc55653c28529dcfd97e73a2c757337f3861 subdir: alans-way-computer -version: "0.6.1" +version: "0.6.2" title: "Alan's Way Computer" description: >- Computer-use provider for Hermes: the stock computer_use tool drives desktop apps on the user's computer @@ -16,7 +16,7 @@ maintainer: capthvnsen tier: community category: tools requires_hermes: ">=0.21.5" -docs_url: https://github.com/capthvnsen/alans-way-agents/tree/8948c75c7192906e8853afffd1c8d826e52f8206/alans-way-computer +docs_url: https://github.com/capthvnsen/alans-way-agents/tree/bb7dfc55653c28529dcfd97e73a2c757337f3861/alans-way-computer readme: true platforms: [linux, macos] known_issues: diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index e5de4d7672..692fdd76fb 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,8 +1,8 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: 8948c75c7192906e8853afffd1c8d826e52f8206 +sha: bb7dfc55653c28529dcfd97e73a2c757337f3861 subdir: alans-way -version: "0.6.1" +version: "0.6.2" title: "Alan's Way" description: >- Proactive primary bot for a Hermes gateway running on a Linux machine or a macOS guest VM. After install, @@ -15,7 +15,7 @@ maintainer: capthvnsen tier: community category: automation requires_hermes: ">=0.21.5" -docs_url: https://github.com/capthvnsen/alans-way-agents/tree/8948c75c7192906e8853afffd1c8d826e52f8206/alans-way +docs_url: https://github.com/capthvnsen/alans-way-agents/tree/bb7dfc55653c28529dcfd97e73a2c757337f3861/alans-way readme: true platforms: [linux, macos] known_issues: From 0ef5a7fc5f46a08aaa666709d21c734c2d9fc6a1 Mon Sep 17 00:00:00 2001 From: capthvnsen Date: Wed, 7 Oct 2026 15:36:49 -0600 Subject: [PATCH 89/91] plugin-catalog: pin alans-way and alans-way-computer to 0.7.0 Co-Authored-By: Claude Opus 5.5 (1M context) --- plugin-catalog/alans-way-computer.yaml | 6 +++--- plugin-catalog/alans-way.yaml | 26 +++++++++++++++----------- 2 files changed, 18 insertions(+), 14 deletions(-) diff --git a/plugin-catalog/alans-way-computer.yaml b/plugin-catalog/alans-way-computer.yaml index 284eb49157..a344f8ac9c 100644 --- a/plugin-catalog/alans-way-computer.yaml +++ b/plugin-catalog/alans-way-computer.yaml @@ -1,8 +1,8 @@ name: alans-way-computer repo: https://github.com/capthvnsen/alans-way-agents -sha: bb7dfc55653c28529dcfd97e73a2c757337f3861 +sha: ce51733b66291e69f616db48ae8799c0de50db43 subdir: alans-way-computer -version: "0.6.2" +version: "0.7.0" title: "Alan's Way Computer" description: >- Computer-use provider for Hermes: the stock computer_use tool drives desktop apps on the user's computer @@ -16,7 +16,7 @@ maintainer: capthvnsen tier: community category: tools requires_hermes: ">=0.21.5" -docs_url: https://github.com/capthvnsen/alans-way-agents/tree/bb7dfc55653c28529dcfd97e73a2c757337f3861/alans-way-computer +docs_url: https://github.com/capthvnsen/alans-way-agents/tree/ce51733b66291e69f616db48ae8799c0de50db43/alans-way-computer readme: true platforms: [linux, macos] known_issues: diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index 692fdd76fb..93853ac13a 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -1,29 +1,33 @@ name: alans-way repo: https://github.com/capthvnsen/alans-way-agents -sha: bb7dfc55653c28529dcfd97e73a2c757337f3861 +sha: ce51733b66291e69f616db48ae8799c0de50db43 subdir: alans-way -version: "0.6.2" +version: "0.7.0" title: "Alan's Way" description: >- - Proactive primary bot for a Hermes gateway running on a Linux machine or a macOS guest VM. After install, - the workspace-setup skill walks that agent through a separate companion app and Tailscale setup on the - user's computer (macOS, Windows or Linux). Setup configures every bot profile and turns off the stock - browser toolset in favor of the workspace browser. Desktop input goes only through Hermes's approval-gated - computer_use tool. Watches are propose-only: a proposed - watch runs only after the user approves it. + Idle check-ins from the primary bot of a Hermes gateway on a Linux machine or a macOS guest VM: when the bound + Telegram chat has been quiet for two hours, during 08:00-22:00 in the user's timezone, the bot checks in once + (does one safe step and reports it, suggests one, or asks one question), backing off when unanswered. The model + tool can only make check-ins quieter; more often, resume and wider hours are operator-only via /proactivity or + the CLI. After install, the workspace-setup skill walks the agent through a separate companion app and Tailscale + setup on the user's computer (macOS, Windows or Linux); desktop input goes only through Hermes's approval-gated + computer_use tool. maintainer: capthvnsen tier: community category: automation requires_hermes: ">=0.21.5" -docs_url: https://github.com/capthvnsen/alans-way-agents/tree/bb7dfc55653c28529dcfd97e73a2c757337f3861/alans-way +docs_url: https://github.com/capthvnsen/alans-way-agents/tree/ce51733b66291e69f616db48ae8799c0de50db43/alans-way readme: true platforms: [linux, macos] known_issues: - "Install this on the machine that runs Hermes (a Linux host or a macOS guest VM), not on the user's primary computer. Windows guests are new and untested on real hardware. If the plugin is already installed from the catalog, setup leaves it as it is, so this pin stays." - "Setup turns off Hermes's stock browser toolset for Telegram and cron so the agent uses the workspace browser (pass --keep-browser to leave it on). It never turns off computer_use: on Hermes with the computer-use provider API, desktop input goes through the gated computer_use tool and its alans-way-computer provider." + - "Check-ins need plugins.entries.alans-way.allow_gateway_injection: true and a bound Telegram DM (setup does both). A background thread checks every 60 seconds once the gateway connects Telegram." capabilities: provides_tools: - - proactive_control - provides_hooks: [] + - proactivity + provides_hooks: + - pre_llm_call + - post_llm_call provides_middleware: [] requires_env: [] From bd92aa1d7fa28c90e7f9266928d6c206602fcfcc Mon Sep 17 00:00:00 2001 From: teknium1 Date: Thu, 8 Oct 2026 02:56:03 -0700 Subject: [PATCH 90/91] chore(catalog): review disclosures for alans-way, alans-way-computer --- plugin-catalog/alans-way-computer.yaml | 9 +-------- plugin-catalog/alans-way.yaml | 9 +-------- 2 files changed, 2 insertions(+), 16 deletions(-) diff --git a/plugin-catalog/alans-way-computer.yaml b/plugin-catalog/alans-way-computer.yaml index a344f8ac9c..43c298c886 100644 --- a/plugin-catalog/alans-way-computer.yaml +++ b/plugin-catalog/alans-way-computer.yaml @@ -4,14 +4,7 @@ sha: ce51733b66291e69f616db48ae8799c0de50db43 subdir: alans-way-computer version: "0.7.0" title: "Alan's Way Computer" -description: >- - Computer-use provider for Hermes: the stock computer_use tool drives desktop apps on the user's computer - through the Alan's Way app, and on the VM's own desktop when the computer is offline. Needs the alans-way - plugin's workspace setup. Select it with computer_use.backend: alans-way-computer. - Disclosure: starts the workspace router from the profile's workspace_browser MCP block as a long-running - node child and talks to it over stdio (app screenshots, element lists and input actions); the router reaches the - user's computer over SSH on the user's tailnet. It never takes the focused window, and Hermes's computer_use - approval gate is unchanged. +description: "Computer-use provider for Hermes: the stock computer_use tool drives desktop apps on the user's computer through the Alan's Way app, and on the VM's own desktop when the computer is offline. Needs the alans-way plugin's workspace setup. Select it with computer_use.backend: alans-way-computer. Disclosure — starts the workspace router from the profile's mcp_servers.workspace_browser block (command and args from config.yaml, with a filtered environment plus HERMES_WORKSPACE_ALLOW_DESKTOP_ACTIONS=1, which lets this private router child serve desktop input) as a long-running node child per session. It talks to the router over stdio (app lists, element trees, screenshots and input actions). The router reaches the user's computer over SSH on the user's tailnet and falls back to the VM's desktop. The provider never takes the focused window, and every input action still goes through Hermes's computer_use approval gate (cua:*:background entries in command_allowlist, which alans-way's --allow-desktop-actions adds, skip the prompt). On Hermes 0.21.5, which has no provider API, it installs and does nothing." maintainer: capthvnsen tier: community category: tools diff --git a/plugin-catalog/alans-way.yaml b/plugin-catalog/alans-way.yaml index 93853ac13a..38595ba9a3 100644 --- a/plugin-catalog/alans-way.yaml +++ b/plugin-catalog/alans-way.yaml @@ -4,14 +4,7 @@ sha: ce51733b66291e69f616db48ae8799c0de50db43 subdir: alans-way version: "0.7.0" title: "Alan's Way" -description: >- - Idle check-ins from the primary bot of a Hermes gateway on a Linux machine or a macOS guest VM: when the bound - Telegram chat has been quiet for two hours, during 08:00-22:00 in the user's timezone, the bot checks in once - (does one safe step and reports it, suggests one, or asks one question), backing off when unanswered. The model - tool can only make check-ins quieter; more often, resume and wider hours are operator-only via /proactivity or - the CLI. After install, the workspace-setup skill walks the agent through a separate companion app and Tailscale - setup on the user's computer (macOS, Windows or Linux); desktop input goes only through Hermes's approval-gated - computer_use tool. +description: "Idle check-ins from the primary bot of a Hermes gateway on a Linux machine or a macOS guest VM: when the bound Telegram chat has been quiet for two hours, during 08:00-22:00 in the user's timezone, the bot checks in once (does one safe step and reports it, suggests one, or asks one question), backing off when unanswered. The model tool can only make check-ins quieter; more often, resume and wider hours are operator-only via /proactivity or the CLI. After install, the workspace-setup skill walks the agent through a separate companion app and Tailscale setup on the user's computer (macOS, Windows or Linux); desktop input goes only through Hermes's approval-gated computer_use tool. Disclosure — once the gateway connects Telegram, a background thread checks every 60 seconds. When the bound Telegram DM has been quiet (2 h by default, doubling per unanswered check-in, 08:00-22:00 user time), it injects an internal user-role prompt into that chat (needs plugins.entries.alans-way.allow_gateway_injection, which setup sets), so the bot runs a turn on its own and may take one \"safe, reversible\" step; the user still approves tool calls in Telegram. Its pre_llm_call/post_llm_call hooks see every session's turns and store only the bound chat's timestamps in plugin state. On first load it reads $HERMES_HOME/companion/proactivity/proactivity.sqlite3 once, read-only. The workspace-setup skill has the agent clone this repo at the catalog pin and run setup.sh, which: installs long-running services (Linux systemd units hermes-alans-way-chromium/-browser with loginctl enable-linger and a mac-watch.service with Restart=always; a KeepAlive LaunchAgent on a macOS guest; logon Scheduled Tasks on Windows); adds a TimeoutStartSec=180 drop-in to the hermes-gateway unit and restarts the gateway from a transient systemd-run timer; appends the user's computer's public key to ~/.ssh/authorized_keys (administrators_authorized_keys on a Windows admin account), pins its host key in known_hosts and adds a ControlMaster block to ~/.ssh/config, for Tailscale hosts only; for the main profile and every profile with its own Telegram bot, writes a managed mcp_servers.workspace_browser block (removing other entries that run this router, with a backup), turns off the built-in browser toolset for Telegram and cron, and turns computer_use back on for Telegram and cron; and reads each profile's TELEGRAM_BOT_TOKEN only to derive the numeric bot id. The workspace router reaches the user's computer over SSH on their tailnet. The companion setup page has the human run the alans-way connect script from its main branch on their own computer, and the agent may install Tailscale with its official install script. Desktop input goes through Hermes's approval-gated computer_use tool. The manual --allow-desktop-actions setup flag, which the skill offers but never adds itself, adds cua:*:background entries to command_allowlist. On a Hermes without the computer-use provider API, including 0.21.5, it also exposes workspace_computer_action, which drives the user's desktop, Terminal included, with no approval." maintainer: capthvnsen tier: community category: automation From f549953a38f7648391932c1aa072e4304a66055e Mon Sep 17 00:00:00 2001 From: teknium1 Date: Thu, 8 Oct 2026 02:56:09 -0700 Subject: [PATCH 91/91] chore: map contributor email for capthvnsen --- contributors/emails/alex@funnelsforfounders.com | 1 + 1 file changed, 1 insertion(+) create mode 100644 contributors/emails/alex@funnelsforfounders.com diff --git a/contributors/emails/alex@funnelsforfounders.com b/contributors/emails/alex@funnelsforfounders.com new file mode 100644 index 0000000000..954cd98383 --- /dev/null +++ b/contributors/emails/alex@funnelsforfounders.com @@ -0,0 +1 @@ +capthvnsen