@yeongjaeyou/claude-code-config 0.12.0 → 0.13.0

package/.claude/hooks/notify_osc.sh

@@ -0,0 +1,53 @@
+#!/bin/bash
+# Claude Code OSC Notification Script
+# /dev/tty로 출력하여 터미널에 직접 전달
+
+# stdin에서 JSON 읽기 (timeout으로 blocking 방지)
+INPUT=$(timeout 1 cat 2>/dev/null || true)
+
+# JSON 파싱
+if command -v jq &>/dev/null && [ -n "$INPUT" ]; then
+    SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // empty' 2>/dev/null)
+    CWD=$(echo "$INPUT" | jq -r '.cwd // empty' 2>/dev/null)
+    EVENT=$(echo "$INPUT" | jq -r '.hook_event_name // empty' 2>/dev/null)
+    NOTIF_TYPE=$(echo "$INPUT" | jq -r '.notification_type // empty' 2>/dev/null)
+    MESSAGE=$(echo "$INPUT" | jq -r '.message // empty' 2>/dev/null)
+
+    FOLDER=$(basename "${CWD:-$PWD}" 2>/dev/null)
+    SHORT_ID="${SESSION_ID:0:8}"
+
+    # 제목 구성
+    TITLE="Claude"
+    [ -n "$FOLDER" ] && TITLE="$TITLE - $FOLDER"
+    [ -n "$SHORT_ID" ] && TITLE="$TITLE [$SHORT_ID]"
+
+    # 본문 구성
+    case "$EVENT" in
+        "Stop")
+            BODY="Task completed"
+            ;;
+        "Notification")
+            case "$NOTIF_TYPE" in
+                "permission_prompt") BODY="Permission needed" ;;
+                "idle_prompt") BODY="Waiting for input" ;;
+                *) BODY="${MESSAGE:-$NOTIF_TYPE}" ;;
+            esac
+            ;;
+        *)
+            BODY="${MESSAGE:-Notification}"
+            ;;
+    esac
+else
+    TITLE="${1:-Claude Code}"
+    BODY="${2:-Task completed}"
+fi
+
+# OSC 777 알림 출력 (OSC 9는 중복 알림 발생하므로 제외)
+# /dev/tty 사용 가능 시 직접 출력, 아니면 stdout
+{
+    printf '\033]777;notify;%s;%s\007' "$TITLE" "$BODY"
+} > /dev/tty 2>/dev/null || {
+    printf '\033]777;notify;%s;%s\007' "$TITLE" "$BODY"
+}
+
+exit 0

package/README.md

@@ -267,6 +267,27 @@ cp node_modules/@yeongjaeyou/claude-code-config/.mcp.json .
 - Hugging Face model/dataset/Spaces search via `huggingface_hub` API
 - Download and analyze source code in temp directory (`/tmp/`)
 
+## Notification Hooks
+
+Desktop notifications for Claude Code events using OSC escape sequences.
+
+### Quick Setup
+
+```bash
+# 1. Install Terminal Notification extension in VSCode
+# 2. Global install includes notify_osc.sh and auto-registers hooks
+npx @yeongjaeyou/claude-code-config --global
+```
+
+### Supported Events
+
+| Event | Description |
+|-------|-------------|
+| Stop | Task completion |
+| Notification | Permission requests, idle prompts |
+
+See [docs/notification-setup.md](docs/notification-setup.md) for detailed setup guide.
+
 ## License
 
 MIT License

package/bin/cli.js

@@ -180,6 +180,33 @@ const DEFAULT_HOOKS_CONFIG = {
   ]
 };
 
+// Global-only notification hooks (OSC desktop alerts)
+const GLOBAL_NOTIFICATION_HOOKS = {
+  Stop: [
+    {
+      hooks: [
+        {
+          type: 'command',
+          command: '~/.claude/hooks/notify_osc.sh',
+          timeout: 10
+        }
+      ]
+    }
+  ],
+  Notification: [
+    {
+      matcher: '',
+      hooks: [
+        {
+          type: 'command',
+          command: '~/.claude/hooks/notify_osc.sh',
+          timeout: 10
+        }
+      ]
+    }
+  ]
+};
+
 /**
  * Check if a hook with the same command already exists
  * @param {Array} hooks - Existing hooks array
@@ -232,6 +259,22 @@ function mergeSettingsJson() {
     console.log('inject-guidelines hook already exists in settings.json');
   }
 
+  // Add notification hooks for global install only
+  if (isGlobal) {
+    for (const [event, hookConfigs] of Object.entries(GLOBAL_NOTIFICATION_HOOKS)) {
+      if (!settings.hooks[event]) {
+        settings.hooks[event] = [];
+      }
+      const notifCommand = hookConfigs[0].hooks[0].command;
+      if (!hookExists(settings.hooks[event], notifCommand)) {
+        settings.hooks[event].push(hookConfigs[0]);
+        console.log(`Added ${event} notification hook to settings.json`);
+      } else {
+        console.log(`${event} notification hook already exists in settings.json`);
+      }
+    }
+  }
+
   // Write merged settings
   try {
     fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
@@ -337,6 +380,13 @@ async function main() {
   if (isGlobal) {
     console.log('Global installation complete.');
     console.log('Claude Code commands are now available in all projects.');
+    console.log('');
+    console.log('Desktop notifications enabled:');
+    console.log('  - Stop: Task completion alerts');
+    console.log('  - Notification: Permission/idle prompts');
+    console.log('');
+    console.log('Note: Install "Terminal Notification" VSCode extension for alerts.');
+    console.log('See docs/notification-setup.md for detailed setup guide.');
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yeongjaeyou/claude-code-config",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Claude Code CLI custom commands, agents, and skills",
   "bin": {
     "claude-code-config": "./bin/cli.js"