set-prompt 0.7.1 → 0.8.1

package/CHANGELOG.md

@@ -4,6 +4,52 @@ All notable changes to this project will be documented in this file.
 
 ---
 
+## [0.8.1] - 2026-05-02
+
+### Changed
+- **Hermes auto-enable** — `link hermes` now writes `set-prompt` into the existing `~/.hermes/config.yaml` automatically, matching Claude Code / Codex behavior. Previously the file was left untouched and only a manual-merge snippet was printed, which left the plugin detected-but-disabled (`× set-prompt — not enabled in config`).
+  - Existing `plugins.enabled` list → `set-prompt` is appended (other entries preserved).
+  - `plugins` map exists but no `enabled` key → `enabled: [set-prompt]` is added.
+  - `plugins` key missing entirely → `plugins.enabled: [set-prompt]` is added.
+  - YAML comments and formatting are preserved (AST-based modification via `yaml` package).
+  - Atomic write with timestamped backup + rollback on failure (same pattern as `link claudecode` / `link codex`).
+- **`unlinkHermes` surgical removal** — for user-authored `config.yaml` (no `# Generated by set-prompt` header), only the `- set-prompt` entry is removed; the rest of the file is preserved. Auto-generated configs are still deleted whole.
+
+### Added
+- `yaml` (eemeli/yaml) dependency for AST-based YAML editing.
+- Tests for the new auto-enable branches: `plugins` key absent, `plugins.enabled` absent, comment preservation, and `unlinkHermes` surgical removal (17 cases total in `link-hermes.test.ts`).
+
+---
+
+## [0.8.0] - 2026-05-02
+
+### Added
+- **Hermes integration** (`link hermes`) — generates a Hermes plugin at `~/.hermes/plugins/set-prompt/` that loads skills, commands, and hooks directly from the registered prompt repo at Hermes startup
+  - `plugin.yaml` — Hermes plugin manifest (`name`, `version`, `description`)
+  - `__init__.py` — Python adapter generated at link time. The repo's absolute path is baked into a `REPO_DIR` constant (JSON-encoded for Windows-safe backslash handling), so no symlinks are required. At Hermes startup, `register(ctx)` walks `<repo>/skills/<name>/SKILL.md` for `ctx.register_skill()`, `<repo>/commands/*.md` for `ctx.register_command()` (handler injects the markdown body via `ctx.inject_message()`), and `<repo>/hooks/hooks.json` for `ctx.register_hook()`.
+  - Shared `hooks.json` strategy — the same `hooks/hooks.json` used by Claude Code/Cursor is reused. Only Hermes-native event keys (`pre_tool_call`, `post_tool_call`, `pre_llm_call`, `post_llm_call`, `on_session_start`, `on_session_end`, `on_session_finalize`, `on_session_reset`, `subagent_stop`, `pre_gateway_dispatch`) are picked up; other tools' keys are ignored, so a single file can drive multiple platforms.
+  - Hook command substitution: `${SET_PROMPT_REPO}` token + `SET_PROMPT_REPO` env var. Hermes hook callbacks receive a JSON payload on stdin: `{"event": "<event>", "args": [...], "kwargs": {...}}`.
+  - `~/.hermes/config.yaml` activation — created with `plugins.enabled: [set-prompt]` if absent. Existing files are never auto-modified; if `set-prompt` is missing from `enabled`, set-prompt prints the snippet for manual merge.
+- `HermesConfigSchema` + `HermesConfig` type + `configManager.hermes` getter/setter + `isHermesEnabled()`
+- `HERMES_DIR`, `HERMES_PLUGIN_DIR`, `HERMES_CONFIG_PATH` constants in `_defs`
+- `linkHermes()` / `unlinkHermes()` in `src/link/hermes.ts`
+- `SET_PROMPT_GUIDE` template: Hermes commands/hooks integration sections (set-prompt's adapter behavior, event whitelist table, payload format, decision-control caveat)
+- Tests: `tests/commands/link-hermes.test.ts` (11 cases — REPO_DIR baking, Windows backslash JSON encoding, no-symlink assertion, three config.yaml branches, unlink behavior with auto-generated vs user-authored config)
+
+### Changed
+- `status-command.ts` — added missing branches for Cursor / OpenCode / Gemini CLI / Hermes (previously fell through silently after Antigravity)
+- `uninstall-command.ts` — added missing unlink calls for OpenCode / Gemini CLI in addition to Hermes
+- `link-command.ts` description in `index.ts` — agent list extended with `hermes`
+- Test mocks updated across `link-command`, `status-command`, `uninstall-command` to cover all current `is*Enabled()` predicates and `unlink*` exports
+
+### Notes / Caveats
+- **Hermes loads plugins once at startup** — `register(ctx)` is called exactly once. Add/remove a skill, command, or hook in your repo and Hermes must be restarted to pick it up. Other tools' auto-discovery is not available here.
+- **Hermes hooks are observation-only via this bridge** — block/allow decision semantics are not propagated back to Hermes. Use platform-native hooks if you need to gate tool calls.
+- **Hermes does not auto-modify `~/.hermes/config.yaml`** — to avoid clobbering memory-provider / context-engine selections, set-prompt only writes the file when it's absent. Existing files are read-only; the user is asked to add `- set-prompt` under `plugins.enabled` manually if missing.
+- **`AGENT_PROMPT_DIRS[HERMES]` is empty** — Hermes intentionally does **not** symlink directories. The Python adapter reads from `REPO_DIR` directly, sidestepping Windows symlink/junction permission edge cases.
+
+---
+
 ## [0.7.1] - 2026-04-20
 
 ### Changed

package/README.md

@@ -94,6 +94,7 @@ set-prompt link antigravity  # link Antigravity only
 set-prompt link cursor       # link Cursor only
 set-prompt link opencode     # link OpenCode only
 set-prompt link geminicli    # link Gemini CLI only
+set-prompt link hermes       # link Hermes only
 ```
 
 The interactive mode shows all agents with their current state. **Check to link, uncheck to unlink** — existing directories are backed up before being replaced.
@@ -108,6 +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) |
 
 > **Note on Claude Code**: Operates as a plugin. Restart Claude Code after linking for the plugin to be recognized.
 
@@ -121,6 +123,8 @@ 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}`.
+
 ---
 
 ### Step 3 — Keep in sync
@@ -143,7 +147,7 @@ set-prompt repo path                  # print repo location (e.g. cd "$(sppt rep
 set-prompt repo open                  # open repo in OS file manager (--code VSCode, --stree Sourcetree)
 ```
 
-Symlink-based agents (Claude Code, Codex, RooCode, OpenClaw, Antigravity, OpenCode, Gemini CLI) reflect changes immediately after pull. Cursor's `mcp.json` is a hardlink to repo's `.mcp.json`, so edits to either side are reflected automatically.
+Symlink-based agents (Claude Code, Codex, RooCode, OpenClaw, Antigravity, OpenCode, Gemini CLI) reflect changes immediately after pull. Cursor's `mcp.json` is a hardlink to repo's `.mcp.json`, so edits to either side are reflected automatically. **Hermes** is the exception — its Python adapter only re-scans the repo at process startup, so restart Hermes after pulling new content.
 
 ---
 
@@ -231,6 +235,12 @@ set-prompt uninstall
 ├── commands/ → repo/commands   (Gemini reads *.toml)
 ├── agents/ → repo/agents       (Gemini reads *.md)
 └── 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/
+    ├── plugin.yaml          # Hermes manifest
+    └── __init__.py          # REPO_DIR baked in; reads <repo>/{skills,commands,hooks/hooks.json} at startup
 ```
 
 ## Warning
@@ -245,6 +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)
 
 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

@@ -2,10 +2,10 @@
 
 // src/index.ts
 import { Command } from "commander";
-import chalk23 from "chalk";
+import chalk24 from "chalk";
 import figlet from "figlet";
-import fs14 from "fs";
-import path13 from "path";
+import fs15 from "fs";
+import path14 from "path";
 import { fileURLToPath } from "url";
 
 // src/commands/install-command.ts
