@delorenj/claude-notifications 1.0.0

package/README.md

@@ -0,0 +1,208 @@
+# Claude Notifications 🔔
+
+Delightful audible notifications for Claude Code. Never alt+tab back to disappointment, thinking it was cranking away for 30-minutes on your task only to see a "Just double checking - you cool with this plan? Y/n"
+
+![Notification bar as seen in Ubuntu](claude-notification.png)
+
+## ⚡ Super Quick Install
+
+```bash
+npm install -g @delorenj/claude-notifications
+```
+
+That's it! 🎉 The package will automatically:
+
+- ✅ Install the notification system
+- 🎼 Generate a delightful notification scale
+- 🪝 Configure Claude Code stop hooks
+- 🧪 Test the installation
+
+## Features
+
+- 🎵 **Final Fantasy Dream Harp** - Classic C-D-E-G ascending/(optional)descending pattern
+- 🔊 **Cross-Platform Audio** - Works on Linux and macOS
+- 🖥️ **Desktop Notifications** - Visual notifications with Claude Code branding
+- 🪝 **Auto-Integration** - Automatically configures Claude Code hooks
+- ⚡ **Zero Configuration** - Works out of the box
+- 🎨 **Customizable** - Easy to modify sounds and settings
+
+## Usage
+
+After installation, Claude Code will begin notifying you when it finishes or is waiting on your response.
+
+### Manual Commands
+
+```bash
+# Trigger notification manually
+claude-notify
+
+# Test the system
+claude-notifications test
+
+# Reinstall/repair
+claude-notifications install
+
+# Get help
+claude-notifications help
+```
+
+## The Sound
+
+- **Pattern**: C1-D1-E1-G1-C2-D2-E2-G2-C3-G2-E2-D2-C2-G1-E1-D1-C1
+- **Duration**: ~2 seconds of dreamy notes
+
+## How It Works
+
+The package automatically:
+
+1. **Detects Claude Code** - Finds your Claude Code configuration
+2. **Adds Stop Hook** - Configures the notification trigger
+3. **Creates Sound** - Generates the sound using `sox`
+4. **Sets Up Commands** - Installs `claude-notify` globally
+
+### Claude Code Integration
+
+The installer automatically adds this to your Claude Code settings:
+
+```json
+{
+  "hooks": {
+    "Stop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "claude-notify"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+## Requirements
+
+- **Node.js** 14+ (you probably have this if you use Claude Code)
+- **Linux or macOS** (Windows support coming soon)
+- **Audio system** (PulseAudio, ALSA, or CoreAudio)
+
+### Auto-Installed Dependencies
+
+The package will automatically install:
+
+- `sox` for sound generation (Linux: apt/dnf, macOS: brew)
+- `node-notifier` for desktop notifications
+
+## Customization
+
+### Change the Sound
+
+Replace the generated sound file:
+
+```bash
+# Find the sound file
+ls ~/.local/share/sounds/claude-notification.wav
+
+# Replace with your own
+cp your-custom-sound.wav ~/.local/share/sounds/claude-notification.wav
+```
+
+### Create Custom Patterns
+
+Use `sox` to create new victory fanfares:
+
+> Note: Previously, a tedious chore I wouldn't recommend to a sane person. But now that we live in a fictional Blade Runner, Cyberpunk-inspired alternate timeline, just ask your robot buddy to do it!
+
+```bash
+# Simple ascending scale
+sox -n custom.wav synth 0.1 sine 261.63 : synth 0.1 sine 293.66 : synth 0.1 sine 329.63
+
+# Your imagination is the limit!
+```
+
+## Troubleshooting
+
+### No Sound?
+
+```bash
+# Test your audio system
+paplay /usr/share/sounds/alsa/Front_Left.wav  # Linux
+afplay /System/Library/Sounds/Glass.aiff      # macOS
+
+# Reinstall
+claude-notifications install
+```
+
+### No Notification?
+
+```bash
+# Test manually
+claude-notify
+
+# Check Claude Code config
+claude-notifications install  # Will show config location
+```
+
+### Command Not Found?
+
+```bash
+# Reinstall globally
+npm install -g @delorenj/claude-notifications
+
+# Or use npx
+npx @delorenj/claude-notifications test
+```
+
+## Uninstall
+
+```bash
+npm uninstall -g @delorenj/claude-notifications
+```
+
+The uninstaller will clean up sound files and notify you about manual config cleanup.
+
+## Development
+
+### Local Development
+
+```bash
+git clone https://github.com/delorenj/claude-notifications.git
+cd claude-notifications
+npm link
+claude-notifications install
+```
+
+### Publishing
+
+```bash
+npm version patch
+npm publish
+```
+
+## Contributing
+
+PRs welcome! Especially for:
+
+- Windows support
+- More sound patterns
+- Better Claude Code detection
+- macOS improvements
+
+## License
+
+MIT License - Make it your own! 🎵
+
+---
+
+**Ready to level up your Claude Code experience?**
+
+```bash
+npm install -g @delorenj/claude-notifications
+```
+
+_Made with ❤️ for fellow developers of the world over.
+but mostly for me, who alt-tabs away into the night leaving techno-breadcrumb trails of unanswered and unfinished Claude Code tasks._
+
+🎮✨ **Enjoy!** ✨🎮

package/bin/claude-notifications.js

@@ -0,0 +1,265 @@
+#!/usr/bin/env node
+
+const { execSync, spawn } = require("child_process");
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+
+const colors = {
+  red: "\x1b[31m",
+  green: "\x1b[32m",
+  yellow: "\x1b[33m",
+  blue: "\x1b[34m",
+  reset: "\x1b[0m",
+};
+
+function log(color, message) {
+  console.log(`${colors[color]}${message}${colors.reset}`);
+}
+
+function findClaudeCodeConfig() {
+  // Common Claude Code config locations
+  const possiblePaths = [
+    path.join(os.homedir(), ".claude", "config.json"),
+    path.join(os.homedir(), ".config", "claude", "config.json"),
+    path.join(os.homedir(), ".claude-code", "config.json"),
+    path.join(os.homedir(), ".config", "claude-code", "config.json"),
+  ];
+
+  for (const configPath of possiblePaths) {
+    if (fs.existsSync(configPath)) {
+      return configPath;
+    }
+  }
+  return null;
+}
+
+function updateClaudeCodeConfig() {
+  const configPath = findClaudeCodeConfig();
+
+  if (!configPath) {
+    log("yellow", "⚠️  Could not find Claude Code config file.");
+    log(
+      "blue",
+      "💡 Please manually add the stop hook to your Claude Code settings:",
+    );
+    console.log(
+      JSON.stringify(
+        {
+          hooks: {
+            Stop: [
+              {
+                matcher: "",
+                hooks: [
+                  {
+                    type: "command",
+                    command: "claude-notify",
+                  },
+                ],
+              },
+            ],
+          },
+        },
+        null,
+        2,
+      ),
+    );
+    return;
+  }
+
+  try {
+    let config = {};
+    if (fs.existsSync(configPath)) {
+      const configContent = fs.readFileSync(configPath, "utf8");
+      config = JSON.parse(configContent);
+    }
+
+    // Add or update hooks
+    if (!config.hooks) config.hooks = {};
+    if (!config.hooks.Stop) config.hooks.Stop = [];
+
+    // Check if our hook already exists
+    const existingHook = config.hooks.Stop.find(
+      (hook) =>
+        hook.hooks && hook.hooks.some((h) => h.command === "claude-notify"),
+    );
+
+    if (!existingHook) {
+      config.hooks.Stop.push({
+        matcher: "",
+        hooks: [
+          {
+            type: "command",
+            command: "claude-notify",
+          },
+        ],
+      });
+
+      fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+      log("green", "✅ Added stop hook to Claude Code config!");
+    } else {
+      log("blue", "📝 Stop hook already exists in Claude Code config");
+    }
+  } catch (error) {
+    log("red", `❌ Error updating Claude Code config: ${error.message}`);
+  }
+}
+
+function createSoundFile() {
+  const soundDir = path.join(os.homedir(), ".local", "share", "sounds");
+  const soundFile = path.join(soundDir, "claude-notification.wav");
+
+  // Create directory if it doesn't exist
+  if (!fs.existsSync(soundDir)) {
+    fs.mkdirSync(soundDir, { recursive: true });
+  }
+
+  // Check if sox is available
+  try {
+    execSync("which sox", { stdio: "ignore" });
+  } catch (error) {
+    log("yellow", "⚠️  sox not found. Installing...");
+    try {
+      if (process.platform === "linux") {
+        execSync("sudo apt update && sudo apt install -y sox", {
+          stdio: "inherit",
+        });
+      } else if (process.platform === "darwin") {
+        execSync("brew install sox", { stdio: "inherit" });
+      }
+    } catch (installError) {
+      log("red", "❌ Could not install sox. Please install it manually.");
+      return false;
+    }
+  }
+
+  // Generate pleasant notification scale
+  log("blue", "🎼 Generating a pleasant notification scale...");
+
+  const soxCommand =
+    `sox -n "${soundFile}" ` +
+    "synth 0.12 sine 523.25 fade 0.01 0.12 0.01 : " +
+    "synth 0.12 sine 587.33 fade 0.01 0.12 0.01 : " +
+    "synth 0.12 sine 659.25 fade 0.01 0.12 0.01 : " +
+    "synth 0.12 sine 783.99 fade 0.01 0.12 0.01 : " +
+    "synth 0.12 sine 1046.50 fade 0.01 0.12 0.01 : " +
+    "synth 0.12 sine 1174.66 fade 0.01 0.12 0.01 : " +
+    "synth 0.12 sine 1318.51 fade 0.01 0.12 0.01 : " +
+    "synth 0.12 sine 1567.98 fade 0.01 0.12 0.01 : " +
+    "synth 0.12 sine 2093.00 fade 0.01 0.12 0.01 : " +
+    "synth 0.12 sine 1567.98 fade 0.01 0.12 0.01 : " +
+    "synth 0.12 sine 1318.51 fade 0.01 0.12 0.01 : " +
+    "synth 0.12 sine 1174.66 fade 0.01 0.12 0.01 : " +
+    "synth 0.12 sine 1046.50 fade 0.01 0.12 0.01 : " +
+    "synth 0.12 sine 783.99 fade 0.01 0.12 0.01 : " +
+    "synth 0.12 sine 659.25 fade 0.01 0.12 0.01 : " +
+    "synth 0.12 sine 587.33 fade 0.01 0.12 0.01 : " +
+    "synth 0.12 sine 523.25 fade 0.01 0.12 0.01 " +
+    "vol 0.7";
+
+  try {
+    execSync(soxCommand, { stdio: "ignore" });
+    log("green", "✅ Sound file created successfully!");
+    return true;
+  } catch (error) {
+    log("red", `❌ Error creating sound file: ${error.message}`);
+    return false;
+  }
+}
+
+function main() {
+  const command = process.argv[2];
+
+  switch (command) {
+    case "install":
+    case undefined:
+      log("blue", "🎵 Installing Claude Notifications...");
+
+      if (createSoundFile()) {
+        updateClaudeCodeConfig();
+        log("green", "🎉 Installation complete!");
+        log("blue", "🧪 Testing notification...");
+
+        // Test the notification
+        const testProcess = spawn(
+          "node",
+          [path.join(__dirname, "claude-notify.js")],
+          {
+            stdio: "inherit",
+          },
+        );
+
+        testProcess.on("close", () => {
+          log(
+            "green",
+            "✅ Test complete! You should have heard a dreamy notification!",
+          );
+          console.log("");
+          log("blue", "Usage:");
+          console.log(
+            "  claude-notify          # Trigger notification manually",
+          );
+          console.log("  claude-notifications   # This installer");
+          console.log("");
+          log(
+            "blue",
+            "Claude Code will now beckon you back with a pleasant notification when it finishes responses or is waiting for your input! 🎮",
+          );
+        });
+      }
+      break;
+
+    case "test":
+      log("blue", "🧪 Testing notification...");
+      spawn("node", [path.join(__dirname, "claude-notify.js")], {
+        stdio: "inherit",
+      });
+      break;
+
+    case "uninstall":
+      log("blue", "🗑️  Uninstalling Claude Notifications...");
+
+      const soundFile = path.join(
+        os.homedir(),
+        ".local",
+        "share",
+        "sounds",
+        "claude-notification.wav",
+      );
+      if (fs.existsSync(soundFile)) {
+        fs.unlinkSync(soundFile);
+        log("green", "✅ Removed sound file");
+      }
+
+      log(
+        "yellow",
+        "⚠️  Please manually remove the stop hook from your Claude Code config",
+      );
+      log("green", "🎉 Uninstallation complete!");
+      break;
+
+    case "help":
+    case "--help":
+    case "-h":
+      console.log("Notifications for Claude Code");
+      console.log("");
+      console.log("Usage:");
+      console.log("  claude-notifications [command]");
+      console.log("");
+      console.log("Commands:");
+      console.log("  install    Install notifications (default)");
+      console.log("  test       Test the notification");
+      console.log("  uninstall  Remove notifications");
+      console.log("  help       Show this help");
+      break;
+
+    default:
+      log("red", `❌ Unknown command: ${command}`);
+      log("blue", 'Run "claude-notifications help" for usage information');
+      process.exit(1);
+  }
+}
+
+if (require.main === module) {
+  main();
+}

package/bin/claude-notify.js

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+
+const { execSync, spawn } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+function playSound() {
+  const soundFile = path.join(os.homedir(), '.local', 'share', 'sounds', 'claude-notification.wav');
+  
+  if (!fs.existsSync(soundFile)) {
+    // Fallback to system bell
+    process.stdout.write('\x07');
+    return;
+  }
+
+  try {
+    // Try different audio players based on platform
+    if (process.platform === 'linux') {
+      // Try paplay first (PulseAudio)
+      try {
+        execSync(`paplay "${soundFile}"`, { stdio: 'ignore' });
+        return;
+      } catch (e) {
+        // Try aplay (ALSA)
+        try {
+          execSync(`aplay "${soundFile}"`, { stdio: 'ignore' });
+          return;
+        } catch (e2) {
+          // Try play (sox)
+          try {
+            execSync(`play "${soundFile}"`, { stdio: 'ignore' });
+            return;
+          } catch (e3) {
+            // Fallback to system bell
+            process.stdout.write('\x07');
+          }
+        }
+      }
+    } else if (process.platform === 'darwin') {
+      // macOS
+      try {
+        execSync(`afplay "${soundFile}"`, { stdio: 'ignore' });
+        return;
+      } catch (e) {
+        // Fallback to system bell
+        process.stdout.write('\x07');
+      }
+    } else {
+      // Other platforms - just system bell
+      process.stdout.write('\x07');
+    }
+  } catch (error) {
+    // Final fallback
+    process.stdout.write('\x07');
+  }
+}
+
+function showNotification() {
+  const notifier = require('node-notifier');
+  
+  notifier.notify({
+    title: 'Claude Code',
+    message: 'Waiting for you...',
+    icon: path.join(os.homedir(), 'Pictures', 'claude.png'), // Will fallback gracefully if not found
+    sound: false, // We handle sound separately
+    urgency: 'critical'
+  });
+}
+
+function main() {
+  // Play sound in background
+  playSound();
+  
+  // Show desktop notification
+  showNotification();
+}
+
+if (require.main === module) {
+  main();
+}

package/examples/claude-code-settings.json

@@ -0,0 +1,15 @@
+{
+  "hooks": {
+    "Stop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "claude-notify"
+          }
+        ]
+      }
+    ]
+  }
+}

package/index.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+
+// Main entry point for @delorenj/claude-notifications
+// This allows the package to be used programmatically as well
+
+const { spawn } = require('child_process');
+const path = require('path');
+
+function notify() {
+  return new Promise((resolve, reject) => {
+    const notifyProcess = spawn('node', [path.join(__dirname, 'bin', 'claude-notify.js')], {
+      stdio: 'inherit'
+    });
+    
+    notifyProcess.on('close', (code) => {
+      if (code === 0) {
+        resolve();
+      } else {
+        reject(new Error(`Notification failed with code ${code}`));
+      }
+    });
+  });
+}
+
+function install() {
+  return new Promise((resolve, reject) => {
+    const installProcess = spawn('node', [path.join(__dirname, 'bin', 'claude-notifications.js'), 'install'], {
+      stdio: 'inherit'
+    });
+    
+    installProcess.on('close', (code) => {
+      if (code === 0) {
+        resolve();
+      } else {
+        reject(new Error(`Installation failed with code ${code}`));
+      }
+    });
+  });
+}
+
+module.exports = {
+  notify,
+  install
+};
+
+// If called directly, run the CLI
+if (require.main === module) {
+  const command = process.argv[2] || 'install';
+  
+  if (command === 'notify') {
+    notify().catch(console.error);
+  } else {
+    install().catch(console.error);
+  }
+}

package/install.sh

@@ -0,0 +1,161 @@
+#!/bin/bash
+
+# Claude Code Notifications Installer
+# Installs a much needed notification system for Claude Code
+
+set -e
+
+echo "🎵 Installing Claude Code Notifications..."
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Check if we're on Linux
+if [[ "$OSTYPE" != "linux-gnu"* ]]; then
+  echo -e "${RED}❌ This installer is currently Linux-only. macOS support coming soon!${NC}"
+  exit 1
+fi
+
+# Create necessary directories
+echo -e "${BLUE}📁 Creating directories...${NC}"
+mkdir -p ~/.local/bin
+mkdir -p ~/.local/share/sounds
+
+# Check for required tools and install if needed
+echo -e "${BLUE}🔧 Checking dependencies...${NC}"
+
+# Check for sox
+if ! command -v sox &>/dev/null; then
+  echo -e "${YELLOW}⚠️  sox not found. Installing...${NC}"
+  if command -v apt &>/dev/null; then
+    sudo apt update && sudo apt install -y sox
+  elif command -v dnf &>/dev/null; then
+    sudo dnf install -y sox
+  elif command -v pacman &>/dev/null; then
+    sudo pacman -S sox
+  else
+    echo -e "${RED}❌ Could not install sox. Please install it manually.${NC}"
+    exit 1
+  fi
+fi
+
+# Check for notify-send
+if ! command -v notify-send &>/dev/null; then
+  echo -e "${YELLOW}⚠️  notify-send not found. Installing...${NC}"
+  if command -v apt &>/dev/null; then
+    sudo apt install -y libnotify-bin
+  elif command -v dnf &>/dev/null; then
+    sudo dnf install -y libnotify
+  elif command -v pacman &>/dev/null; then
+    sudo pacman -S libnotify
+  fi
+fi
+
+# Generate that sweet Final Fantasy scale
+echo -e "${BLUE}🎼 Generating dreamy notification sound...${NC}"
+sox -n ~/.local/share/sounds/claude-notification.wav \
+  synth 0.12 sine 523.25 fade 0.01 0.12 0.01 : \
+  synth 0.12 sine 587.33 fade 0.01 0.12 0.01 : \
+  synth 0.12 sine 659.25 fade 0.01 0.12 0.01 : \
+  synth 0.12 sine 783.99 fade 0.01 0.12 0.01 : \
+  synth 0.12 sine 1046.50 fade 0.01 0.12 0.01 : \
+  synth 0.12 sine 1174.66 fade 0.01 0.12 0.01 : \
+  synth 0.12 sine 1318.51 fade 0.01 0.12 0.01 : \
+  synth 0.12 sine 1567.98 fade 0.01 0.12 0.01 : \
+  synth 0.12 sine 2093.00 fade 0.01 0.12 0.01 :
+# Uncomment for the longer, more nostalgic version
+#    synth 0.12 sine 1567.98 fade 0.01 0.12 0.01 : \
+#    synth 0.12 sine 1318.51 fade 0.01 0.12 0.01 : \
+#    synth 0.12 sine 1174.66 fade 0.01 0.12 0.01 : \
+#    synth 0.12 sine 1046.50 fade 0.01 0.12 0.01 : \
+#    synth 0.12 sine 783.99 fade 0.01 0.12 0.01 : \
+#    synth 0.12 sine 659.25 fade 0.01 0.12 0.01 : \
+#    synth 0.12 sine 587.33 fade 0.01 0.12 0.01 : \
+#    synth 0.12 sine 523.25 fade 0.01 0.12 0.01 \
+vol 0.7
+
+# Create the claude-notify script
+echo -e "${BLUE}📝 Creating claude-notify script...${NC}"
+cat >~/.local/bin/claude-notify <<'EOF'
+#!/usr/bin/env bash
+
+# Claude Code notification script
+# Sends a desktop notification for Claude Code along with a dreamy notification sound
+
+# Play notification sound (try multiple methods for compatibility)
+play_sound() {
+    local sound_file="$HOME/.local/share/sounds/claude-notification.wav"
+    
+    # Try paplay first (PulseAudio - most common on Ubuntu)
+    if command -v paplay >/dev/null 2>&1 && [[ -f "$sound_file" ]]; then
+        paplay "$sound_file" 2>/dev/null &
+    # Fallback to aplay (ALSA)
+    elif command -v aplay >/dev/null 2>&1 && [[ -f "$sound_file" ]]; then
+        aplay "$sound_file" 2>/dev/null &
+    # Fallback to system sounds
+    elif command -v paplay >/dev/null 2>&1; then
+        paplay /usr/share/sounds/alsa/Front_Left.wav 2>/dev/null &
+    # Final fallback to system bell
+    else
+        printf '\a'
+    fi
+}
+
+# Play sound in background
+play_sound
+
+# Send desktop notification
+notify-send \
+    --app-name="Claude Code" \
+    --icon /home/clouedoc/Pictures/claude.png \
+    --urgency critical \
+    "Claude Code" \
+    "Waiting for you..."
+EOF
+
+# Make the script executable
+chmod +x ~/.local/bin/claude-notify
+
+# Add ~/.local/bin to PATH if not already there
+if [[ ":$PATH:" != *":$HOME/.local/bin:"* ]]; then
+  echo -e "${BLUE}🛤️  Adding ~/.local/bin to PATH...${NC}"
+
+  # Detect shell and add to appropriate config file
+  if [[ -n "$ZSH_VERSION" ]] || [[ "$SHELL" == *"zsh"* ]]; then
+    echo 'export PATH="$HOME/.local/bin:$PATH"' >>~/.zshrc
+    echo -e "${YELLOW}⚠️  Added to ~/.zshrc - restart your terminal or run: source ~/.zshrc${NC}"
+  elif [[ -n "$BASH_VERSION" ]] || [[ "$SHELL" == *"bash"* ]]; then
+    echo 'export PATH="$HOME/.local/bin:$PATH"' >>~/.bashrc
+    echo -e "${YELLOW}⚠️  Added to ~/.bashrc - restart your terminal or run: source ~/.bashrc${NC}"
+  else
+    echo -e "${YELLOW}⚠️  Please add ~/.local/bin to your PATH manually${NC}"
+  fi
+fi
+
+# Test the installation
+echo -e "${BLUE}🧪 Testing installation...${NC}"
+if command -v claude-notify &>/dev/null; then
+  echo -e "${GREEN}✅ claude-notify command is available!${NC}"
+  echo -e "${BLUE}🔊 Playing test notification...${NC}"
+  claude-notify
+else
+  echo -e "${YELLOW}⚠️  claude-notify not in PATH yet. Restart your terminal or source your shell config.${NC}"
+fi
+
+echo ""
+echo -e "${GREEN}🎉 Installation complete!${NC}"
+echo ""
+echo -e "${BLUE}Next steps:${NC}"
+echo "1. Test the notification: ${YELLOW}claude-notify${NC}"
+echo "2. Add to Claude Code settings (see README.md for JSON config)"
+echo "3. Never alt-tab back to a unexpected Y/n again! 🎵"
+echo ""
+echo -e "${BLUE}Configuration location:${NC}"
+echo "• Script: ~/.local/bin/claude-notify"
+echo "• Sound: ~/.local/share/sounds/claude-notification.wav"
+echo ""
+echo -e "${BLUE}Need help?${NC} Check the README.md for customization options!"

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@delorenj/claude-notifications",
+  "version": "1.0.0",
+  "description": "Delightful Notification for Claude Code",
+  "main": "index.js",
+  "bin": {
+    "claude-notifications": "./bin/claude-notifications.js",
+    "claude-notify": "./bin/claude-notify.js"
+  },
+  "scripts": {
+    "postinstall": "node postinstall.js",
+    "preuninstall": "node preuninstall.js",
+    "test": "node test.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/delorenj/claude-notifications.git"
+  },
+  "keywords": [
+    "claude-code",
+    "notifications",
+    "adhd",
+    "audio",
+    "desktop-notifications",
+    "linux",
+    "productivity",
+    "cli"
+  ],
+  "author": "Jarad DeLorenzo",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/delorenj/claude-notifications/issues"
+  },
+  "homepage": "https://github.com/delorenj/claude-notifications#readme",
+  "os": [
+    "linux",
+    "darwin"
+  ],
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "dependencies": {
+    "node-notifier": "^10.0.1",
+    "which": "^4.0.0"
+  },
+  "preferGlobal": true
+}

package/postinstall.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+
+const { spawn } = require("child_process");
+const path = require("path");
+
+console.log("🎵 Setting up Claude Notifications...");
+
+// Run the main installer
+const installer = spawn(
+  "node",
+  [path.join(__dirname, "bin", "claude-notifications.js"), "install"],
+  {
+    stdio: "inherit",
+  },
+);
+
+installer.on("close", (code) => {
+  if (code === 0) {
+    console.log("");
+    console.log("🎉 Claude Notifications installed successfully!");
+    console.log("");
+    console.log("Usage:");
+    console.log(
+      "  claude-notify                # Trigger notification manually",
+    );
+    console.log("  claude-notifications test    # Test the notification");
+    console.log("");
+    console.log(
+      "Claude Code will now beckon you back with a soothing scale! 🎮✨",
+    );
+  } else {
+    console.error("❌ Installation failed");
+    process.exit(code);
+  }
+});

package/preuninstall.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+
+const { spawn } = require('child_process');
+const path = require('path');
+
+console.log('🗑️  Cleaning up Claude Notifications...');
+
+// Run the uninstaller
+const uninstaller = spawn('node', [path.join(__dirname, 'bin', 'claude-notifications.js'), 'uninstall'], {
+  stdio: 'inherit'
+});
+
+uninstaller.on('close', (code) => {
+  console.log('👋 Thanks for using Claude Notifications!');
+});

package/test.sh

@@ -0,0 +1,20 @@
+#!/bin/bash
+
+# Test script for Claude Code Notifications
+
+echo "🧪 Testing Claude Code Notifications..."
+
+# Check if claude-notify exists
+if command -v claude-notify &> /dev/null; then
+    echo "✅ claude-notify command found"
+    
+    # Test the notification
+    echo "🔊 Playing test notification..."
+    claude-notify
+    
+    echo "✅ Test complete! Did you hear the Final Fantasy fanfare?"
+else
+    echo "❌ claude-notify command not found"
+    echo "💡 Try running ./install.sh first"
+    exit 1
+fi

package/uninstall.sh

@@ -0,0 +1,39 @@
+#!/bin/bash
+
+# Claude Code Notifications Uninstaller
+
+set -e
+
+echo "🗑️  Uninstalling Claude Code Notifications..."
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Remove the script
+if [[ -f ~/.local/bin/claude-notify ]]; then
+    rm ~/.local/bin/claude-notify
+    echo -e "${GREEN}✅ Removed claude-notify script${NC}"
+else
+    echo -e "${YELLOW}⚠️  claude-notify script not found${NC}"
+fi
+
+# Remove the sound file
+if [[ -f ~/.local/share/sounds/claude-notification.wav ]]; then
+    rm ~/.local/share/sounds/claude-notification.wav
+    echo -e "${GREEN}✅ Removed notification sound${NC}"
+else
+    echo -e "${YELLOW}⚠️  Notification sound not found${NC}"
+fi
+
+echo ""
+echo -e "${GREEN}🎉 Uninstallation complete!${NC}"
+echo ""
+echo -e "${BLUE}Note:${NC} You may want to:"
+echo "• Remove the Claude Code stop hook from your settings"
+echo "• Remove PATH modification from your shell config (if added)"
+echo ""
+echo -e "${BLUE}Thanks for using Claude Code Notifications! 🎵${NC}"