@pushary/agent-hooks 0.2.5 → 0.2.6

package/dist/bin/pushary-setup.js

@@ -5,6 +5,7 @@ import { existsSync, readFileSync, writeFileSync, appendFileSync, mkdirSync } fr
 import { join } from "path";
 import { homedir } from "os";
 import { createInterface } from "readline";
+import { execSync } from "child_process";
 var rl = createInterface({ input: process.stdin, output: process.stdout });
 var ask = (q) => new Promise((r) => rl.question(q, r));
 var CLAUDE_SETTINGS = join(homedir(), ".claude", "settings.json");
@@ -14,6 +15,8 @@ var dim = (s) => `\x1B[2m${s}\x1B[0m`;
 var bold = (s) => `\x1B[1m${s}\x1B[0m`;
 var green = (s) => `\x1B[32m${s}\x1B[0m`;
 var cyan = (s) => `\x1B[36m${s}\x1B[0m`;
+var yellow = (s) => `\x1B[33m${s}\x1B[0m`;
+var check = green("\u2713");
 var readJson = (path) => {
   try {
     return JSON.parse(readFileSync(path, "utf-8"));
@@ -26,38 +29,56 @@ var writeJson = (path, data) => {
   if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
   writeFileSync(path, JSON.stringify(data, null, 2) + "\n", "utf-8");
 };
-var setupClaudeCode = async (apiKey) => {
-  console.log(`
-${bold("Claude Code Setup")}
+var spinner = async (label, fn) => {
+  const frames = ["   ", ".  ", ".. ", "..."];
+  let i = 0;
+  const interval = setInterval(() => {
+    process.stdout.write(`\r  ${dim(frames[i++ % frames.length])} ${label}`);
+  }, 200);
+  try {
+    await fn();
+    clearInterval(interval);
+    process.stdout.write(`\r  ${check} ${label}
 `);
-  const settings = readJson(CLAUDE_SETTINGS);
+  } catch (err) {
+    clearInterval(interval);
+    process.stdout.write(`\r  ${yellow("!")} ${label} ${dim("(skipped)")}
+`);
+  }
+};
+var installGlobally = async () => {
+  await spinner("Installing pushary-hook globally", async () => {
+    execSync("npm install -g @pushary/agent-hooks@latest", { stdio: "ignore" });
+  });
+};
+var addMcpServer = (settings, apiKey) => {
   const mcpServers = settings.mcpServers ?? {};
   mcpServers.pushary = {
     url: "https://pushary.com/api/mcp/mcp",
     headers: { Authorization: `Bearer ${apiKey}` }
   };
   settings.mcpServers = mcpServers;
-  const addHooks = await ask(`Add permission hooks? (approve/deny tools from your phone) ${dim("[Y/n]")} `);
-  if (addHooks.toLowerCase() !== "n") {
-    const hooks = settings.hooks ?? {};
-    const preToolUse = hooks.PreToolUse ?? [];
-    const alreadyHasPushary = JSON.stringify(preToolUse).includes("pushary-hook");
-    if (!alreadyHasPushary) {
-      preToolUse.push({
-        matcher: "Bash|Write|Edit",
-        hooks: [{
-          type: "command",
-          command: "pushary-hook",
-          timeout: 120
-        }]
-      });
-      hooks.PreToolUse = preToolUse;
-      settings.hooks = hooks;
-    }
+};
+var addPermissionHooks = (settings) => {
+  const hooks = settings.hooks ?? {};
+  const preToolUse = hooks.PreToolUse ?? [];
+  if (!JSON.stringify(preToolUse).includes("pushary-hook")) {
+    preToolUse.push({
+      matcher: "Bash|Write|Edit",
+      hooks: [{
+        type: "command",
+        command: "pushary-hook",
+        timeout: 120
+      }]
+    });
+    hooks.PreToolUse = preToolUse;
+    settings.hooks = hooks;
   }
+};
+var addToolPermissions = (settings) => {
   const permissions = settings.permissions ?? {};
   const allow = permissions.allow ?? [];
-  const pusharyTools = [
+  const tools = [
     "mcp__pushary__send_notification",
     "mcp__pushary__ask_user",
     "mcp__pushary__ask_user_yes_no",
@@ -67,52 +88,95 @@ ${bold("Claude Code Setup")}
     "mcp__pushary__get_subscriber",
     "mcp__pushary__count_subscribers"
   ];
-  for (const tool of pusharyTools) {
+  for (const tool of tools) {
     if (!allow.includes(tool)) allow.push(tool);
   }
   permissions.allow = allow;
   settings.permissions = permissions;
-  writeJson(CLAUDE_SETTINGS, settings);
-  console.log(`  ${green("done")} MCP server added to ${dim(CLAUDE_SETTINGS)}`);
-  console.log(`  ${green("done")} Pushary tools auto-allowed (no permission prompts)`);
-  if (settings.hooks) {
-    console.log(`  ${green("done")} Permission hooks configured`);
-  }
+};
+var setupClaudeCode = async (apiKey) => {
+  console.log(`
+  ${bold("Setting up Claude Code")}
+`);
+  const settings = readJson(CLAUDE_SETTINGS);
+  await spinner("Adding MCP server", async () => {
+    addMcpServer(settings, apiKey);
+  });
+  await spinner("Auto-allowing Pushary tools", async () => {
+    addToolPermissions(settings);
+  });
+  await installGlobally();
+  await spinner("Adding permission hooks (Bash, Write, Edit)", async () => {
+    addPermissionHooks(settings);
+  });
+  await spinner(`Writing ${CLAUDE_SETTINGS}`, async () => {
+    writeJson(CLAUDE_SETTINGS, settings);
+  });
+  console.log();
+  console.log(`  ${dim("What this configured:")}`);
+  console.log(`  ${dim("\u2022")} MCP server: your agent can send notifications and ask questions`);
+  console.log(`  ${dim("\u2022")} Permission hooks: approve Bash/Write/Edit from your phone`);
+  console.log(`  ${dim("\u2022")} Auto-allowed tools: no permission prompts for Pushary`);
+};
+var setupHermes = async (apiKey) => {
+  console.log(`
+  ${bold("Setting up Hermes Agent")}
+`);
+  await spinner("Installing hermes-plugin-pushary", async () => {
+    try {
+      execSync("pip install hermes-plugin-pushary", { stdio: "ignore" });
+    } catch {
+      try {
+        execSync("pip3 install hermes-plugin-pushary", { stdio: "ignore" });
+      } catch {
+        throw new Error("pip not found");
+      }
+    }
+  });
+  await spinner("Enabling plugin", async () => {
+    try {
+      execSync("hermes plugins enable pushary", { stdio: "ignore" });
+    } catch {
+    }
+  });
+  console.log();
+  console.log(`  ${dim("What this configured:")}`);
+  console.log(`  ${dim("\u2022")} Native tools: pushary_notify, pushary_ask, pushary_wait, pushary_cancel`);
+  console.log(`  ${dim("\u2022")} Auto-notifications: push alert when tools return errors`);
+  console.log(`  ${dim("\u2022")} Session alerts: opt-in with PUSHARY_AUTO_NOTIFY_SESSION_END=1`);
 };
 var setupCursor = async (apiKey) => {
   console.log(`
-${bold("Cursor Setup")}
+  ${bold("Setting up Cursor")}
 `);
-  const config = readJson(CURSOR_MCP);
-  const mcpServers = config.mcpServers ?? {};
-  mcpServers.pushary = {
-    url: "https://pushary.com/api/mcp/mcp",
-    headers: { Authorization: `Bearer ${apiKey}` }
-  };
-  config.mcpServers = mcpServers;
-  writeJson(CURSOR_MCP, config);
-  console.log(`  ${green("done")} MCP server added to ${dim(CURSOR_MCP)}`);
+  await spinner("Adding MCP server to .cursor/mcp.json", async () => {
+    const config = readJson(CURSOR_MCP);
+    const mcpServers = config.mcpServers ?? {};
+    mcpServers.pushary = {
+      url: "https://pushary.com/api/mcp/mcp",
+      headers: { Authorization: `Bearer ${apiKey}` }
+    };
+    config.mcpServers = mcpServers;
+    writeJson(CURSOR_MCP, config);
+  });
 };
-var saveApiKey = (apiKey) => {
-  const exportLine = `
+var saveApiKey = async (apiKey) => {
+  await spinner("Saving API key to shell profile", async () => {
+    const exportLine = `
 export PUSHARY_API_KEY="${apiKey}"
 `;
-  const shellFile = SHELL_FILES.find((f) => existsSync(f));
-  if (shellFile) {
-    const content = readFileSync(shellFile, "utf-8");
-    if (content.includes("PUSHARY_API_KEY")) {
-      console.log(`  ${dim("PUSHARY_API_KEY already in")} ${shellFile}`);
-    } else {
-      appendFileSync(shellFile, exportLine, "utf-8");
-      console.log(`  ${green("done")} Added PUSHARY_API_KEY to ${dim(shellFile)}`);
+    const shellFile = SHELL_FILES.find((f) => existsSync(f));
+    if (shellFile) {
+      const content = readFileSync(shellFile, "utf-8");
+      if (!content.includes("PUSHARY_API_KEY")) {
+        appendFileSync(shellFile, exportLine, "utf-8");
+      }
     }
-  }
-  process.env.PUSHARY_API_KEY = apiKey;
+    process.env.PUSHARY_API_KEY = apiKey;
+  });
 };
 var sendTestNotification = async (apiKey) => {
-  console.log(`
-${bold("Sending test notification...")}`);
-  try {
+  await spinner("Sending test notification", async () => {
     const response = await fetch("https://pushary.com/api/v1/server/send", {
       method: "POST",
       headers: {
@@ -124,72 +188,76 @@ ${bold("Sending test notification...")}`);
         body: "Your AI agent can now send you push notifications."
       })
     });
-    if (response.ok) {
-      const data = await response.json();
-      if (data.delivered && data.delivered > 0) {
-        console.log(`  ${green("done")} Check your phone!`);
-      } else {
-        console.log(`  ${dim("Notification sent but no subscribers found. Enable notifications on your phone at pushary.com first.")}`);
-      }
-    } else {
+    if (!response.ok) {
       const err = await response.json().catch(() => ({}));
-      console.log(`  ${dim(`Could not send: ${err.error ?? response.statusText}. Make sure you enabled notifications at pushary.com`)}`);
+      throw new Error(err.error ?? response.statusText);
     }
-  } catch {
-    console.log(`  ${dim("Could not reach Pushary API. Check your internet connection.")}`);
-  }
+    const data = await response.json();
+    if (!data.delivered || data.delivered === 0) {
+      throw new Error("no subscribers");
+    }
+  });
 };
 var main = async () => {
-  console.log(`
-${bold("Pushary Setup")}
-`);
-  console.log(`Push notifications for your AI coding agents.
-`);
-  const apiKey = await ask(`Paste your API key ${dim("(from pushary.com/dashboard/agent/settings)")}: `);
+  console.log();
+  console.log(`  ${bold("Pushary")} ${dim("v" + (process.env.npm_package_version ?? "0.2"))}`);
+  console.log(`  ${dim("Push notifications for AI coding agents")}`);
+  console.log();
+  console.log(`  ${dim("Get your API key at")} ${cyan("pushary.com/sign-up")}`);
+  console.log();
+  const apiKey = await ask(`  API key: `);
   if (!apiKey.trim() || !apiKey.includes(".")) {
-    console.log("\nInvalid API key. Get yours at https://pushary.com/sign-up?from=ai-coding\n");
+    console.log(`
+  ${yellow("!")} Invalid key format. Expected: pk_xxx.sk_xxx`);
+    console.log(`  ${dim("Get yours at")} ${cyan("https://pushary.com/sign-up?from=ai-coding")}
+`);
     rl.close();
     process.exit(1);
   }
   const trimmedKey = apiKey.trim();
-  console.log(`
-Which agents do you use?
-`);
-  console.log(`  1. ${cyan("Claude Code")}`);
-  console.log(`  2. ${cyan("Cursor")}`);
-  console.log(`  3. ${cyan("Both")}`);
-  console.log(`  4. ${cyan("Other")} ${dim("(just save the API key)")}`);
   console.log();
-  const choice = await ask(`Choice ${dim("[1-4]")}: `);
-  saveApiKey(trimmedKey);
+  console.log(`  ${bold("Which agent do you use?")}`);
+  console.log();
+  console.log(`  ${cyan("1.")} Claude Code  ${dim("MCP + permission hooks + auto-allowed tools")}`);
+  console.log(`  ${cyan("2.")} Hermes       ${dim("native plugin + auto-error notifications")}`);
+  console.log(`  ${cyan("3.")} Cursor       ${dim("MCP server")}`);
+  console.log(`  ${cyan("4.")} All          ${dim("configure everything")}`);
+  console.log(`  ${cyan("5.")} Other        ${dim("just save the API key")}`);
+  console.log();
+  const choice = await ask(`  Choice ${dim("[1-5]")}: `);
+  await saveApiKey(trimmedKey);
   switch (choice.trim()) {
     case "1":
       await setupClaudeCode(trimmedKey);
       break;
     case "2":
-      await setupCursor(trimmedKey);
+      await setupHermes(trimmedKey);
       break;
     case "3":
-      await setupClaudeCode(trimmedKey);
       await setupCursor(trimmedKey);
       break;
     case "4":
+      await setupClaudeCode(trimmedKey);
+      await setupHermes(trimmedKey);
+      await setupCursor(trimmedKey);
+      break;
+    case "5":
     default:
       break;
   }
-  const test = await ask(`
-Send a test notification? ${dim("[Y/n]")} `);
+  console.log();
+  const test = await ask(`  Send a test notification? ${dim("[Y/n]")} `);
   if (test.toLowerCase() !== "n") {
     await sendTestNotification(trimmedKey);
   }
-  console.log(`
-${green("Setup complete.")} Your agents will now send you push notifications.
-`);
-  console.log(`${dim("Next steps:")}`);
+  console.log();
+  console.log(`  ${green(bold("Setup complete."))}`);
+  console.log();
+  console.log(`  ${dim("Next:")}`);
   console.log(`  ${dim("1.")} Enable notifications on your phone at ${cyan("pushary.com")}`);
-  console.log(`  ${dim("2.")} Configure timeout policies at ${cyan("pushary.com/dashboard/agent/policies")}`);
-  console.log(`  ${dim("3.")} Start coding with your agent
-`);
+  console.log(`  ${dim("2.")} Restart your agent to load the new config`);
+  console.log(`  ${dim("3.")} Start coding \u2014 your agent will notify you automatically`);
+  console.log();
   rl.close();
 };
 main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pushary/agent-hooks",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "Permission hooks for AI coding agents — route tool approvals through Pushary push notifications",
   "author": "Pushary <business@pushary.com>",
   "homepage": "https://pushary.com",