@@ -38,6 +38,9 @@ var OPENCODE_DIR = path.join(os.homedir(), ".config", "opencode");
 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_CONFIG_PATH = path.join(HERMES_DIR, "config.yaml");
 var PROMPT_DIR_NAMES = ["skills", "commands", "hooks", "agents", "rules"];
 var AGENT_PROMPT_DIRS = {
   ["claudecode" /* CLAUDECODE */]: ["skills", "commands", "hooks", "agents"],
@@ -47,7 +50,8 @@ var AGENT_PROMPT_DIRS = {
   ["antigravity" /* ANTIGRAVITY */]: ["skills"],
   ["cursor" /* CURSOR */]: ["skills", "agents", "commands", "hooks"],
   ["opencode" /* OPENCODE */]: ["skills", "commands", "agents"],
-  ["geminicli" /* GEMINICLI */]: ["skills", "commands", "agents"]
+  ["geminicli" /* GEMINICLI */]: ["skills", "commands", "agents"],
+  ["hermes" /* HERMES */]: []
 };
 var ALL_AGENTS = [
   { name: "Claude Code", value: "claudecode" /* CLAUDECODE */ },
@@ -57,7 +61,8 @@ var ALL_AGENTS = [
   { name: "Antigravity", value: "antigravity" /* ANTIGRAVITY */ },
   { name: "Cursor", value: "cursor" /* CURSOR */ },
   { name: "OpenCode", value: "opencode" /* OPENCODE */ },
-  { name: "Gemini CLI", value: "geminicli" /* GEMINICLI */ }
+  { name: "Gemini CLI", value: "geminicli" /* GEMINICLI */ },
+  { name: "Hermes", value: "hermes" /* HERMES */ }
 ];
 
 // src/_libs/config.ts
@@ -99,6 +104,9 @@ var GeminicliConfigSchema = z.object({
   path: z.string().nullable(),
   backup_path: z.string().nullish().optional()
 });
+var HermesConfigSchema = z.object({
+  path: z.string().nullable()
+});
 var GlobalConfigSchema = z.object({
   repo_path: z.string(),
   remote_url: z.string().nullable(),
@@ -109,7 +117,8 @@ var GlobalConfigSchema = z.object({
   antigravity: AntigravityConfigSchema.nullish().optional(),
   cursor: CursorConfigSchema.nullish().optional(),
   opencode: OpencodeConfigSchema.nullish().optional(),
-  geminicli: GeminicliConfigSchema.nullish().optional()
+  geminicli: GeminicliConfigSchema.nullish().optional(),
+  hermes: HermesConfigSchema.nullish().optional()
 });
 
 // src/_libs/config.ts
@@ -125,6 +134,7 @@ var ConfigManager = class {
     this._cursor = null;
     this._opencode = null;
     this._geminicli = null;
+    this._hermes = null;
   }
   get repo_path() {
     return this._repo_path;
@@ -156,6 +166,9 @@ var ConfigManager = class {
   get geminicli() {
     return this._geminicli;
   }
+  get hermes() {
+    return this._hermes;
+  }
   set repo_path(v) {
     this._repo_path = v;
   }
@@ -186,6 +199,9 @@ var ConfigManager = class {
   set geminicli(v) {
     this._geminicli = v;
   }
+  set hermes(v) {
+    this._hermes = v;
+  }
   init() {
     this._loadFromDisk();
     if (this._repo_path != null) {
@@ -209,7 +225,8 @@ var ConfigManager = class {
         antigravity: this._antigravity,
         cursor: this._cursor,
         opencode: this._opencode,
-        geminicli: this._geminicli
+        geminicli: this._geminicli,
+        hermes: this._hermes
       }, null, 4);
       fs.writeFileSync(CONFIG_PATH, configStr, "utf-8");
       console.log(chalk.green(`Config saved`) + chalk.dim(` \u2192 ${CONFIG_PATH}`));
@@ -252,6 +269,9 @@ var ConfigManager = class {
   isGeminicliEnabled() {
     return this._geminicli != null;
   }
+  isHermesEnabled() {
+    return this._hermes != null;
+  }
   _assign(config) {
     this._repo_path = config.repo_path;
     this._remote_url = config.remote_url;
@@ -263,6 +283,7 @@ var ConfigManager = class {
     this._cursor = config.cursor ?? null;
     this._opencode = config.opencode ?? null;
     this._geminicli = config.geminicli ?? null;
+    this._hermes = config.hermes ?? null;
   }
   _loadFromDisk() {
     if (fs.existsSync(CONFIG_PATH) === false) {
@@ -490,11 +511,46 @@ metadata:
 # Gemini CLI
 name: my-skill
 description: "What this skill does and when Gemini should use it"
+
+# Hermes
+name: my-skill
+description: "What this skill does and when to use it"
+version: "1.0.0"
+platforms:
+  - macos
+  - linux
+  - windows
+metadata:
+  hermes:
+    tags:
+      - python
+      - automation
+    category: devops
+    requires_toolsets:
+      - terminal
+    fallback_for_toolsets:
+      - browser
+    requires_tools:
+      - rg
+    fallback_for_tools:
+      - grep
+    config:
+      - key: my.setting
+        description: "What this controls"
+        default: "value"
+        prompt: "Prompt for setup"
+required_environment_variables:
+  - name: TENOR_API_KEY
+    prompt: "Tenor API key"
+    help: "Get a key from https://developers.google.com/tenor"
+    required_for: "full functionality"
 ---
 \`\`\`
 
 > **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.
+
 | Field | Required | Platform | Description |
 |-------|----------|----------|-------------|
 | \`name\` | Yes | All | Display name. Claude Code / OpenCode / RooCode: lowercase, numbers, hyphens only (no underscores; Claude Code / OpenCode limit to 64 chars). Gemini CLI: lowercase with hyphens, must match the directory name. Antigravity: optional, defaults to folder name. |
@@ -519,7 +575,17 @@ description: "What this skill does and when Gemini should use it"
 | \`command-arg-mode\` | No | OpenClaw | How arguments are forwarded to the tool. (default: \`"raw"\`) |
 | \`license\` | No | Cursor, OpenCode | License name or reference to a bundled license file. |
 | \`compatibility\` | No | Cursor, OpenCode | Environment requirements (system packages, network access, etc.) |
-| \`metadata\` | No | Cursor, OpenCode | Arbitrary key-value mapping for additional metadata. OpenCode requires string-to-string values only. |
+| \`metadata\` | No | Cursor, OpenCode, Hermes | Arbitrary key-value mapping for additional metadata. OpenCode requires string-to-string values only. Hermes uses the \`metadata.hermes.*\` namespace for platform-specific fields. |
+| \`version\` | No | Hermes | Version number (e.g. \`"1.0.0"\`) |
+| \`platforms\` | No | Hermes | OS allow-list. Values: \`macos\`, \`linux\`, \`windows\`. (default: all) |
+| \`metadata.hermes.tags\` | No | Hermes | Categorization keywords array. |
+| \`metadata.hermes.category\` | No | Hermes | Skill category \u2014 should match the parent directory name. |
+| \`metadata.hermes.requires_toolsets\` | No | Hermes | Skill is hidden unless these toolsets are available. |
+| \`metadata.hermes.fallback_for_toolsets\` | No | Hermes | Skill is hidden when these toolsets are already available (acts as a fallback). |
+| \`metadata.hermes.requires_tools\` | No | Hermes | Skill is hidden unless these specific tools are available. |
+| \`metadata.hermes.fallback_for_tools\` | No | Hermes | Skill is hidden when these specific tools are already available. |
+| \`metadata.hermes.config\` | No | Hermes | Array of configuration declarations. Each entry: \`key\`, \`description\`, \`default\`, \`prompt\`. |
+| \`required_environment_variables\` | No | Hermes | Array of required env vars. Each entry: \`name\`, \`prompt\`, \`help\`, \`required_for\`. |
 
 ---
 
@@ -591,6 +657,10 @@ Include: 1) Refactored code. 2) Explanation of changes.
 
 **Namespacing**: subdirectories create namespaced commands \u2014 \`commands/git/commit.toml\` becomes \`/git:commit\`. After edits, run \`/commands reload\` in Gemini CLI.
 
+#### 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.
+
 | Field | Required | Platform | Description |
 |-------|----------|----------|-------------|
 | \`name\` | No | All | Display name \u2014 lowercase, numbers, hyphens only (max 64 chars). Defaults to directory name. |
@@ -877,6 +947,55 @@ echo '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"
 echo '{"permission":"deny","user_message":"Blocked by policy","agent_message":"Not allowed"}'
 \`\`\`
 
+---
+
+#### Hermes Hooks (set-prompt integration)
+
+Hermes uses Python callbacks rather than declarative JSON \u2014 set-prompt bridges the gap by reading the **same** \`hooks/hooks.json\` used by Claude Code/Cursor, but only picks up entries whose top-level key is a Hermes event name. Other tools' keys (\`UserPromptSubmit\`, \`afterFileEdit\`, etc.) are ignored, so the file can hold hooks for multiple platforms side-by-side.
+
+\`\`\`json
+{
+  "hooks": {
+    "UserPromptSubmit": [
+      { "hooks": [{ "type": "command", "command": "...claude-only..." }] }
+    ],
+    "pre_tool_call": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \\"\${SET_PROMPT_REPO}/hooks/audit.mjs\\"",
+            "timeout": 5
+          }
+        ]
+      }
+    ]
+  }
+}
+\`\`\`
+
+**Hermes events** (whitelist applied by the generated \`__init__.py\`)
+
+| Event | When it fires |
+|-------|---------------|
+| \`pre_tool_call\` / \`post_tool_call\` | Before / after a tool runs |
+| \`pre_llm_call\` / \`post_llm_call\` | Before / after an LLM call |
+| \`on_session_start\` / \`on_session_end\` / \`on_session_finalize\` / \`on_session_reset\` | Session lifecycle |
+| \`subagent_stop\` | Subagent completes |
+| \`pre_gateway_dispatch\` | Before a gateway dispatch |
+
+**Handler fields** (only \`type: "command"\` is supported)
+
+| Field | Description |
+|-------|-------------|
+| \`type\` | Must be \`"command"\`. Other types are ignored. |
+| \`command\` | Shell command. \`\${SET_PROMPT_REPO}\` is substituted with the repo path; the \`SET_PROMPT_REPO\` env var is also set. |
+| \`timeout\` | Seconds before the subprocess is killed. Optional. |
+
+**Payload**: when the hook fires, set-prompt's runner pipes a JSON object on stdin to the command \u2014 \`{"event": "<event_name>", "args": [...], "kwargs": {...}}\`. \`args\`/\`kwargs\` mirror whatever Hermes passed to the callback (stringified via \`repr()\` for safety).
+
+**Decision control**: Hermes does not currently expose block/allow semantics through this bridge \u2014 the subprocess return value is not propagated back. Hooks are observation-only on the Hermes side.
+
 `;
 
 // src/commands/scaffold-command.ts
@@ -1098,7 +1217,7 @@ var installCommand = async (target) => {
 };
 
 // src/commands/link-command.ts
-import chalk14 from "chalk";
+import chalk15 from "chalk";
 import { checkbox } from "@inquirer/prompts";
 
 // src/link/claudecode.ts
@@ -2366,6 +2485,330 @@ Removing Gemini CLI integration...`));
   configManager.save();
 };
 
+// src/link/hermes.ts
+import path12 from "path";
+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}
+version: "1.0"
+description: Managed by set-prompt
+`;
+var buildInitPy = (repoPath) => {
+  const repoLiteral = JSON.stringify(repoPath);
+  return `"""Auto-generated by set-prompt. Do not edit by hand."""
+import json
+import os
+import subprocess
+from pathlib import Path
+
+REPO_DIR = Path(${repoLiteral})
+
+HERMES_EVENTS = {
+    "pre_tool_call",
+    "post_tool_call",
+    "pre_llm_call",
+    "post_llm_call",
+    "on_session_start",
+    "on_session_end",
+    "on_session_finalize",
+    "on_session_reset",
+    "subagent_stop",
+    "pre_gateway_dispatch",
+}
+
+
+def _parse_frontmatter(text):
+    if not text.startswith("---"):
+        return {}, text
+    end = text.find("\\n---", 3)
+    if end == -1:
+        return {}, text
+    meta_block = text[3:end].strip()
+    body = text[end + 4:].lstrip("\\n")
+    meta = {}
+    for line in meta_block.splitlines():
+        if ":" not in line:
+            continue
+        key, _, value = line.partition(":")
+        meta[key.strip()] = value.strip().strip('"').strip("'")
+    return meta, body
+
+
+def _make_command_handler(ctx, body):
+    def handler(_args=None):
+        ctx.inject_message(body, role="user")
+    return handler
+
+
+def _make_hook_runner(event, raw_cmd, timeout):
+    def runner(*args, **kwargs):
+        cmd = raw_cmd.replace("\${SET_PROMPT_REPO}", str(REPO_DIR))
+        env = dict(os.environ)
+        env["SET_PROMPT_REPO"] = str(REPO_DIR)
+        payload = json.dumps({
+            "event": event,
+            "args": [repr(a) for a in args],
+            "kwargs": {k: repr(v) for k, v in kwargs.items()},
+        }).encode("utf-8")
+        try:
+            subprocess.run(
+                cmd, shell=True, input=payload, env=env,
+                timeout=timeout if isinstance(timeout, (int, float)) else None,
+                check=False,
+            )
+        except (subprocess.TimeoutExpired, OSError):
+            pass
+    return runner
+
+
+def _iter_hook_commands(entries):
+    if not isinstance(entries, list):
+        return
+    for entry in entries:
+        if not isinstance(entry, dict):
+            continue
+        sub = entry.get("hooks")
+        if not isinstance(sub, list):
+            continue
+        for h in sub:
+            if not isinstance(h, dict):
+                continue
+            if h.get("type") != "command":
+                continue
+            cmd = h.get("command")
+            if not isinstance(cmd, str) or not cmd:
+                continue
+            yield cmd, h.get("timeout")
+
+
+def _register_hooks(ctx):
+    hooks_json = REPO_DIR / "hooks" / "hooks.json"
+    if not hooks_json.exists():
+        return
+    try:
+        data = json.loads(hooks_json.read_text(encoding="utf-8"))
+    except (OSError, ValueError):
+        return
+    block = data.get("hooks") if isinstance(data, dict) else None
+    if not isinstance(block, dict):
+        return
+    for event, entries in block.items():
+        if event not in HERMES_EVENTS:
+            continue
+        for cmd, timeout in _iter_hook_commands(entries):
+            ctx.register_hook(event, _make_hook_runner(event, cmd, timeout))
+
+
+def register(ctx):
+    skills_dir = REPO_DIR / "skills"
+    if skills_dir.exists():
+        for skill_path in sorted(skills_dir.iterdir()):
+            if not skill_path.is_dir():
+                continue
+            if not (skill_path / "SKILL.md").exists():
+                continue
+            ctx.register_skill(skill_path.name, str(skill_path))
+
+    commands_dir = REPO_DIR / "commands"
+    if commands_dir.exists():
+        for cmd_file in sorted(commands_dir.glob("*.md")):
+            try:
+                text = cmd_file.read_text(encoding="utf-8")
+            except OSError:
+                continue
+            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)
+
+    _register_hooks(ctx)
+`;
+};
+var FRESH_CONFIG_YAML = `# Generated by set-prompt
+plugins:
+  enabled:
+    - ${MARKET_NAME}
+`;
+var writePluginManifest = (repoPath) => {
+  fs13.writeFileSync(path12.join(HERMES_PLUGIN_DIR, "plugin.yaml"), PLUGIN_YAML, "utf-8");
+  fs13.writeFileSync(path12.join(HERMES_PLUGIN_DIR, "__init__.py"), buildInitPy(repoPath), "utf-8");
+};
+var writeWithBackup = (filePath, content) => {
+  let backupPath = null;
+  if (fs13.existsSync(filePath)) {
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+    backupPath = `${filePath}.bak.${timestamp}`;
+    try {
+      fs13.copyFileSync(filePath, backupPath);
+    } catch {
+      backupPath = null;
+    }
+  }
+  try {
+    fs13.mkdirSync(path12.dirname(filePath), { recursive: true });
+    fs13.writeFileSync(filePath, content, "utf-8");
+  } catch (ex) {
+    if (backupPath !== null) {
+      try {
+        fs13.copyFileSync(backupPath, filePath);
+        fs13.unlinkSync(backupPath);
+        console.warn(chalk14.yellow("  \u26A0 Write failed \u2014 rolled back to original."));
+      } catch {
+        console.error(chalk14.red(`  \u274C Rollback failed. Backup preserved at: ${backupPath}`));
+      }
+    }
+    throw ex;
+  }
+  if (backupPath !== null) {
+    try {
+      fs13.unlinkSync(backupPath);
+    } catch {
+    }
+  }
+};
+var ensureHermesConfigEnabled = () => {
+  if (fs13.existsSync(HERMES_CONFIG_PATH) === false) {
+    fs13.mkdirSync(path12.dirname(HERMES_CONFIG_PATH), { recursive: true });
+    fs13.writeFileSync(HERMES_CONFIG_PATH, FRESH_CONFIG_YAML, "utf-8");
+    console.log(chalk14.green("  \u2713 ") + chalk14.dim(`wrote ${HERMES_CONFIG_PATH}`));
+    return;
+  }
+  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.`));
+    console.log(chalk14.dim(`    File: ${HERMES_CONFIG_PATH}`));
+    return;
+  }
+  if (doc.errors.length > 0) {
+    console.warn(chalk14.yellow(`  \u26A0 Hermes config has YAML errors \u2014 leaving file untouched.`));
+    console.log(chalk14.dim(`    File: ${HERMES_CONFIG_PATH}`));
+    return;
+  }
+  let plugins = doc.get("plugins");
+  if (plugins == null) {
+    doc.set("plugins", doc.createNode({ enabled: [MARKET_NAME] }));
+    writeWithBackup(HERMES_CONFIG_PATH, String(doc));
+    console.log(chalk14.green("  \u2713 ") + chalk14.dim(`added plugins.enabled to ${HERMES_CONFIG_PATH}`));
+    return;
+  }
+  if (!YAML.isMap(plugins)) {
+    console.warn(chalk14.yellow(`  \u26A0 "plugins" is not a map \u2014 leaving file untouched.`));
+    console.log(chalk14.dim(`    File: ${HERMES_CONFIG_PATH}`));
+    return;
+  }
+  let enabled = plugins.get("enabled");
+  if (enabled == null) {
+    plugins.set("enabled", doc.createNode([MARKET_NAME]));
+    writeWithBackup(HERMES_CONFIG_PATH, String(doc));
+    console.log(chalk14.green("  \u2713 ") + chalk14.dim(`added plugins.enabled to ${HERMES_CONFIG_PATH}`));
+    return;
+  }
+  if (!YAML.isSeq(enabled)) {
+    console.warn(chalk14.yellow(`  \u26A0 "plugins.enabled" is not a list \u2014 leaving file untouched.`));
+    console.log(chalk14.dim(`    File: ${HERMES_CONFIG_PATH}`));
+    return;
+  }
+  const alreadyListed = enabled.items.some((item) => {
+    const v = YAML.isScalar(item) ? item.value : item;
+    return v === MARKET_NAME;
+  });
+  if (alreadyListed) {
+    console.log(chalk14.dim(`  \u2713 ${MARKET_NAME} already listed in ${HERMES_CONFIG_PATH}`));
+    return;
+  }
+  enabled.add(MARKET_NAME);
+  writeWithBackup(HERMES_CONFIG_PATH, String(doc));
+  console.log(chalk14.green("  \u2713 ") + chalk14.dim(`enabled "${MARKET_NAME}" in ${HERMES_CONFIG_PATH}`));
+};
+var linkHermes = async () => {
+  const repoPath = resolveRepoPath();
+  if (repoPath == null) {
+    return;
+  }
+  console.log(chalk14.green(`
+Setting up Hermes plugin...`));
+  console.log(chalk14.dim(HERMES_PLUGIN_DIR));
+  try {
+    fs13.mkdirSync(HERMES_PLUGIN_DIR, { recursive: true });
+    writePluginManifest(repoPath);
+    console.log(chalk14.dim("  \u251C\u2500\u2500 ") + chalk14.bold("plugin.yaml") + chalk14.green(" \u2713"));
+    console.log(chalk14.dim("  \u2514\u2500\u2500 ") + chalk14.bold("__init__.py") + chalk14.dim(` (REPO_DIR \u2192 ${repoPath})`) + chalk14.green(" \u2713"));
+    ensureHermesConfigEnabled();
+    configManager.hermes = { path: HERMES_PLUGIN_DIR };
+    configManager.save();
+    console.log(chalk14.dim(`
+  \u2139 Hermes loads plugins at startup \u2014 restart Hermes to pick up new skills/commands.`));
+  } catch (ex) {
+    console.error(chalk14.red(`\u274C Failed to set up Hermes plugin: ${ex.message}`));
+  }
+};
+var unlinkHermes = async (force = false) => {
+  if (!force) {
+    const ok = await confirm11({
+      message: `Remove Hermes plugin dir (${HERMES_PLUGIN_DIR})?`,
+      default: false
+    });
+    if (!ok) {
+      console.log(chalk14.yellow("Cancelled."));
+      return;
+    }
+  }
+  console.log(chalk14.red(`
+Removing Hermes plugin...`));
+  console.log(chalk14.dim(HERMES_PLUGIN_DIR));
+  if (fs13.existsSync(HERMES_PLUGIN_DIR)) {
+    fs13.rmSync(HERMES_PLUGIN_DIR, { recursive: true, force: true });
+    console.log(chalk14.red("  removed") + chalk14.dim(`: ${HERMES_PLUGIN_DIR}`));
+  }
+  if (fs13.existsSync(HERMES_CONFIG_PATH)) {
+    const content = fs13.readFileSync(HERMES_CONFIG_PATH, "utf-8");
+    if (content.trimStart().startsWith("# Generated by set-prompt")) {
+      fs13.unlinkSync(HERMES_CONFIG_PATH);
+      console.log(chalk14.red("  removed") + chalk14.dim(`: ${HERMES_CONFIG_PATH}`));
+    } else {
+      removeMarketEntryFromConfig();
+    }
+  }
+  configManager.hermes = null;
+  configManager.save();
+};
+var removeMarketEntryFromConfig = () => {
+  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;
+  }
+  if (doc.errors.length > 0) {
+    return;
+  }
+  const plugins = doc.get("plugins");
+  if (!YAML.isMap(plugins)) {
+    return;
+  }
+  const enabled = plugins.get("enabled");
+  if (!YAML.isSeq(enabled)) {
+    return;
+  }
+  const idx = enabled.items.findIndex((item) => {
+    const v = YAML.isScalar(item) ? item.value : item;
+    return v === MARKET_NAME;
+  });
+  if (idx === -1) {
+    return;
+  }
+  enabled.delete(idx);
+  writeWithBackup(HERMES_CONFIG_PATH, String(doc));
+  console.log(chalk14.red("  removed") + chalk14.dim(` "${MARKET_NAME}" from: ${HERMES_CONFIG_PATH}`));
+};
+
 // src/commands/link-command.ts
 var LINK_MAP = {
   ["claudecode" /* CLAUDECODE */]: linkClaudeCode,
@@ -2375,7 +2818,8 @@ var LINK_MAP = {
   ["antigravity" /* ANTIGRAVITY */]: linkAntigravity,
   ["cursor" /* CURSOR */]: linkCursor,
   ["opencode" /* OPENCODE */]: linkOpencode,
-  ["geminicli" /* GEMINICLI */]: linkGeminicli
+  ["geminicli" /* GEMINICLI */]: linkGeminicli,
+  ["hermes" /* HERMES */]: linkHermes
 };
 var UNLINK_MAP = {
   ["claudecode" /* CLAUDECODE */]: unlinkClaudeCode,
@@ -2385,13 +2829,14 @@ var UNLINK_MAP = {
   ["antigravity" /* ANTIGRAVITY */]: unlinkAntigravity,
   ["cursor" /* CURSOR */]: unlinkCursor,
   ["opencode" /* OPENCODE */]: unlinkOpencode,
-  ["geminicli" /* GEMINICLI */]: unlinkGeminicli
+  ["geminicli" /* GEMINICLI */]: unlinkGeminicli,
+  ["hermes" /* HERMES */]: unlinkHermes
 };
 var linkCommand = async (tool) => {
   if (tool != null) {
     const known = ALL_AGENTS.some((a) => a.value === tool);
     if (!known) {
-      console.log(chalk14.red(`Unknown vendor: ${tool}`));
+      console.log(chalk15.red(`Unknown vendor: ${tool}`));
       process.exit(1);
     }
     await LINK_MAP[tool]();
@@ -2405,12 +2850,13 @@ var linkCommand = async (tool) => {
     ["antigravity" /* ANTIGRAVITY */]: configManager.isAntigravityEnabled(),
     ["cursor" /* CURSOR */]: configManager.isCursorEnabled(),
     ["opencode" /* OPENCODE */]: configManager.isOpencodeEnabled(),
-    ["geminicli" /* GEMINICLI */]: configManager.isGeminicliEnabled()
+    ["geminicli" /* GEMINICLI */]: configManager.isGeminicliEnabled(),
+    ["hermes" /* HERMES */]: configManager.isHermesEnabled()
   };
   const selected = await checkbox({
     message: "Which AI agent do you want to integrate?",
     choices: ALL_AGENTS.map((a) => ({
-      name: prevLinked[a.value] ? `${a.name} ${chalk14.dim("(applied)")}` : a.name,
+      name: prevLinked[a.value] ? `${a.name} ${chalk15.dim("(applied)")}` : a.name,
       value: a.value,
       checked: prevLinked[a.value]
     })),
@@ -2421,10 +2867,10 @@ var linkCommand = async (tool) => {
   const toUnlink = ALL_AGENTS.filter((a) => prevLinked[a.value] && !selected.includes(a.value));
   console.log();
   if (toLink.length > 0) {
-    console.log(chalk14.green("  Link   ") + chalk14.dim("\u2192 ") + toLink.map((a) => chalk14.bold(a.name)).join(chalk14.dim(", ")));
+    console.log(chalk15.green("  Link   ") + chalk15.dim("\u2192 ") + toLink.map((a) => chalk15.bold(a.name)).join(chalk15.dim(", ")));
   }
   if (toUnlink.length > 0) {
-    console.log(chalk14.red("  Unlink ") + chalk14.dim("\u2192 ") + toUnlink.map((a) => chalk14.bold(a.name)).join(chalk14.dim(", ")));
+    console.log(chalk15.red("  Unlink ") + chalk15.dim("\u2192 ") + toUnlink.map((a) => chalk15.bold(a.name)).join(chalk15.dim(", ")));
   }
   console.log();
   if (toLink.length === 0 && toUnlink.length === 0) {
@@ -2443,47 +2889,59 @@ var linkCommand = async (tool) => {
 };
 
 // src/commands/uninstall-command.ts
-import fs13 from "fs";
-import chalk15 from "chalk";
-import { confirm as confirm11 } from "@inquirer/prompts";
+import fs14 from "fs";
+import chalk16 from "chalk";
+import { confirm as confirm12 } from "@inquirer/prompts";
 var uninstallCommand = async () => {
   const targets = [
-    { label: `Config file  ${chalk15.dim(CONFIG_PATH)}`, path: CONFIG_PATH },
-    { label: `Home dir     ${chalk15.dim(HOME_DIR)}`, path: HOME_DIR }
-  ].filter((t) => fs13.existsSync(t.path));
+    { label: `Config file  ${chalk16.dim(CONFIG_PATH)}`, path: CONFIG_PATH },
+    { label: `Home dir     ${chalk16.dim(HOME_DIR)}`, path: HOME_DIR }
+  ].filter((t) => fs14.existsSync(t.path));
   const hasClaudeCode = configManager.isClaudeCodeEnabled();
   const hasRooCode = configManager.isRooCodeEnabled();
   const hasOpenclaw = configManager.isOpenclawEnabled();
   const hasAntigravity = configManager.isAntigravityEnabled();
   const hasCodex = configManager.isCodexEnabled();
   const hasCursor = configManager.isCursorEnabled();
-  if (targets.length === 0 && !hasClaudeCode && !hasRooCode && !hasOpenclaw && !hasAntigravity && !hasCodex && !hasCursor) {
-    console.log(chalk15.yellow("Nothing to remove."));
+  const hasOpencode = configManager.isOpencodeEnabled();
+  const hasGeminicli = configManager.isGeminicliEnabled();
+  const hasHermes = configManager.isHermesEnabled();
+  if (targets.length === 0 && !hasClaudeCode && !hasRooCode && !hasOpenclaw && !hasAntigravity && !hasCodex && !hasCursor && !hasOpencode && !hasGeminicli && !hasHermes) {
+    console.log(chalk16.yellow("Nothing to remove."));
     return;
   }
-  console.log(chalk15.red("\nThe following will be removed:"));
+  console.log(chalk16.red("\nThe following will be removed:"));
   targets.forEach((t) => console.log(`  ${t.label}`));
   if (hasClaudeCode) {
-    console.log(`  Claude Code plugin dir  ${chalk15.dim(CLAUDE_CODE_DIR)}`);
+    console.log(`  Claude Code plugin dir  ${chalk16.dim(CLAUDE_CODE_DIR)}`);
   }
   if (hasRooCode) {
-    console.log(`  RooCode symlinks ${chalk15.dim("(backup will be restored)")}`);
+    console.log(`  RooCode symlinks ${chalk16.dim("(backup will be restored)")}`);
   }
   if (hasOpenclaw) {
-    console.log(`  OpenClaw symlinks ${chalk15.dim("(backup will be restored)")}`);
+    console.log(`  OpenClaw symlinks ${chalk16.dim("(backup will be restored)")}`);
   }
   if (hasAntigravity) {
-    console.log(`  Antigravity symlinks ${chalk15.dim("(backup will be restored)")}`);
+    console.log(`  Antigravity symlinks ${chalk16.dim("(backup will be restored)")}`);
   }
   if (hasCodex) {
-    console.log(`  Codex symlinks ${chalk15.dim("(backup will be restored)")}`);
+    console.log(`  Codex symlinks ${chalk16.dim("(backup will be restored)")}`);
   }
   if (hasCursor) {
-    console.log(`  Cursor plugin dir ${chalk15.dim("(symlink will be removed)")}`);
+    console.log(`  Cursor plugin dir ${chalk16.dim("(symlink will be removed)")}`);
   }
-  const ok = await confirm11({ message: "Proceed?", default: false });
+  if (hasOpencode) {
+    console.log(`  OpenCode symlinks ${chalk16.dim("(backup will be restored)")}`);
+  }
+  if (hasGeminicli) {
+    console.log(`  Gemini CLI symlinks ${chalk16.dim("(backup will be restored)")}`);
+  }
+  if (hasHermes) {
+    console.log(`  Hermes plugin dir ${chalk16.dim("(plugin folder will be removed)")}`);
+  }
+  const ok = await confirm12({ message: "Proceed?", default: false });
   if (!ok) {
-    console.log(chalk15.yellow("Cancelled."));
+    console.log(chalk16.yellow("Cancelled."));
     return;
   }
   if (hasClaudeCode) {
@@ -2504,27 +2962,36 @@ var uninstallCommand = async () => {
   if (hasCursor) {
     await unlinkCursor(true);
   }
+  if (hasOpencode) {
+    await unlinkOpencode(true);
+  }
+  if (hasGeminicli) {
+    await unlinkGeminicli(true);
+  }
+  if (hasHermes) {
+    await unlinkHermes(true);
+  }
   for (const t of targets) {
-    fs13.rmSync(t.path, { recursive: true, force: true });
-    console.log(chalk15.dim(`  removed: ${t.path}`));
+    fs14.rmSync(t.path, { recursive: true, force: true });
+    console.log(chalk16.dim(`  removed: ${t.path}`));
   }
-  console.log(chalk15.green("\nUninstalled."));
+  console.log(chalk16.green("\nUninstalled."));
 };
 
 // src/commands/status-command.ts
-import chalk16 from "chalk";
+import chalk17 from "chalk";
 var statusCommand = () => {
   if (configManager.repo_path == null) {
-    console.log(chalk16.yellow("\u274C No repo installed."));
-    console.log(chalk16.dim(`  Run: set-prompt install <repo-url>`));
+    console.log(chalk17.yellow("\u274C No repo installed."));
+    console.log(chalk17.dim(`  Run: set-prompt install <repo-url>`));
     return;
   }
-  console.log(chalk16.bold("\nRepo"));
-  console.log(`${TAB}path   ${chalk16.cyan(configManager.repo_path)}`);
+  console.log(chalk17.bold("\nRepo"));
+  console.log(`${TAB}path   ${chalk17.cyan(configManager.repo_path)}`);
   if (configManager.remote_url != null) {
-    console.log(`${TAB}remote ${chalk16.dim(configManager.remote_url)}`);
+    console.log(`${TAB}remote ${chalk17.dim(configManager.remote_url)}`);
   }
-  console.log(chalk16.bold("\nLinked agents"));
+  console.log(chalk17.bold("\nLinked agents"));
   for (const agent of ALL_AGENTS) {
     let linked = false;
     let agentPath = null;
@@ -2543,9 +3010,21 @@ var statusCommand = () => {
     } else if (agent.value === "antigravity" /* ANTIGRAVITY */) {
       linked = configManager.isAntigravityEnabled();
       agentPath = configManager.antigravity?.path;
-    }
-    const label = linked ? chalk16.green("linked") : chalk16.dim("not linked");
-    const pathStr = linked && agentPath ? chalk16.dim(` \u2192 ${agentPath}`) : "";
+    } else if (agent.value === "cursor" /* CURSOR */) {
+      linked = configManager.isCursorEnabled();
+      agentPath = configManager.cursor?.path;
+    } else if (agent.value === "opencode" /* OPENCODE */) {
+      linked = configManager.isOpencodeEnabled();
+      agentPath = configManager.opencode?.path;
+    } else if (agent.value === "geminicli" /* GEMINICLI */) {
+      linked = configManager.isGeminicliEnabled();
+      agentPath = configManager.geminicli?.path;
+    } else if (agent.value === "hermes" /* HERMES */) {
+      linked = configManager.isHermesEnabled();
+      agentPath = configManager.hermes?.path;
+    }
+    const label = linked ? chalk17.green("linked") : chalk17.dim("not linked");
+    const pathStr = linked && agentPath ? chalk17.dim(` \u2192 ${agentPath}`) : "";
     console.log(`${TAB}${agent.name.padEnd(12)} ${label}${pathStr}`);
   }
   console.log("");
@@ -2553,92 +3032,92 @@ var statusCommand = () => {
 
 // src/commands/repo/pull-command.ts
 import { spawnSync as spawnSync4 } from "child_process";
-import chalk17 from "chalk";
+import chalk18 from "chalk";
 var repoPullCommand = () => {
   const repoPath = configManager.repo_path;
   if (repoPath == null) {
-    console.error(chalk17.red("\u274C No repo installed."));
-    console.log(chalk17.yellow("Run: set-prompt install <git-url>"));
+    console.error(chalk18.red("\u274C No repo installed."));
+    console.log(chalk18.yellow("Run: set-prompt install <git-url>"));
     return;
   }
   if (configManager.remote_url == null) {
-    console.error(chalk17.red("\u274C No remote URL registered. Cannot pull."));
+    console.error(chalk18.red("\u274C No remote URL registered. Cannot pull."));
     return;
   }
-  console.log(chalk17.green("\nPulling prompt repo..."));
-  console.log(chalk17.dim(repoPath));
+  console.log(chalk18.green("\nPulling prompt repo..."));
+  console.log(chalk18.dim(repoPath));
   const fetch = spawnSync4("git", ["fetch"], { cwd: repoPath, stdio: "inherit" });
   if (fetch.status !== 0) {
-    console.error(chalk17.red("\u274C git fetch failed."));
+    console.error(chalk18.red("\u274C git fetch failed."));
     return;
   }
   const pull = spawnSync4("git", ["pull"], { cwd: repoPath, stdio: "inherit" });
   if (pull.status !== 0) {
-    console.error(chalk17.red("\u274C git pull failed."));
+    console.error(chalk18.red("\u274C git pull failed."));
     return;
   }
-  console.log(chalk17.green("\u2705 Repo pulled."));
+  console.log(chalk18.green("\u2705 Repo pulled."));
 };
 
 // src/commands/repo/commit-command.ts
 import { spawnSync as spawnSync5 } from "child_process";
-import chalk18 from "chalk";
+import chalk19 from "chalk";
 var repoCommitCommand = (options = {}) => {
   const repoPath = configManager.repo_path;
   if (repoPath == null) {
-    console.error(chalk18.red("\u274C No repo installed."));
-    console.log(chalk18.yellow("Run: set-prompt install <git-url>"));
+    console.error(chalk19.red("\u274C No repo installed."));
+    console.log(chalk19.yellow("Run: set-prompt install <git-url>"));
     return false;
   }
   let message = options.message;
   if (message == null || message.trim() === "") {
     const generated = generateCommitMessage(repoPath);
     if (generated == null) {
-      console.error(chalk18.red("\u274C Nothing to commit \u2014 working tree is clean."));
+      console.error(chalk19.red("\u274C Nothing to commit \u2014 working tree is clean."));
       return false;
     }
     message = generated;
     const subject = message.split("\n")[0];
-    console.log(chalk18.dim(`  (auto-generated: ${subject})`));
+    console.log(chalk19.dim(`  (auto-generated: ${subject})`));
   }
-  console.log(chalk18.green("\nCommitting prompt repo changes..."));
-  console.log(chalk18.dim(repoPath));
+  console.log(chalk19.green("\nCommitting prompt repo changes..."));
+  console.log(chalk19.dim(repoPath));
   const add = spawnSync5("git", ["add", "-A"], { cwd: repoPath, stdio: "inherit" });
   if (add.status !== 0) {
-    console.error(chalk18.red("\u274C git add failed."));
+    console.error(chalk19.red("\u274C git add failed."));
     return false;
   }
   const commit = spawnSync5("git", ["commit", "-m", message], { cwd: repoPath, stdio: "inherit" });
   if (commit.status !== 0) {
-    console.error(chalk18.red("\u274C git commit failed \u2014 nothing to commit, or commit rejected."));
+    console.error(chalk19.red("\u274C git commit failed \u2014 nothing to commit, or commit rejected."));
     return false;
   }
-  console.log(chalk18.green("\u2705 Committed."));
+  console.log(chalk19.green("\u2705 Committed."));
   return true;
 };
 
 // src/commands/repo/push-command.ts
 import { spawnSync as spawnSync6 } from "child_process";
-import chalk19 from "chalk";
+import chalk20 from "chalk";
 var repoPushCommand = () => {
   const repoPath = configManager.repo_path;
   if (repoPath == null) {
-    console.error(chalk19.red("\u274C No repo installed."));
-    console.log(chalk19.yellow("Run: set-prompt install <git-url>"));
+    console.error(chalk20.red("\u274C No repo installed."));
+    console.log(chalk20.yellow("Run: set-prompt install <git-url>"));
     return false;
   }
   if (configManager.remote_url == null) {
-    console.error(chalk19.red("\u274C No remote URL registered. Cannot push."));
+    console.error(chalk20.red("\u274C No remote URL registered. Cannot push."));
     return false;
   }
-  console.log(chalk19.green("\nPushing prompt repo..."));
-  console.log(chalk19.dim(repoPath));
+  console.log(chalk20.green("\nPushing prompt repo..."));
+  console.log(chalk20.dim(repoPath));
   const push = spawnSync6("git", ["push"], { cwd: repoPath, stdio: "inherit" });
   if (push.status !== 0) {
-    console.error(chalk19.red("\u274C git push failed."));
+    console.error(chalk20.red("\u274C git push failed."));
     return false;
   }
-  console.log(chalk19.green("\u2705 Pushed."));
+  console.log(chalk20.green("\u2705 Pushed."));
   return true;
 };
 
@@ -2651,7 +3130,7 @@ var repoSaveCommand = (options = {}) => {
 
 // src/commands/repo/status-command.ts
 import { spawnSync as spawnSync7 } from "child_process";
-import chalk20 from "chalk";
+import chalk21 from "chalk";
 var parseBranchLine = (line) => {
   const body = line.replace(/^## /, "");
   if (body.startsWith("HEAD ") || body.includes("(no branch)")) {
@@ -2679,27 +3158,27 @@ var parseFileLine = (line) => {
   const arrowIdx = name.indexOf(" -> ");
   if (arrowIdx >= 0) name = name.slice(arrowIdx + 4);
   if (name.startsWith('"') && name.endsWith('"')) name = name.slice(1, -1);
-  if (status.includes("?")) return { label: "untracked", color: chalk20.gray, path: name };
-  if (status.includes("D")) return { label: "deleted", color: chalk20.red, path: name };
-  if (status.includes("R")) return { label: "renamed", color: chalk20.cyan, path: name };
-  if (status.includes("A")) return { label: "added", color: chalk20.green, path: name };
-  if (status.includes("M")) return { label: "modified", color: chalk20.yellow, path: name };
+  if (status.includes("?")) return { label: "untracked", color: chalk21.gray, path: name };
+  if (status.includes("D")) return { label: "deleted", color: chalk21.red, path: name };
+  if (status.includes("R")) return { label: "renamed", color: chalk21.cyan, path: name };
+  if (status.includes("A")) return { label: "added", color: chalk21.green, path: name };
+  if (status.includes("M")) return { label: "modified", color: chalk21.yellow, path: name };
   return null;
 };
 var formatUpstream = (info) => {
-  if (info.branch == null) return chalk20.red("(detached HEAD)");
-  if (info.upstream == null) return `${info.branch} ${chalk20.yellow("(no upstream)")}`;
+  if (info.branch == null) return chalk21.red("(detached HEAD)");
+  if (info.upstream == null) return `${info.branch} ${chalk21.yellow("(no upstream)")}`;
   const segs = [];
-  if (info.ahead > 0) segs.push(chalk20.green(`ahead ${info.ahead}`));
-  if (info.behind > 0) segs.push(chalk20.red(`behind ${info.behind}`));
-  const trailing = segs.length > 0 ? ` (${segs.join(", ")})` : chalk20.dim(" (up to date)");
-  return `${info.branch} ${chalk20.dim("\u2192")} ${info.upstream}${trailing}`;
+  if (info.ahead > 0) segs.push(chalk21.green(`ahead ${info.ahead}`));
+  if (info.behind > 0) segs.push(chalk21.red(`behind ${info.behind}`));
+  const trailing = segs.length > 0 ? ` (${segs.join(", ")})` : chalk21.dim(" (up to date)");
+  return `${info.branch} ${chalk21.dim("\u2192")} ${info.upstream}${trailing}`;
 };
 var repoStatusCommand = () => {
   const repoPath = configManager.repo_path;
   if (repoPath == null) {
-    console.error(chalk20.red("\u274C No repo installed."));
-    console.log(chalk20.yellow("Run: set-prompt install <git-url>"));
+    console.error(chalk21.red("\u274C No repo installed."));
+    console.log(chalk21.yellow("Run: set-prompt install <git-url>"));
     return;
   }
   const result = spawnSync7("git", ["status", "--porcelain=v1", "--branch", "--untracked-files=all"], {
@@ -2707,8 +3186,8 @@ var repoStatusCommand = () => {
     encoding: "utf8"
   });
   if (result.status !== 0) {
-    console.error(chalk20.red("\u274C git status failed."));
-    if (result.stderr) console.error(chalk20.dim(result.stderr));
+    console.error(chalk21.red("\u274C git status failed."));
+    if (result.stderr) console.error(chalk21.dim(result.stderr));
     return;
   }
   const lines = result.stdout.split("\n").filter((l) => l.length > 0);
@@ -2716,14 +3195,14 @@ var repoStatusCommand = () => {
   const fileLines = lines.slice(1);
   const branchInfo = parseBranchLine(branchLine);
   const changes = fileLines.map(parseFileLine).filter((f) => f !== null);
-  console.log(`${chalk20.cyan("\u{1F4C2}")} ${chalk20.dim(repoPath)}`);
-  console.log(`${chalk20.cyan("\u{1F33F}")} ${formatUpstream(branchInfo)}`);
+  console.log(`${chalk21.cyan("\u{1F4C2}")} ${chalk21.dim(repoPath)}`);
+  console.log(`${chalk21.cyan("\u{1F33F}")} ${formatUpstream(branchInfo)}`);
   console.log("");
   if (changes.length === 0) {
-    console.log(chalk20.green("\u2705 Working tree clean"));
+    console.log(chalk21.green("\u2705 Working tree clean"));
     return;
   }
-  console.log(chalk20.bold(`\u{1F4DD} Changes (${changes.length}):`));
+  console.log(chalk21.bold(`\u{1F4DD} Changes (${changes.length}):`));
   const labelWidth = Math.max(...changes.map((c) => c.label.length));
   for (const c of changes) {
     const label = c.color(c.label.padEnd(labelWidth));
@@ -2732,12 +3211,12 @@ var repoStatusCommand = () => {
 };
 
 // src/commands/repo/path-command.ts
-import chalk21 from "chalk";
+import chalk22 from "chalk";
 var repoPathCommand = () => {
   const repoPath = configManager.repo_path;
   if (repoPath == null) {
-    console.error(chalk21.red("\u274C No repo installed."));
-    console.error(chalk21.yellow("Run: set-prompt install <git-url>"));
+    console.error(chalk22.red("\u274C No repo installed."));
+    console.error(chalk22.yellow("Run: set-prompt install <git-url>"));
     process.exitCode = 1;
     return;
   }
@@ -2746,8 +3225,8 @@ var repoPathCommand = () => {
 
 // src/commands/repo/open-command.ts
 import { spawn } from "child_process";
-import path12 from "path";
-import chalk22 from "chalk";
+import path13 from "path";
+import chalk23 from "chalk";
 var resolveVscodeTarget = (repoPath) => {
   if (isOnPath("code") === false) return null;
   return { bin: "code", args: [repoPath] };
@@ -2758,9 +3237,9 @@ var resolveSourcetreeTarget = (repoPath) => {
   }
   if (process.platform === "win32") {
     const exe = firstExistingPath([
-      process.env.LOCALAPPDATA && path12.join(process.env.LOCALAPPDATA, "SourceTree", "SourceTree.exe"),
-      process.env["ProgramFiles(x86)"] && path12.join(process.env["ProgramFiles(x86)"], "Atlassian", "SourceTree", "SourceTree.exe"),
-      process.env.ProgramFiles && path12.join(process.env.ProgramFiles, "Atlassian", "SourceTree", "SourceTree.exe")
+      process.env.LOCALAPPDATA && path13.join(process.env.LOCALAPPDATA, "SourceTree", "SourceTree.exe"),
+      process.env["ProgramFiles(x86)"] && path13.join(process.env["ProgramFiles(x86)"], "Atlassian", "SourceTree", "SourceTree.exe"),
+      process.env.ProgramFiles && path13.join(process.env.ProgramFiles, "Atlassian", "SourceTree", "SourceTree.exe")
     ]);
     if (exe != null) return { bin: exe, args: ["-f", repoPath] };
   }
@@ -2777,22 +3256,22 @@ var sourcetreeInstallHint = () => {
   return "Sourcetree is not available on Linux \u2014 try a native Git GUI instead";
 };
 var runLaunch = (label, target) => {
-  console.log(chalk22.green(`Opening in ${label}: ${chalk22.dim(target.args[target.args.length - 1])}`));
+  console.log(chalk23.green(`Opening in ${label}: ${chalk23.dim(target.args[target.args.length - 1])}`));
   const child = spawn(target.bin, target.args, { stdio: "ignore", detached: true, shell: true });
   child.unref();
 };
 var repoOpenCommand = (options = {}) => {
   const repoPath = configManager.repo_path;
   if (repoPath == null) {
-    console.error(chalk22.red("\u274C No repo installed."));
-    console.log(chalk22.yellow("Run: set-prompt install <git-url>"));
+    console.error(chalk23.red("\u274C No repo installed."));
+    console.log(chalk23.yellow("Run: set-prompt install <git-url>"));
     return;
   }
   if (options.code === true) {
     const target = resolveVscodeTarget(repoPath);
     if (target == null) {
-      console.error(chalk22.red("\u274C VSCode CLI (`code`) not found on PATH."));
-      console.log(chalk22.dim(`   ${VSCODE_INSTALL_HINT}`));
+      console.error(chalk23.red("\u274C VSCode CLI (`code`) not found on PATH."));
+      console.log(chalk23.dim(`   ${VSCODE_INSTALL_HINT}`));
       return;
     }
     runLaunch("VSCode", target);
@@ -2801,8 +3280,8 @@ var repoOpenCommand = (options = {}) => {
   if (options.stree === true) {
     const target = resolveSourcetreeTarget(repoPath);
     if (target == null) {
-      console.error(chalk22.red("\u274C Sourcetree not found."));
-      console.log(chalk22.dim(`   ${sourcetreeInstallHint()}`));
+      console.error(chalk23.red("\u274C Sourcetree not found."));
+      console.log(chalk23.dim(`   ${sourcetreeInstallHint()}`));
       return;
     }
     runLaunch("Sourcetree", target);
@@ -2810,46 +3289,46 @@ var repoOpenCommand = (options = {}) => {
   }
   const platform = process.platform;
   const opener = platform === "win32" ? "explorer" : platform === "darwin" ? "open" : "xdg-open";
-  console.log(chalk22.green(`Opening: ${chalk22.dim(repoPath)}`));
+  console.log(chalk23.green(`Opening: ${chalk23.dim(repoPath)}`));
   const child = spawn(opener, [repoPath], { stdio: "ignore", detached: true });
   child.on("error", (ex) => {
-    console.error(chalk22.red(`\u274C Failed to open: ${ex.message}`));
+    console.error(chalk23.red(`\u274C Failed to open: ${ex.message}`));
   });
   child.unref();
 };
 
 // src/index.ts
 process.on("SIGINT", () => {
-  console.log(chalk23.yellow("\nCancelled."));
+  console.log(chalk24.yellow("\nCancelled."));
   process.exit(0);
 });
 process.on("unhandledRejection", (reason) => {
   if (reason instanceof Error && reason.name === "ExitPromptError") {
-    console.log(chalk23.yellow("\nCancelled."));
+    console.log(chalk24.yellow("\nCancelled."));
     process.exit(0);
   }
   throw reason;
 });
-var __dirname = path13.dirname(fileURLToPath(import.meta.url));
-var pkg = JSON.parse(fs14.readFileSync(path13.join(__dirname, "../package.json"), "utf-8"));
+var __dirname = path14.dirname(fileURLToPath(import.meta.url));
+var pkg = JSON.parse(fs15.readFileSync(path14.join(__dirname, "../package.json"), "utf-8"));
 configManager.init();
 var program = new Command();
-var banner = chalk23.cyan(figlet.textSync("Set-Prompt", { horizontalLayout: "full" }));
+var banner = chalk24.cyan(figlet.textSync("Set-Prompt", { horizontalLayout: "full" }));
 program.name("set-prompt").description(pkg.description).version(pkg.version).addHelpText("beforeAll", ({ command }) => command === program ? banner + "\n" : "");
-program.command("install").description(`\u{1F4E6} Clone a ${chalk23.cyan("git repo")} into ${chalk23.dim("~/.set-prompt/repo/")} and register it as your prompt source`).argument("<url>", "remote git URL").action(async (source) => {
+program.command("install").description(`\u{1F4E6} Clone a ${chalk24.cyan("git repo")} into ${chalk24.dim("~/.set-prompt/repo/")} and register it as your prompt source`).argument("<url>", "remote git URL").action(async (source) => {
   await installCommand(source);
 });
-program.command("link").description(`\u{1F517} Symlink your prompt repo into an ${chalk23.cyan("AI agent")} plugin dir ${chalk23.dim("(claudecode | roocode | openclaw | codex | antigravity)")}`).argument("[agent]", `target agent ${chalk23.dim("(omit for interactive selection)")}`).action(async (agent) => {
+program.command("link").description(`\u{1F517} Symlink your prompt repo into an ${chalk24.cyan("AI agent")} plugin dir ${chalk24.dim("(claudecode | roocode | openclaw | codex | antigravity | cursor | opencode | geminicli | hermes)")}`).argument("[agent]", `target agent ${chalk24.dim("(omit for interactive selection)")}`).action(async (agent) => {
   await linkCommand(agent);
 });
-program.command("scaffold").description(`\u{1F6E0}\uFE0F  Verify and create ${chalk23.cyan("required directories")} in a prompt repo ${chalk23.dim("(-f to force overwrite)")}`).argument("[path]", `path to repo ${chalk23.dim("(defaults to installed source)")}`).action(async (localPath) => {
+program.command("scaffold").description(`\u{1F6E0}\uFE0F  Verify and create ${chalk24.cyan("required directories")} in a prompt repo ${chalk24.dim("(-f to force overwrite)")}`).argument("[path]", `path to repo ${chalk24.dim("(defaults to installed source)")}`).action(async (localPath) => {
   await scaffoldCommand(localPath);
 });
-program.command("status").description(`\u{1F4CB} Show registered ${chalk23.cyan("repo")} and which ${chalk23.cyan("agents")} are linked`).action(() => {
+program.command("status").description(`\u{1F4CB} Show registered ${chalk24.cyan("repo")} and which ${chalk24.cyan("agents")} are linked`).action(() => {
   statusCommand();
 });
-var repo = program.command("repo").description(`\u{1F5C2}\uFE0F  Manage the installed prompt repo ${chalk23.dim("(status | pull | commit | push | save | path | open)")}`);
-repo.command("status").description(`\u{1F4CB} Show VCS status of the repo ${chalk23.dim("(branch, ahead/behind, changed files)")}`).addHelpText("after", `
+var repo = program.command("repo").description(`\u{1F5C2}\uFE0F  Manage the installed prompt repo ${chalk24.dim("(status | pull/update | commit | push | save | path | open)")}`);
+repo.command("status").description(`\u{1F4CB} Show VCS status of the repo ${chalk24.dim("(branch, ahead/behind, changed files)")}`).addHelpText("after", `
 Example output:
   \u{1F4C2} ~/.set-prompt/repo
   \u{1F33F} main \u2192 origin/main (ahead 2)
@@ -2860,47 +3339,47 @@ Example output:
 `).action(() => {
   repoStatusCommand();
 });
-repo.command("pull").description(`\u{1F504} Fetch and pull the latest changes from the ${chalk23.cyan("remote repo")}`).action(() => {
+repo.command("pull").alias("update").description(`\u{1F504} Fetch and pull the latest changes from the ${chalk24.cyan("remote repo")}`).action(() => {
   repoPullCommand();
 });
-repo.command("commit").description(`\u{1F4DD} Stage all changes and commit ${chalk23.dim("(auto-generates message if -m omitted; does not push)")}`).option("-m, --message <msg>", "commit message (auto-generated from changed files if omitted)").addHelpText("after", `
+repo.command("commit").description(`\u{1F4DD} Stage all changes and commit ${chalk24.dim("(auto-generates message if -m omitted; does not push)")}`).option("-m, --message <msg>", "commit message (auto-generated from changed files if omitted)").addHelpText("after", `
 Examples:
   $ sppt repo commit -m "edit dbml skill"
-  $ sppt repo commit                          ${chalk23.dim('# auto-generates "update N files" + file list')}
+  $ sppt repo commit                          ${chalk24.dim('# auto-generates "update N files" + file list')}
 `).action((opts) => {
   repoCommitCommand({ message: opts.message });
 });
 repo.command("push").description(`\u2B06\uFE0F  Push local commits to the remote`).action(() => {
   repoPushCommand();
 });
-repo.command("save").description(`\u{1F4BE} Stage + commit + push in one step ${chalk23.dim("(macro for commit \u2192 push; auto-generates message if -m omitted)")}`).option("-m, --message <msg>", "commit message (auto-generated from changed files if omitted)").addHelpText("after", `
+repo.command("save").description(`\u{1F4BE} Stage + commit + push in one step ${chalk24.dim("(macro for commit \u2192 push; auto-generates message if -m omitted)")}`).option("-m, --message <msg>", "commit message (auto-generated from changed files if omitted)").addHelpText("after", `
 Examples:
   $ sppt repo save -m "edit dbml skill"
-  $ sppt repo save                            ${chalk23.dim("# auto-generates message and pushes")}
+  $ sppt repo save                            ${chalk24.dim("# auto-generates message and pushes")}
 
 Equivalent to: sppt repo commit && sppt repo push
 `).action((opts) => {
   repoSaveCommand({ message: opts.message });
 });
-repo.command("path").description(`\u{1F4CD} Print the repo path to stdout ${chalk23.dim("(e.g. cd $(sppt repo path))")}`).addHelpText("after", `
+repo.command("path").description(`\u{1F4CD} Print the repo path to stdout ${chalk24.dim("(e.g. cd $(sppt repo path))")}`).addHelpText("after", `
 Examples:
   $ sppt repo path
-  ${chalk23.dim("/Users/me/.set-prompt/repo")}
+  ${chalk24.dim("/Users/me/.set-prompt/repo")}
 
-  $ cd "$(sppt repo path)"                    ${chalk23.dim("# jump into the repo")}
-  $ code "$(sppt repo path)"                  ${chalk23.dim("# open in VSCode")}
+  $ cd "$(sppt repo path)"                    ${chalk24.dim("# jump into the repo")}
+  $ code "$(sppt repo path)"                  ${chalk24.dim("# open in VSCode")}
 `).action(() => {
   repoPathCommand();
 });
-repo.command("open").description(`\u{1F4C2} Open the repo in the OS file manager ${chalk23.dim("(--code: VSCode, --stree: Sourcetree)")}`).option("--code", "open with VSCode (`code` CLI)").option("--stree", "open with Sourcetree (`stree` CLI)").addHelpText("after", `
+repo.command("open").description(`\u{1F4C2} Open the repo in the OS file manager ${chalk24.dim("(--code: VSCode, --stree: Sourcetree)")}`).option("--code", "open with VSCode (`code` CLI)").option("--stree", "open with Sourcetree (`stree` CLI)").addHelpText("after", `
 Examples:
-  $ sppt repo open                            ${chalk23.dim("# Explorer / Finder / xdg-open")}
-  $ sppt repo open --code                     ${chalk23.dim("# open in VSCode")}
-  $ sppt repo open --stree                    ${chalk23.dim("# open in Sourcetree")}
+  $ sppt repo open                            ${chalk24.dim("# Explorer / Finder / xdg-open")}
+  $ sppt repo open --code                     ${chalk24.dim("# open in VSCode")}
+  $ sppt repo open --stree                    ${chalk24.dim("# open in Sourcetree")}
 `).action((opts) => {
   repoOpenCommand({ code: opts.code, stree: opts.stree });
 });
-program.command("uninstall").description(`\u{1F5D1}\uFE0F  Remove all set-prompt data ${chalk23.dim("(~/.set-prompt/, plugin dirs, settings entries)")}`).action(async () => {
+program.command("uninstall").description(`\u{1F5D1}\uFE0F  Remove all set-prompt data ${chalk24.dim("(~/.set-prompt/, plugin dirs, settings entries)")}`).action(async () => {
   await uninstallCommand();
 });
 program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "set-prompt",
-    "version": "0.7.1",
+    "version": "0.8.1",
     "description": "One repo. Every AI coding tool. Always in sync.",
     "main": "dist/index.js",
     "bin": {
@@ -14,6 +14,7 @@
     "scripts": {
         "start:dev": "tsx src/index.ts",
         "build": "rimraf dist && tsup",
+        "publish": "npm run build && npm publish",
         "test": "vitest --reporter=verbose"
     },
     "keywords": [
@@ -51,6 +52,7 @@
         "ora": "^9.3.0",
         "smol-toml": "^1.6.0",
         "typia": "^11.0.3",
+        "yaml": "^2.8.4",
         "zod": "^4.3.6"
     },
     "devDependencies": {