agent-noti 1.0.0

package/README.md

@@ -0,0 +1,54 @@
+# agent-noti
+
+Audio notifications for Claude Code. Hear when Claude is done or needs your input.
+
+Works on macOS, Linux, and Windows.
+
+## Install
+
+```sh
+npm install -g agent-noti
+```
+
+That's it. Hooks are added automatically. Restart Claude Code.
+
+## What it does
+
+- **Claude finishes** → plays `idle.mp3`
+- **Claude needs input** (permission request) → plays `input.mp3`
+
+## Commands
+
+```sh
+agent-noti test        # Play both sounds
+agent-noti install     # Re-add hooks (if needed)
+agent-noti uninstall   # Remove hooks
+```
+
+## Uninstall
+
+```sh
+npm uninstall -g agent-noti
+```
+
+Hooks are removed automatically.
+
+## Custom sounds
+
+Replace the mp3 files in the package's `sounds/` directory:
+
+```sh
+agent-noti test  # find where sounds are located
+```
+
+## Platform support
+
+| OS | Audio player |
+|---|---|
+| macOS | `afplay` (built-in) |
+| Linux | `ffplay`, `paplay`, or `mpv` |
+| Windows | PowerShell MediaPlayer |
+
+## License
+
+MIT

package/bin/cli.mjs

@@ -0,0 +1,106 @@
+#!/usr/bin/env node
+
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
+import { join, dirname } from "path";
+import { execSync } from "child_process";
+import { fileURLToPath } from "url";
+import { homedir } from "os";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PKG_ROOT = join(__dirname, "..");
+const PLAY_SCRIPT = join(__dirname, "play.mjs");
+const SETTINGS_PATH = join(homedir(), ".claude", "settings.json");
+
+const HOOK_ID = "agent-noti";
+
+function buildHooks() {
+  const idle = { type: "command", command: `node "${PLAY_SCRIPT}" idle` };
+  const input = { type: "command", command: `node "${PLAY_SCRIPT}" input` };
+
+  return {
+    Stop: [{ hooks: [idle], metadata: { id: HOOK_ID } }],
+    PermissionRequest: [{ hooks: [input], metadata: { id: HOOK_ID } }],
+  };
+}
+
+function readSettings() {
+  const dir = dirname(SETTINGS_PATH);
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+  if (!existsSync(SETTINGS_PATH)) return {};
+  return JSON.parse(readFileSync(SETTINGS_PATH, "utf-8"));
+}
+
+function writeSettings(settings) {
+  writeFileSync(SETTINGS_PATH, JSON.stringify(settings, null, 2) + "\n");
+}
+
+function removeOurHooks(hookEntries) {
+  if (!Array.isArray(hookEntries)) return hookEntries;
+  return hookEntries.filter((e) => !e.metadata || e.metadata.id !== HOOK_ID);
+}
+
+function install() {
+  const settings = readSettings();
+  if (!settings.hooks) settings.hooks = {};
+
+  for (const [event, entries] of Object.entries(buildHooks())) {
+    const existing = removeOurHooks(settings.hooks[event] || []);
+    settings.hooks[event] = [...existing, ...entries];
+  }
+
+  writeSettings(settings);
+
+  console.log("");
+  console.log("  agent-noti installed!");
+  console.log("  Restart Claude Code to activate.");
+  console.log("");
+  console.log("    agent-noti test        Play sounds");
+  console.log("    agent-noti uninstall   Remove hooks");
+  console.log("");
+}
+
+function uninstall() {
+  const settings = readSettings();
+  if (!settings.hooks) {
+    console.log("Nothing to uninstall.");
+    return;
+  }
+
+  for (const event of Object.keys(settings.hooks)) {
+    const cleaned = removeOurHooks(settings.hooks[event]);
+    if (cleaned.length === 0) delete settings.hooks[event];
+    else settings.hooks[event] = cleaned;
+  }
+
+  if (Object.keys(settings.hooks).length === 0) delete settings.hooks;
+  writeSettings(settings);
+
+  console.log("");
+  console.log("  agent-noti uninstalled!");
+  console.log("");
+}
+
+function test() {
+  console.log("");
+  for (const name of ["idle", "input"]) {
+    console.log(`  Playing: ${name}`);
+    execSync(`node "${PLAY_SCRIPT}" ${name}`, { stdio: "inherit" });
+    // Small pause between sounds
+    execSync(process.platform === "win32" ? "timeout /t 1 >nul" : "sleep 1");
+  }
+  console.log("");
+}
+
+const cmd = process.argv[2];
+
+switch (cmd) {
+  case "install":    install(); break;
+  case "uninstall":  uninstall(); break;
+  case "test":       test(); break;
+  default:
+    console.log("");
+    console.log("  agent-noti install     Add hooks to Claude Code");
+    console.log("  agent-noti uninstall   Remove hooks");
+    console.log("  agent-noti test        Play sounds");
+    console.log("");
+}

package/bin/play.mjs

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+/**
+ * Cross-platform audio player. Called directly by Claude Code hooks.
+ * Usage: node play.mjs <idle|input>
+ */
+
+import { execFile, exec } from "child_process";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { platform } from "os";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const SOUNDS_DIR = join(__dirname, "..", "sounds");
+const sound = process.argv[2];
+
+if (!sound) process.exit(0);
+
+const file = join(SOUNDS_DIR, `${sound}.mp3`);
+const os = platform();
+
+if (os === "darwin") {
+  execFile("afplay", [file], () => {});
+} else if (os === "win32") {
+  exec(
+    `powershell -NoProfile -Command "Add-Type -AssemblyName PresentationCore; $p = New-Object System.Windows.Media.MediaPlayer; $p.Open([uri]'${file.replace(/'/g, "''")}'); $p.Play(); Start-Sleep -Seconds 3"`,
+    () => {}
+  );
+} else {
+  // Linux: try players in order
+  execFile("ffplay", ["-nodisp", "-autoexit", "-loglevel", "quiet", file], (err) => {
+    if (err) execFile("paplay", [file], (err2) => {
+      if (err2) execFile("mpv", ["--no-video", file], () => {});
+    });
+  });
+}

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "agent-noti",
+  "version": "1.0.0",
+  "description": "Audio notifications for Claude Code — hear when Claude is done or needs your input",
+  "bin": {
+    "agent-noti": "./bin/cli.mjs"
+  },
+  "files": [
+    "bin/",
+    "sounds/"
+  ],
+  "scripts": {
+    "postinstall": "node bin/cli.mjs install",
+    "preuninstall": "node bin/cli.mjs uninstall"
+  },
+  "os": ["darwin", "linux", "win32"],
+  "keywords": ["claude", "claude-code", "notifications", "audio", "hooks"],
+  "license": "MIT"
+}