@pushary/agent-hooks 0.61.0 → 0.62.1

package/dist/bin/pushary-setup.js

@@ -7,41 +7,54 @@ import {
   addPusharyHooks,
   addPusharyToolPermissions
 } from "../chunk-CAJZAFVS.js";
+import {
+  describeDetection,
+  detectAllAgents,
+  isDetected
+} from "../chunk-UXXRRXUS.js";
+import {
+  renderAgentInstructions,
+  renderProjectAgentInstructions,
+  writeInstructionBlock
+} from "../chunk-N7XJ4L2W.js";
 import {
   GEMINI_HOOK_BINARY,
+  addGeminiHooks,
+  addGeminiMcpServer
+} from "../chunk-E2U35RLD.js";
+import {
   addCodexHookTrust,
   addCodexHooks,
   addCodexMcpServer,
-  addGeminiHooks,
-  addGeminiMcpServer,
-  renderAgentInstructions,
-  renderProjectAgentInstructions,
-  writeInstructionBlock
-} from "../chunk-S4TFBJ5O.js";
+  codexConfigToml,
+  codexHome
+} from "../chunk-ER657KRJ.js";
 import {
   confirmAppConnection,
   connectDevice,
   connectViaAppPairing,
   printConnectInstructions,
   setHumanStream
-} from "../chunk-GX64YGU3.js";
+} from "../chunk-3O27ZSRE.js";
 import "../chunk-3EGEA4KH.js";
 import {
   parseFlags
 } from "../chunk-N4DA4CJB.js";
 import {
   KEY_FILE_MODE,
-  backupFile,
   exportLine,
+  writeKey
+} from "../chunk-COC6NPWG.js";
+import {
+  backupFile,
   readJsonSafe,
   writeFileAtomic,
-  writeJsonAtomic,
-  writeKey
-} from "../chunk-B26DNXCA.js";
+  writeJsonAtomic
+} from "../chunk-6MTNS63X.js";
 import {
   checkApiKey,
   describeKeyCheck
-} from "../chunk-UKNAAVEE.js";
+} from "../chunk-YJ7YZRVV.js";
 import {
   UsageError
 } from "../chunk-7QLSKOSU.js";
@@ -60,28 +73,38 @@ import {
   EXIT,
   getPackageVersion,
   renderCommandHelp
-} from "../chunk-SML23YOT.js";
+} from "../chunk-SP7OZXCQ.js";
 import {
   reportEvent
-} from "../chunk-VFBYRR2N.js";
-import "../chunk-RN3NOEJF.js";
+} from "../chunk-HIIBSYFJ.js";
 import "../chunk-HNTKTK5B.js";
 import {
   isValidApiKey
 } from "../chunk-DQAN3JQP.js";
+import "../chunk-RN3NOEJF.js";
 import "../chunk-2UMNXADU.js";
 
 // bin/pushary-setup.ts
-import { existsSync as existsSync2, readFileSync, writeFileSync, mkdirSync, cpSync, rmSync, renameSync } from "fs";
-import { join as join2, dirname, basename } from "path";
-import { homedir as homedir2, tmpdir } from "os";
-import { execSync as execSync3 } from "child_process";
+import { existsSync, readFileSync, writeFileSync, mkdirSync, cpSync, rmSync, renameSync } from "fs";
+import { join, dirname, basename } from "path";
+import { homedir, tmpdir } from "os";
+import { execSync as execSync2 } from "child_process";
 import { checkbox, input, confirm } from "@inquirer/prompts";
 import { fileURLToPath } from "url";
 import { parse as parseTOML, stringify as stringifyTOML } from "smol-toml";
 
 // src/setup/closing.ts
 var ACTIVITY_URL = "pushary.com/dashboard/agent/activity";
