set-prompt 0.8.1 → 0.8.3

package/CHANGELOG.md

@@ -4,6 +4,36 @@ All notable changes to this project will be documented in this file.
 
 ---
 
+## [0.8.3] - 2026-05-02
+
+### Changed
+- **Hermes plugin renamed `set-prompt` → `sppt`** for ergonomics. Plugin skills are loaded via `skill_view("sppt:<name>")` instead of the longer `skill_view("set-prompt:<name>")`. Internally aligned with the rest of set-prompt where every other agent already uses `PLUGIN_NAME = "sppt"` as the plugin identifier (Claude Code, Codex, etc.) — Hermes was the lone outlier still using `MARKET_NAME = "set-prompt"`.
+  - Plugin directory: `~/.hermes/plugins/set-prompt/` → `~/.hermes/plugins/sppt/`
+  - `plugin.yaml` `name`: `set-prompt` → `sppt`
+  - `~/.hermes/config.yaml` `plugins.enabled` entry: `- set-prompt` → `- sppt`
+
+### Added
+- **Post-link guidance** — `set-prompt link hermes` now prints a hint explaining that plugin skills don't appear in `/skills list` (Hermes policy) and shows the explicit qualified-load form: `skill_view("sppt:<skill-name>")`. This addresses the common confusion of "the link succeeded but my skills aren't showing up" — they're registered, just opt-in via qualified namespace as documented by Hermes.
+
+---
+
+## [0.8.2] - 2026-05-02
+
+### Fixed
+- **Hermes `register_skill` argument types** — fixed `'str' object has no attribute 'exists'` error that surfaced after enabling the plugin in Hermes. The generated `__init__.py` was passing `str(skill_path)` (the skill directory as a string), but Hermes's `ctx.register_skill(name, path)` expects:
+  1. A `pathlib.Path` object (not a string)
+  2. The path to `SKILL.md` itself (not the parent directory)
+  Verified against the official "Build a Hermes plugin" guide example. Now passes `skill_path / "SKILL.md"` as a `Path`.
+- **Hermes command handler signature** — handler is now defined as `handler(raw_args: str = "") -> Optional[str]` matching the documented Hermes signature (previously `handler(_args=None)`).
+- **Slash commands silent in gateway/TUI mode** — `ctx.inject_message()` is documented as **CLI-mode only** (returns `False` in gateway mode). The handler now falls back to **returning the markdown body** as the command's response when `inject_message` is unavailable, so the content is still visible to the user instead of being silently dropped.
+- **`register_command` now uses keyword arguments** (`handler=`, `description=`) to match the official Hermes plugin examples (e.g. `disk-cleanup`) and stay robust if Hermes reorders positional parameters.
+
+### Notes
+- After upgrading, re-run `set-prompt link hermes` to regenerate `__init__.py`, then restart Hermes. The plugin should now load with `✓ sppt v1.0` (renamed from `set-prompt` in 0.8.3) and skills become loadable via `skill_view("sppt:<name>")` (plugin skills are opt-in explicit loads — they do not appear in Hermes's auto-listed `available_skills` index).
+- Hook callbacks remain `def runner(*args, **kwargs)` — Hermes documents that all hook callbacks should accept `**kwargs` for forward compatibility, and the bridge's role is purely to forward the payload to the user-defined hook command via stdin JSON.
+
+---
+
 ## [0.8.1] - 2026-05-02
 
 ### Changed

package/README.md

@@ -109,7 +109,7 @@ The interactive mode shows all agents with their current state. **Check to link,
 | Cursor | dir symlinks into `~/.cursor/` | `skills/`, `agents/`, `commands/`, `hooks/`, `mcp.json` (hardlink) |
 | OpenCode | dir symlinks into `~/.config/opencode/` | `skills/`, `commands/`, `agents/` |
 | Gemini CLI | dir symlinks into `~/.gemini/` | `skills/`, `commands/`, `agents/` |
-| Hermes | Python plugin adapter at `~/.hermes/plugins/set-prompt/` | `skills/`, `commands/`, `hooks/hooks.json` (read directly from repo at startup) |
+| Hermes | Python plugin adapter at `~/.hermes/plugins/sppt/` | `skills/`, `commands/`, `hooks/hooks.json` (read directly from repo at startup) |
 
 > **Note on Claude Code**: Operates as a plugin. Restart Claude Code after linking for the plugin to be recognized.
 
@@ -123,7 +123,7 @@ The interactive mode shows all agents with their current state. **Check to link,
 
 > **Note on Gemini CLI**: Skills follow the standard `skills/<name>/SKILL.md` pattern. Commands use `.toml` format (not `.md`) and agents use `.md` with YAML frontmatter. Files in your repo's `commands/` must be TOML for Gemini CLI to recognize them. **Agents have strict frontmatter validation** — unknown keys (e.g. `allowed-tools`, `color`, `mode` from other platforms) cause Gemini CLI to reject the agent. See `SET_PROMPT_GUIDE.md` for the allowed keys.
 
-> **Note on Hermes**: Hermes plugins must register skills/commands/hooks programmatically — directory drop-ins are not auto-discovered. set-prompt generates a small Python adapter (`~/.hermes/plugins/set-prompt/__init__.py`) with the repo's absolute path baked in, so no symlinks are needed. **Restart Hermes after `link` (or after adding/removing a skill in your repo)** — `register()` runs only once at Hermes startup. Activation requires `set-prompt` listed under `plugins.enabled` in `~/.hermes/config.yaml` — set-prompt writes this entry automatically (creating the file when absent, or appending to the existing list while preserving other entries and comments via AST-based YAML editing with backup/rollback). Hooks are observation-only on the Hermes side: the same `hooks/hooks.json` is reused, but Hermes events (`pre_tool_call`, `on_session_start`, etc.) are picked up while Claude/Cursor keys are ignored. Hook scripts can reference `${SET_PROMPT_REPO}`.
+> **Note on Hermes**: Hermes plugins must register skills/commands/hooks programmatically — directory drop-ins are not auto-discovered. set-prompt generates a small Python adapter (`~/.hermes/plugins/sppt/__init__.py`) with the repo's absolute path baked in, so no symlinks are needed. **Restart Hermes after `link` (or after adding/removing a skill in your repo)** — `register()` runs only once at Hermes startup. Activation requires `sppt` listed under `plugins.enabled` in `~/.hermes/config.yaml` — set-prompt writes this entry automatically (creating the file when absent, or appending to the existing list while preserving other entries and comments via AST-based YAML editing with backup/rollback). **Plugin skills don't appear in `/skills list`** (Hermes policy — plugin skills are opt-in explicit loads, not part of the auto-listed `available_skills` index). Load them with the qualified namespace: `skill_view("sppt:<name>")` — e.g. `skill_view("sppt:dev-base")`. Hooks are observation-only on the Hermes side: the same `hooks/hooks.json` is reused, but Hermes events (`pre_tool_call`, `on_session_start`, etc.) are picked up while Claude/Cursor keys are ignored. Hook scripts can reference `${SET_PROMPT_REPO}`.
 
 ---
 
@@ -237,8 +237,8 @@ set-prompt uninstall
 └── antigravity/                (Antigravity's own subtree, unrelated)
 
 ~/.hermes/                   # Hermes (Python plugin adapter, no symlinks)
-├── config.yaml              # plugins.enabled: [set-prompt]  (created if absent)
-└── plugins/set-prompt/
+├── config.yaml              # plugins.enabled: [sppt]  (created if absent)
+└── plugins/sppt/
     ├── plugin.yaml          # Hermes manifest
     └── __init__.py          # REPO_DIR baked in; reads <repo>/{skills,commands,hooks/hooks.json} at startup
 ```
@@ -255,7 +255,7 @@ set-prompt uninstall
 - **Cursor** — replaces directories and `mcp.json` in `~/.cursor/`
 - **OpenCode** — replaces directories in `~/.config/opencode/`
 - **Gemini CLI** — replaces directories in `~/.gemini/` (`antigravity/` subtree untouched)
-- **Hermes** — generates `~/.hermes/plugins/set-prompt/{plugin.yaml, __init__.py}` and adds `set-prompt` to `~/.hermes/config.yaml` under `plugins.enabled` (creates the file when absent; appends to the existing list while preserving other entries and comments)
+- **Hermes** — generates `~/.hermes/plugins/sppt/{plugin.yaml, __init__.py}` and adds `sppt` to `~/.hermes/config.yaml` under `plugins.enabled` (creates the file when absent; appends to the existing list while preserving other entries and comments)
 
 Before making any changes, `set-prompt` creates a backup and rolls back automatically on failure. However, you should be aware that:
 

package/dist/index.js

@@ -39,7 +39,7 @@ var OPENCODE_BACKUP_DIR = path.join(OPENCODE_DIR, "SET_PROMPT_BACKUP");
 var GEMINICLI_DIR = path.join(os.homedir(), ".gemini");
 var GEMINICLI_BACKUP_DIR = path.join(GEMINICLI_DIR, "SET_PROMPT_BACKUP");
 var HERMES_DIR = path.join(os.homedir(), ".hermes");
-var HERMES_PLUGIN_DIR = path.join(HERMES_DIR, "plugins", MARKET_NAME);
+var HERMES_PLUGIN_DIR = path.join(HERMES_DIR, "plugins", PLUGIN_NAME);
 var HERMES_CONFIG_PATH = path.join(HERMES_DIR, "config.yaml");
 var PROMPT_DIR_NAMES = ["skills", "commands", "hooks", "agents", "rules"];
 var AGENT_PROMPT_DIRS = {
@@ -549,7 +549,7 @@ required_environment_variables:
 
 > **Gemini CLI note**: Only \`name\` and \`description\` are recognized. \`name\` must be lowercase with hyphens and match the directory name.
 
-> **Hermes note (set-prompt integration)**: Hermes does not auto-discover files in standard directories \u2014 plugins must register skills programmatically. set-prompt generates \`~/.hermes/plugins/set-prompt/{plugin.yaml, __init__.py}\` on \`set-prompt link hermes\`. The \`__init__.py\` reads \`<repo>/skills/<skill-name>/SKILL.md\` directly (REPO_DIR is baked in at link time) and calls \`ctx.register_skill()\` at Hermes startup. The skill directory layout is the same as other platforms \u2014 no nested category folder.
+> **Hermes note (set-prompt integration)**: Hermes does not auto-discover files in standard directories \u2014 plugins must register skills programmatically. set-prompt generates \`~/.hermes/plugins/sppt/{plugin.yaml, __init__.py}\` on \`set-prompt link hermes\`. The \`__init__.py\` reads \`<repo>/skills/<skill-name>/SKILL.md\` directly (REPO_DIR is baked in at link time) and calls \`ctx.register_skill(name, Path(SKILL.md))\` at Hermes startup. The skill directory layout is the same as other platforms \u2014 no nested category folder. **Plugin skills don't appear in \`/skills list\`** (Hermes policy \u2014 plugin skills are opt-in explicit loads). Load with the qualified namespace: \`skill_view("sppt:<skill-name>")\` \u2014 e.g. \`skill_view("sppt:dev-base")\`.
 
 | Field | Required | Platform | Description |
 |-------|----------|----------|-------------|
@@ -659,7 +659,7 @@ Include: 1) Refactored code. 2) Explanation of changes.
 
 #### Hermes commands (set-prompt integration)
 
-Hermes commands are registered programmatically. set-prompt's generated \`__init__.py\` walks \`<repo>/commands/*.md\`, parses each file's YAML frontmatter for \`name\` / \`description\`, and calls \`ctx.register_command(name, handler, description)\`. The handler injects the markdown body as a user message via \`ctx.inject_message(body, role="user")\` when the user invokes the slash command. Hermes does **not** read \`allowed-tools\`, \`model\`, \`agent\`, or other platform-specific frontmatter \u2014 only \`name\` and \`description\` are honored.
+Hermes commands are registered programmatically. set-prompt's generated \`__init__.py\` walks \`<repo>/commands/*.md\`, parses each file's YAML frontmatter for \`name\` / \`description\`, and calls \`ctx.register_command(name, handler=..., description=...)\`. The handler tries to inject the markdown body as a user message via \`ctx.inject_message(body, role="user")\` when the slash command is invoked. **\`inject_message\` is CLI-mode only** \u2014 in gateway/TUI mode it returns \`False\`, and the handler falls back to **returning the body** as the command's response so the content is still visible. Hermes does **not** read \`allowed-tools\`, \`model\`, \`agent\`, or other platform-specific frontmatter \u2014 only \`name\` and \`description\` are honored.
 
 | Field | Required | Platform | Description |
 |-------|----------|----------|-------------|
@@ -2491,7 +2491,7 @@ import fs13 from "fs";
 import chalk14 from "chalk";
 import { confirm as confirm11 } from "@inquirer/prompts";
 import YAML from "yaml";
-var PLUGIN_YAML = `name: ${MARKET_NAME}
+var PLUGIN_YAML = `name: ${PLUGIN_NAME}
 version: "1.0"
 description: Managed by set-prompt
 `;
@@ -2537,8 +2537,18 @@ def _parse_frontmatter(text):
 
 
 def _make_command_handler(ctx, body):
-    def handler(_args=None):
-        ctx.inject_message(body, role="user")
+    # Hermes calls handlers as handler(raw_args: str) -> Optional[str].
+    # Primary path: inject the markdown body as a user message (CLI mode).
+    # Fallback: in gateway mode inject_message returns False \u2014 return the body
+    # as the handler response so the content is at least visible to the user.
+    def handler(raw_args=""):
+        try:
+            ok = ctx.inject_message(body, role="user")
+        except Exception:
+            ok = False
+        if not ok:
+            return body
+        return None
     return handler
 
 
@@ -2607,9 +2617,11 @@ def register(ctx):
         for skill_path in sorted(skills_dir.iterdir()):
             if not skill_path.is_dir():
                 continue
-            if not (skill_path / "SKILL.md").exists():
+            skill_md = skill_path / "SKILL.md"
+            if not skill_md.exists():
                 continue
-            ctx.register_skill(skill_path.name, str(skill_path))
+            # Hermes expects (name, Path-to-SKILL.md), not (name, dir-as-str).
+            ctx.register_skill(skill_path.name, skill_md)
 
     commands_dir = REPO_DIR / "commands"
     if commands_dir.exists():
@@ -2621,7 +2633,11 @@ def register(ctx):
             meta, body = _parse_frontmatter(text)
             name = meta.get("name") or cmd_file.stem
             description = meta.get("description") or ""
-            ctx.register_command(name, _make_command_handler(ctx, body), description)
+            ctx.register_command(
+                name,
+                handler=_make_command_handler(ctx, body),
+                description=description,
+            )
 
     _register_hooks(ctx)
 `;
@@ -2629,7 +2645,7 @@ def register(ctx):
 var FRESH_CONFIG_YAML = `# Generated by set-prompt
 plugins:
   enabled:
-    - ${MARKET_NAME}
+    - ${PLUGIN_NAME}
 `;
 var writePluginManifest = (repoPath) => {
   fs13.writeFileSync(path12.join(HERMES_PLUGIN_DIR, "plugin.yaml"), PLUGIN_YAML, "utf-8");
@@ -2691,7 +2707,7 @@ var ensureHermesConfigEnabled = () => {
   }
   let plugins = doc.get("plugins");
   if (plugins == null) {
-    doc.set("plugins", doc.createNode({ enabled: [MARKET_NAME] }));
+    doc.set("plugins", doc.createNode({ enabled: [PLUGIN_NAME] }));
     writeWithBackup(HERMES_CONFIG_PATH, String(doc));
     console.log(chalk14.green("  \u2713 ") + chalk14.dim(`added plugins.enabled to ${HERMES_CONFIG_PATH}`));
     return;
@@ -2703,7 +2719,7 @@ var ensureHermesConfigEnabled = () => {
   }
   let enabled = plugins.get("enabled");
   if (enabled == null) {
-    plugins.set("enabled", doc.createNode([MARKET_NAME]));
+    plugins.set("enabled", doc.createNode([PLUGIN_NAME]));
     writeWithBackup(HERMES_CONFIG_PATH, String(doc));
     console.log(chalk14.green("  \u2713 ") + chalk14.dim(`added plugins.enabled to ${HERMES_CONFIG_PATH}`));
     return;
@@ -2715,15 +2731,15 @@ var ensureHermesConfigEnabled = () => {
   }
   const alreadyListed = enabled.items.some((item) => {
     const v = YAML.isScalar(item) ? item.value : item;
-    return v === MARKET_NAME;
+    return v === PLUGIN_NAME;
   });
   if (alreadyListed) {
-    console.log(chalk14.dim(`  \u2713 ${MARKET_NAME} already listed in ${HERMES_CONFIG_PATH}`));
+    console.log(chalk14.dim(`  \u2713 ${PLUGIN_NAME} already listed in ${HERMES_CONFIG_PATH}`));
     return;
   }
-  enabled.add(MARKET_NAME);
+  enabled.add(PLUGIN_NAME);
   writeWithBackup(HERMES_CONFIG_PATH, String(doc));
-  console.log(chalk14.green("  \u2713 ") + chalk14.dim(`enabled "${MARKET_NAME}" in ${HERMES_CONFIG_PATH}`));
+  console.log(chalk14.green("  \u2713 ") + chalk14.dim(`enabled "${PLUGIN_NAME}" in ${HERMES_CONFIG_PATH}`));
 };
 var linkHermes = async () => {
   const repoPath = resolveRepoPath();
@@ -2743,6 +2759,8 @@ Setting up Hermes plugin...`));
     configManager.save();
     console.log(chalk14.dim(`
   \u2139 Hermes loads plugins at startup \u2014 restart Hermes to pick up new skills/commands.`));
