set-prompt 0.8.2 → 0.8.3

package/CHANGELOG.md

@@ -4,6 +4,19 @@ 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
@@ -16,7 +29,7 @@ All notable changes to this project will be documented in this file.
 - **`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 `✓ set-prompt v1.0` and skills become loadable via `skill_view("set-prompt:<name>")` (plugin skills are opt-in explicit loads — they do not appear in Hermes's auto-listed `available_skills` index).
+- 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.
 
 ---

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). **Plugin skills are opt-in explicit loads** — they do not appear in Hermes's auto-listed `available_skills` index; load them via `skill_view("set-prompt:<name>")`. 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(name, Path(SKILL.md))\` at Hermes startup. The skill directory layout is the same as other platforms \u2014 no nested category folder. **Plugin skills are opt-in explicit loads** \u2014 they do not appear in Hermes's auto-listed \`available_skills\` index; load via \`skill_view("set-prompt:<skill-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/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 |
 |-------|----------|----------|-------------|
@@ -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
 `;
@@ -2645,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");
@@ -2707,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;
@@ -2719,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;
@@ -2731,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();
@@ -2759,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}`));
   }
@@ -2787,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.2",
+    "version": "0.8.3",
     "description": "One repo. Every AI coding tool. Always in sync.",
     "main": "dist/index.js",
     "bin": {