+var COMMAND_SURFACE = [
+  { command: "pushary status", summary: "what this machine is connected to" },
+  { command: "pushary mode", summary: "switch between ask, auto and notify-only" },
+  { command: "pushary wait", summary: "block until a pending question is answered" },
+  { command: "pushary stats", summary: "what your agents have been asking" },
+  { command: "pushary claude", summary: "run Claude Code with the Pushary wrapper" },
+  { command: "pushary doctor", summary: "check the install" }
+];
+var SURFACE_COLUMN = Math.max(...COMMAND_SURFACE.map((entry) => entry.command.length)) + 2;
+var renderCommandSurface = () => COMMAND_SURFACE.map((entry) => `${entry.command.padEnd(SURFACE_COLUMN)}${entry.summary}`);
 var nextSteps = (facts, reachable) => {
   const lines = [];
   if (facts.completed.includes("claude_code")) {
@@ -229,102 +252,18 @@ var parseSetupOptions = (input2) => {
   };
 };
 
-// src/setup/detect.ts
-import { execSync as execSync2 } from "child_process";
-import { existsSync } from "fs";
-import { homedir } from "os";
-import { join } from "path";
-var whichCommand = () => process.platform === "win32" ? "where" : "which";
-var binaryOnPath = (binary) => {
-  try {
-    execSync2(`${whichCommand()} ${binary}`, { stdio: "ignore", timeout: 5e3 });
-    return true;
-  } catch {
-    return false;
-  }
-};
-var defaultDeps = { onPath: binaryOnPath, exists: existsSync };
-var detectAgent = (probe, deps = defaultDeps) => {
-  const checked = [];
-  if (probe.binary) {
-    checked.push(`${whichCommand()} ${probe.binary}`);
-    if (deps.onPath(probe.binary)) {
-      return { kind: "installed", evidence: `${probe.binary} on PATH`, strong: true };
-    }
-  }
-  for (const path of probe.paths) {
-    checked.push(path);
-    if (deps.exists(path)) return { kind: "installed", evidence: path, strong: true };
-  }
-  for (const marker of probe.configMarkers) {
-    checked.push(marker);
-    if (deps.exists(marker)) return { kind: "installed", evidence: marker, strong: false };
-  }
-  if (probe.binary === null && probe.paths.length === 0 && probe.configMarkers.length === 0) {
-    return { kind: "unknown" };
-  }
-  return { kind: "not-found", checked };
-};
-var agentProbes = (home = homedir()) => ({
-  claude_code: {
-    binary: "claude",
-    // The native installer puts it here, outside a default non-login PATH.
-    paths: [join(home, ".local", "bin", "claude")],
-    configMarkers: [join(home, ".claude")]
-  },
-  codex: {
-    binary: "codex",
-    paths: [],
-    configMarkers: [process.env.CODEX_HOME?.trim() || join(home, ".codex")]
-  },
-  gemini_cli: {
-    binary: "gemini",
-    paths: [],
-    configMarkers: [join(home, ".gemini")]
-  },
-  hermes: {
-    binary: "hermes",
-    paths: [],
-    configMarkers: [join(home, ".hermes")]
-  },
-  cursor: {
-    // GUI editor. `cursor` on PATH only exists if the user ran "Install 'cursor'
-    // command in PATH" from the command palette, which most never do.
-    binary: "cursor",
-    paths: process.platform === "darwin" ? ["/Applications/Cursor.app"] : process.platform === "win32" ? [join(process.env.LOCALAPPDATA ?? join(home, "AppData", "Local"), "Programs", "cursor")] : ["/usr/share/cursor", join(home, ".local", "share", "cursor")],
-    configMarkers: [join(home, ".cursor")]
-  },
-  // "Other" is a set of printed instructions for any MCP or HTTP client. There is
-  // nothing to detect, and it must never be auto-selected.
-  custom: { binary: null, paths: [], configMarkers: [] }
-});
-var detectAllAgents = (deps = defaultDeps, home) => {
-  const probes = agentProbes(home);
-  return Object.keys(probes).map((agent) => ({
-    agent,
-    result: detectAgent(probes[agent], deps)
-  }));
-};
-var isDetected = (result) => result.kind === "installed";
-var shortenHome = (path, home = homedir()) => home && path.startsWith(home) ? `~${path.slice(home.length)}` : path;
-var describeDetection = (result, home) => {
-  if (result.kind !== "installed") return null;
-  const evidence = shortenHome(result.evidence, home);
-  return result.strong ? evidence : `${evidence}, config only`;
-};
-
 // bin/pushary-setup.ts
-var CLAUDE_SETTINGS = join2(homedir2(), ".claude", "settings.json");
-var CLAUDE_JSON = join2(homedir2(), ".claude.json");
-var CURSOR_PLUGIN_DIR = join2(homedir2(), ".cursor", "plugins", "local", "pushary");
-var CURSOR_USER_HOOKS = join2(homedir2(), ".cursor", "hooks.json");
-var CLAUDE_SKILL_DIR = join2(homedir2(), ".claude", "skills", "pushary");
-var CODEX_HOME = process.env.CODEX_HOME?.trim() || join2(homedir2(), ".codex");
-var CODEX_SKILL_DIR = join2(CODEX_HOME, "skills", "pushary");
-var CODEX_AGENTS_MD = join2(CODEX_HOME, "AGENTS.md");
-var GEMINI_SETTINGS = join2(homedir2(), ".gemini", "settings.json");
-var GEMINI_MD = join2(homedir2(), ".gemini", "GEMINI.md");
-var PUSHARY_CONFIG_FILE = join2(homedir2(), ".pushary", "config.json");
+var CLAUDE_SETTINGS = join(homedir(), ".claude", "settings.json");
+var CLAUDE_JSON = join(homedir(), ".claude.json");
+var CURSOR_PLUGIN_DIR = join(homedir(), ".cursor", "plugins", "local", "pushary");
+var CURSOR_USER_HOOKS = join(homedir(), ".cursor", "hooks.json");
+var CLAUDE_SKILL_DIR = join(homedir(), ".claude", "skills", "pushary");
+var CODEX_HOME = codexHome();
+var CODEX_SKILL_DIR = join(CODEX_HOME, "skills", "pushary");
+var CODEX_AGENTS_MD = join(CODEX_HOME, "AGENTS.md");
+var GEMINI_SETTINGS = join(homedir(), ".gemini", "settings.json");
+var GEMINI_MD = join(homedir(), ".gemini", "GEMINI.md");
+var PUSHARY_CONFIG_FILE = join(homedir(), ".pushary", "config.json");
 var manualSteps = [];
 var noteManual = (step) => {
   manualSteps.push(step);
@@ -361,7 +300,7 @@ var readKeyFromStdin = async (options) => {
 var isInstalled = (command) => {
   const whichCmd = process.platform === "win32" ? "where" : "which";
   try {
-    execSync3(`${whichCmd} ${command}`, { stdio: "ignore", timeout: 5e3 });
+    execSync2(`${whichCmd} ${command}`, { stdio: "ignore", timeout: 5e3 });
     return true;
   } catch {
     return false;
@@ -386,7 +325,7 @@ var readAgentJson = (filePath) => {
 };
 var writeJson = (filePath, data) => {
   const dir = dirname(filePath);
-  if (!existsSync2(dir)) mkdirSync(dir, { recursive: true });
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
   writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n", "utf-8");
 };
 var readAgentToml = (filePath) => {
@@ -466,21 +405,21 @@ var fetchSkillContent = async () => {
   if (_cachedSkillContent) return _cachedSkillContent;
   const __dirname = dirname(fileURLToPath(import.meta.url));
   const candidates = [
-    join2(__dirname, "..", "..", "data", "SKILL.md"),
-    join2(__dirname, "..", "data", "SKILL.md")
+    join(__dirname, "..", "..", "data", "SKILL.md"),
+    join(__dirname, "..", "data", "SKILL.md")
   ];
-  const source = candidates.find((path) => existsSync2(path));
+  const source = candidates.find((path) => existsSync(path));
   if (!source) throw new Error("packaged skill not found");
   _cachedSkillContent = readFileSync(source, "utf-8");
   return _cachedSkillContent;
 };
-var skillsCliInUse = () => isInstalled("skills") || existsSync2(join2(homedir2(), ".agents", "skills"));
+var skillsCliInUse = () => isInstalled("skills") || existsSync(join(homedir(), ".agents", "skills"));
 var installSkill = async (agent, fallbackDir) => {
   await spinner("Installing Pushary skill", async () => {
     if (skillsCliInUse() && installSkillViaSkillsCli(agent)) return;
     const content = await fetchSkillContent();
-    if (!existsSync2(fallbackDir)) mkdirSync(fallbackDir, { recursive: true });
-    writeFileSync(join2(fallbackDir, "SKILL.md"), content, "utf-8");
+    if (!existsSync(fallbackDir)) mkdirSync(fallbackDir, { recursive: true });
+    writeFileSync(join(fallbackDir, "SKILL.md"), content, "utf-8");
   });
 };
 var setupClaudeCode = async (apiKey) => {
@@ -517,40 +456,40 @@ var IS_WINDOWS = process.platform === "win32";
 var resolveHermesPython = () => {
   try {
     const probe = IS_WINDOWS ? "where hermes" : "command -v hermes";
-    const launcher = execSync3(probe, { encoding: "utf-8", stdio: "pipe", timeout: 5e3 }).split("\n")[0].trim();
+    const launcher = execSync2(probe, { encoding: "utf-8", stdio: "pipe", timeout: 5e3 }).split("\n")[0].trim();
     if (launcher && !IS_WINDOWS) {
       const shebang = readFileSync(launcher, "utf-8").split("\n", 1)[0];
       if (shebang.startsWith("#!")) {
         const interpreter = shebang.slice(2).trim().split(/\s+/)[0];
-        if (interpreter && /python/i.test(interpreter) && existsSync2(interpreter)) return interpreter;
+        if (interpreter && /python/i.test(interpreter) && existsSync(interpreter)) return interpreter;
       }
     }
   } catch {
   }
-  const venvRoot = join2(homedir2(), ".hermes", "hermes-agent", "venv");
-  const candidates = IS_WINDOWS ? [join2(venvRoot, "Scripts", "python.exe"), join2(venvRoot, "Scripts", "python3.exe")] : [join2(venvRoot, "bin", "python3"), join2(venvRoot, "bin", "python")];
-  return candidates.find(existsSync2) ?? null;
+  const venvRoot = join(homedir(), ".hermes", "hermes-agent", "venv");
+  const candidates = IS_WINDOWS ? [join(venvRoot, "Scripts", "python.exe"), join(venvRoot, "Scripts", "python3.exe")] : [join(venvRoot, "bin", "python3"), join(venvRoot, "bin", "python")];
+  return candidates.find(existsSync) ?? null;
 };
 var ensurePip = (python) => {
   try {
-    execSync3(`"${python}" -m pip --version`, { stdio: "ignore", timeout: 15e3 });
+    execSync2(`"${python}" -m pip --version`, { stdio: "ignore", timeout: 15e3 });
     return;
   } catch {
   }
   try {
-    execSync3(`"${python}" -m ensurepip --upgrade`, { stdio: "pipe", timeout: 6e4 });
+    execSync2(`"${python}" -m ensurepip --upgrade`, { stdio: "pipe", timeout: 6e4 });
   } catch {
   }
 };
 var enablePusharyPlugin = (python) => {
   const snippet = 'from hermes_cli.config import load_config, save_config; c = load_config(); p = c.get("plugins") if isinstance(c.get("plugins"), dict) else {}; e = p.get("enabled") if isinstance(p.get("enabled"), list) else []; p["enabled"] = (e + ["pushary"]) if "pushary" not in e else e; c["plugins"] = p; a = c.get("agent") if isinstance(c.get("agent"), dict) else {}; d = a.get("disabled_toolsets") if isinstance(a.get("disabled_toolsets"), list) else []; a["disabled_toolsets"] = (d + ["clarify"]) if "clarify" not in d else d; c["agent"] = a; save_config(c)';
-  const scriptPath = join2(tmpdir(), `pushary-hermes-${process.pid}.py`);
+  const scriptPath = join(tmpdir(), `pushary-hermes-${process.pid}.py`);
   try {
     writeFileSync(scriptPath, snippet.split("; ").join("\n"), "utf-8");
-    execSync3(`"${python}" "${scriptPath}"`, { stdio: "pipe", timeout: 15e3 });
+    execSync2(`"${python}" "${scriptPath}"`, { stdio: "pipe", timeout: 15e3 });
     return;
   } catch {
-    execSync3("hermes plugins enable pushary", { stdio: "ignore", timeout: 1e4 });
+    execSync2("hermes plugins enable pushary", { stdio: "ignore", timeout: 1e4 });
   } finally {
     try {
       rmSync(scriptPath, { force: true });
@@ -575,7 +514,7 @@ var setupHermes = async (_apiKey) => {
   }
   await spinner("Installing hermes-plugin-pushary into Hermes\u2019 environment", async () => {
     ensurePip(python);
-    execSync3(`"${python}" -m pip install --upgrade hermes-plugin-pushary`, { stdio: "pipe", timeout: 18e4 });
+    execSync2(`"${python}" -m pip install --upgrade hermes-plugin-pushary`, { stdio: "pipe", timeout: 18e4 });
   });
   await spinner("Enabling plugin + routing questions to push", async () => {
     enablePusharyPlugin(python);
@@ -588,7 +527,7 @@ var setupHermes = async (_apiKey) => {
   console.log(`  ${dim("\u2022")} Permission gating: set ${bold("PUSHARY_GATE_TOOLS")} to require lock-screen approval for risky tools`);
   console.log(`  ${dim("To re-enable terminal prompts:")} remove ${bold("clarify")} from ${dim("agent.disabled_toolsets")} in ~/.hermes/config.yaml`);
 };
-var CODEX_HOOKS_JSON = join2(CODEX_HOME, "hooks.json");
+var CODEX_HOOKS_JSON = join(CODEX_HOME, "hooks.json");
 var CODEX_HOOKS_MIN_VERSION = [0, 122, 0];
 var CODEX_TRUST_VERIFIED_MAX = [0, 142, 2];
 var parseCodexVersion = (raw) => {
@@ -604,7 +543,7 @@ var compareCodexVersion = (a, b) => {
 };
 var readCodexVersion = () => {
   try {
-    return parseCodexVersion(execSync3("codex --version", { encoding: "utf-8", stdio: "pipe", timeout: 1e4 }));
+    return parseCodexVersion(execSync2("codex --version", { encoding: "utf-8", stdio: "pipe", timeout: 1e4 }));
   } catch {
     return null;
   }
@@ -655,7 +594,7 @@ var setupCodex = async (apiKey) => {
     return "skipped";
   }
   await installGlobally2();
-  const codexConfig = join2(homedir2(), ".codex", "config.toml");
+  const codexConfig = codexConfigToml();
   await spinner("Adding Pushary MCP server (key embedded, auto-allowed)", async () => {
     const config = readAgentToml(codexConfig);
     addCodexMcpServer(config, apiKey);
@@ -731,19 +670,19 @@ var setupCodex = async (apiKey) => {
 var resolveBundledPlugin = () => {
   const dir = dirname(fileURLToPath(import.meta.url));
   const candidates = [
-    join2(dir, "..", "..", "data", "cursor-plugin"),
-    join2(dir, "..", "data", "cursor-plugin"),
-    join2(dir, "..", "..", "..", "cursor-plugin"),
-    join2(dir, "..", "..", "cursor-plugin")
+    join(dir, "..", "..", "data", "cursor-plugin"),
+    join(dir, "..", "data", "cursor-plugin"),
+    join(dir, "..", "..", "..", "cursor-plugin"),
+    join(dir, "..", "..", "cursor-plugin")
   ];
-  return candidates.find((p) => existsSync2(join2(p, ".cursor-plugin", "plugin.json"))) ?? null;
+  return candidates.find((p) => existsSync(join(p, ".cursor-plugin", "plugin.json"))) ?? null;
 };
 var installCursorUserHooks = (gateScript) => {
-  const template = readJson(join2(CURSOR_PLUGIN_DIR, "hooks", "hooks.json")).hooks?.beforeShellExecution?.[0];
+  const template = readJson(join(CURSOR_PLUGIN_DIR, "hooks", "hooks.json")).hooks?.beforeShellExecution?.[0];
   if (!template) throw new Error("bundled Cursor hooks.json missing a beforeShellExecution entry");
   const entry = { ...template, command: `node "${gateScript}"` };
   let userHooks = {};
-  if (existsSync2(CURSOR_USER_HOOKS)) {
+  if (existsSync(CURSOR_USER_HOOKS)) {
     try {
       userHooks = JSON.parse(readFileSync(CURSOR_USER_HOOKS, "utf-8"));
     } catch {
@@ -761,8 +700,8 @@ var installCursorUserHooks = (gateScript) => {
   writeJson(CURSOR_USER_HOOKS, { ...userHooks, version: userHooks.version ?? 1, hooks });
 };
 var neutralizePluginGate = () => {
-  const path = join2(CURSOR_PLUGIN_DIR, "hooks", "hooks.json");
-  if (!existsSync2(path)) return;
+  const path = join(CURSOR_PLUGIN_DIR, "hooks", "hooks.json");
+  if (!existsSync(path)) return;
   const data = readJson(path);
   if (data.hooks && "beforeShellExecution" in data.hooks) {
     delete data.hooks.beforeShellExecution;
@@ -776,7 +715,7 @@ var setupCursor = async (apiKey) => {
   const source = resolveBundledPlugin();
   if (!source) throw new Error("bundled Cursor plugin not found in this package");
   await spinner("Installing Pushary plugin", async () => {
-    const staging = join2(dirname(CURSOR_PLUGIN_DIR), `.pushary-staging-${process.pid}`);
+    const staging = join(dirname(CURSOR_PLUGIN_DIR), `.pushary-staging-${process.pid}`);
     const backup = `${CURSOR_PLUGIN_DIR}.pushary-backup-${(/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-")}`;
     rmSync(staging, { recursive: true, force: true });
     try {
@@ -784,11 +723,11 @@ var setupCursor = async (apiKey) => {
         recursive: true,
         filter: (p) => !["tools", "node_modules", ".git", ".DS_Store"].includes(basename(p))
       });
-      const staged = readJsonSafe(join2(staging, ".cursor-plugin", "plugin.json"));
+      const staged = readJsonSafe(join(staging, ".cursor-plugin", "plugin.json"));
       if (staged.kind !== "ok") {
         throw new Error("staged Cursor plugin is missing or has an unreadable plugin.json");
       }
-      const hadExisting = existsSync2(CURSOR_PLUGIN_DIR);
+      const hadExisting = existsSync(CURSOR_PLUGIN_DIR);
       if (hadExisting) renameSync(CURSOR_PLUGIN_DIR, backup);
       try {
         renameSync(staging, CURSOR_PLUGIN_DIR);
@@ -802,7 +741,7 @@ var setupCursor = async (apiKey) => {
     }
   });
   await spinner("Linking your API key", async () => {
-    const mcpPath = join2(CURSOR_PLUGIN_DIR, "mcp.json");
+    const mcpPath = join(CURSOR_PLUGIN_DIR, "mcp.json");
     const mcp = readAgentJson(mcpPath);
     const servers = mcp.mcpServers ?? {};
     if (servers.pushary) {
@@ -812,7 +751,7 @@ var setupCursor = async (apiKey) => {
     }
   });
   await spinner("Registering permission gate (~/.cursor/hooks.json)", async () => {
-    installCursorUserHooks(join2(CURSOR_PLUGIN_DIR, "scripts", "pushary-gate.mjs"));
+    installCursorUserHooks(join(CURSOR_PLUGIN_DIR, "scripts", "pushary-gate.mjs"));
     neutralizePluginGate();
   });
   console.log();
@@ -931,8 +870,8 @@ var offerProjectInstructions = async (agents, options) => {
   });
   if (!wanted) return;
   for (const target of targets) {
-    await spinner(`Writing managed block to ${join2(process.cwd(), target.file)}`, async () => {
-      writeInstructionBlock(join2(process.cwd(), target.file), renderProjectAgentInstructions(target.label));
+    await spinner(`Writing managed block to ${join(process.cwd(), target.file)}`, async () => {
+      writeInstructionBlock(join(process.cwd(), target.file), renderProjectAgentInstructions(target.label));
     }, { optional: true });
   }
   console.log(`  ${dim("Commit the file to share it. Teammates without a key fall back to the terminal.")}`);
@@ -1054,11 +993,11 @@ var resolveAgents = async (options) => {
   });
 };
 var AGENT_TARGETS = {
-  claude_code: [CLAUDE_JSON, CLAUDE_SETTINGS, join2(CLAUDE_SKILL_DIR, "SKILL.md")],
-  codex: [join2(CODEX_HOME, "config.toml"), CODEX_HOOKS_JSON, join2(CODEX_SKILL_DIR, "SKILL.md"), CODEX_AGENTS_MD],
+  claude_code: [CLAUDE_JSON, CLAUDE_SETTINGS, join(CLAUDE_SKILL_DIR, "SKILL.md")],
+  codex: [join(CODEX_HOME, "config.toml"), CODEX_HOOKS_JSON, join(CODEX_SKILL_DIR, "SKILL.md"), CODEX_AGENTS_MD],
   gemini_cli: [GEMINI_SETTINGS, GEMINI_MD],
   hermes: ["the Hermes virtualenv (pip install pushary-hermes)"],
-  cursor: [join2(CURSOR_PLUGIN_DIR, "mcp.json"), CURSOR_USER_HOOKS],
+  cursor: [join(CURSOR_PLUGIN_DIR, "mcp.json"), CURSOR_USER_HOOKS],
   custom: ["nothing (prints connection details only)"]
 };
 var reportDryRun = (apiKey, agents, keyCheck) => {
@@ -1305,6 +1244,9 @@ var main = async () => {
   console.log();
   for (const line of closing.next) console.log(`  ${line}`);
   console.log();
+  console.log(`  ${dim("Useful:")}`);
+  for (const line of renderCommandSurface()) console.log(`  ${dim(line)}`);
+  console.log();
   const exitCode = closing.exitCode;
   emitJson(options, {
     ok: closing.ok,

package/dist/bin/pushary-stats.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   exitOnHelpFlag
-} from "../chunk-HUJQSP4F.js";
-import "../chunk-SML23YOT.js";
+} from "../chunk-IIZZYUWK.js";
+import "../chunk-SP7OZXCQ.js";
 import {
   readLedgerSummary
 } from "../chunk-WLGEY4UX.js";

package/dist/bin/pushary-status.js

@@ -3,15 +3,16 @@ import {
   describeReach,
   fetchChannels,
   reachVerdict
-} from "../chunk-GX64YGU3.js";
+} from "../chunk-3O27ZSRE.js";
 import "../chunk-3EGEA4KH.js";
 import {
   readKeySource
-} from "../chunk-B26DNXCA.js";
+} from "../chunk-COC6NPWG.js";
+import "../chunk-6MTNS63X.js";
 import {
   checkApiKey,
   describeKeyCheck
-} from "../chunk-UKNAAVEE.js";
+} from "../chunk-YJ7YZRVV.js";
 import {
   createIo
 } from "../chunk-TX7KBKT7.js";
@@ -19,10 +20,10 @@ import "../chunk-7QLSKOSU.js";
 import "../chunk-BC3VCZ3E.js";
 import {
   exitOnHelpFlag
-} from "../chunk-HUJQSP4F.js";
+} from "../chunk-IIZZYUWK.js";
 import {
   EXIT
-} from "../chunk-SML23YOT.js";
+} from "../chunk-SP7OZXCQ.js";
 import "../chunk-HNTKTK5B.js";
 import "../chunk-DQAN3JQP.js";
 import "../chunk-2UMNXADU.js";

package/dist/bin/pushary-stop-hook.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   handleStop
-} from "../chunk-VFBYRR2N.js";
-import "../chunk-RN3NOEJF.js";
+} from "../chunk-HIIBSYFJ.js";
 import "../chunk-HNTKTK5B.js";
 import "../chunk-DQAN3JQP.js";
+import "../chunk-RN3NOEJF.js";
 import "../chunk-2UMNXADU.js";
 
 // bin/pushary-stop-hook.ts

package/dist/bin/pushary-stopfailure-hook.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   handleStopFailure
-} from "../chunk-VFBYRR2N.js";
-import "../chunk-RN3NOEJF.js";
+} from "../chunk-HIIBSYFJ.js";
 import "../chunk-HNTKTK5B.js";
 import "../chunk-DQAN3JQP.js";
+import "../chunk-RN3NOEJF.js";
 import "../chunk-2UMNXADU.js";
 
 // bin/pushary-stopfailure-hook.ts

package/dist/bin/pushary-suggestions.js

@@ -4,8 +4,8 @@ import {
 } from "../chunk-TX7KBKT7.js";
 import {
   exitOnHelpFlag
-} from "../chunk-HUJQSP4F.js";
-import "../chunk-SML23YOT.js";
+} from "../chunk-IIZZYUWK.js";
+import "../chunk-SP7OZXCQ.js";
 import {
   getApiKey,
   getBaseUrl