+    console.log(chalk14.dim(`  \u2139 Plugin skills don't appear in /skills list (Hermes policy).`));
+    console.log(chalk14.dim(`     Load explicitly: `) + chalk14.cyan(`skill_view("${PLUGIN_NAME}:<skill-name>")`) + chalk14.dim(` \u2014 e.g. `) + chalk14.cyan(`skill_view("${PLUGIN_NAME}:dev-base")`));
   } catch (ex) {
     console.error(chalk14.red(`\u274C Failed to set up Hermes plugin: ${ex.message}`));
   }
@@ -2771,42 +2789,46 @@ Removing Hermes plugin...`));
       fs13.unlinkSync(HERMES_CONFIG_PATH);
       console.log(chalk14.red("  removed") + chalk14.dim(`: ${HERMES_CONFIG_PATH}`));
     } else {
-      removeMarketEntryFromConfig();
+      removeEntryFromConfig(PLUGIN_NAME);
     }
   }
   configManager.hermes = null;
   configManager.save();
 };
-var removeMarketEntryFromConfig = () => {
+var removeEntryFromConfig = (entryName) => {
+  if (fs13.existsSync(HERMES_CONFIG_PATH) === false) {
+    return false;
+  }
   const content = fs13.readFileSync(HERMES_CONFIG_PATH, "utf-8");
   let doc;
   try {
     doc = YAML.parseDocument(content);
   } catch (ex) {
     console.warn(chalk14.yellow(`  \u26A0 Failed to parse Hermes config (${ex.message}) \u2014 leaving file untouched.`));
-    return;
+    return false;
   }
   if (doc.errors.length > 0) {
-    return;
+    return false;
   }
   const plugins = doc.get("plugins");
   if (!YAML.isMap(plugins)) {
-    return;
+    return false;
   }
   const enabled = plugins.get("enabled");
   if (!YAML.isSeq(enabled)) {
-    return;
+    return false;
   }
   const idx = enabled.items.findIndex((item) => {
     const v = YAML.isScalar(item) ? item.value : item;
-    return v === MARKET_NAME;
+    return v === entryName;
   });
   if (idx === -1) {
-    return;
+    return false;
   }
   enabled.delete(idx);
   writeWithBackup(HERMES_CONFIG_PATH, String(doc));
-  console.log(chalk14.red("  removed") + chalk14.dim(` "${MARKET_NAME}" from: ${HERMES_CONFIG_PATH}`));
+  console.log(chalk14.red("  removed") + chalk14.dim(` "${entryName}" from: ${HERMES_CONFIG_PATH}`));
+  return true;
 };
 
 // src/commands/link-command.ts

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "set-prompt",
-    "version": "0.8.1",
+    "version": "0.8.3",
     "description": "One repo. Every AI coding tool. Always in sync.",
     "main": "dist/index.js",
     "bin": {
@@ -31,7 +31,8 @@
         "cursor",
         "codex",
         "opencode",
-        "gemini-cli"
+        "gemini-cli",
+        "hermes"
     ],
     "author": "juncha9 (https://github.com/juncha9)",
     "license": "MIT",