Claude Code या Codex का काम पूरा होने पर अलर्ट कैसे पाएँ

एजेंट कैसे बताते हैं कि काम हो गया

दोनों टूल सही वक़्त पर आपकी दी हुई कोई command चला सकते हैं। Notification बस इतना ही है: Claude Code इसे hook कहता है, Codex इसे notify। वो command जो भी करे (आवाज़ बजाए, banner दिखाए, स्क्रीन चमकाए), वो तब होता है जब एजेंट रुकता है या इनपुट माँगता है।

Claude Code: built-in notification

जब Claude Code काम पूरा करता है, या किसी permission prompt पर रुकता है, तो वो ख़ुद desktop notification भेज सकता है। Anthropic के docs के मुताबिक़ यह Ghostty और Kitty में बिना कुछ किए चलता है। iTerm2 में इसे एक बार चालू करें:

1. iTerm2 → Settings → Profiles → Terminal।
2. Notification Center Alerts पर टिक करें।
3. Filter Alerts पर क्लिक करें और Send escape sequence-generated alerts चालू करें।

Claude Code को tmux के अंदर चला रहे हैं? ~/.tmux.conf में set -g allow-passthrough on जोड़ें, वरना notification आपके terminal तक पहुँचेगा ही नहीं। Claude Code आपको कैसे बताए (जैसे terminal bell), यह भी उसकी /config सेटिंग्स में चुन सकते हैं।

स्रोत: Claude Code docs: terminal setup

Claude Code: आवाज़ बजाने वाला hook

Apple के Terminal, VS Code या किसी भी दूसरे terminal में यह काम hook करता है। Hooks ~/.claude/settings.json (हर प्रोजेक्ट के लिए) या .claude/settings.json (एक प्रोजेक्ट के लिए) में रहते हैं। दो events काम के हैं:

• Stop: Claude ने अपना जवाब पूरा कर लिया।
• Notification: Claude को आपकी ज़रूरत है (कोई permission prompt, या वो इनपुट के इंतज़ार में है)।

यह दोनों के लिए macOS की एक आवाज़ बजाता है। इसे अपनी settings फ़ाइल में मिला दें (जो पहले से है, उसे रहने दें):

{
  "hooks": {
    "Stop": [{ "hooks": [{ "type": "command", "command": "afplay /System/Library/Sounds/Glass.aiff" }] }],
    "Notification": [{ "matcher": "", "hooks": [{ "type": "command", "command": "afplay /System/Library/Sounds/Ping.aiff" }] }]
  }
}

Banner चाहिए? उसकी जगह यह command इस्तेमाल करें (Anthropic के उदाहरण जैसा ही):

osascript -e 'display notification "Claude Code needs your attention" with title "Claude Code"'

क्या-क्या सेट है, यह देखने के लिए Claude Code में /hooks टाइप करें। नए hooks उन sessions पर लागू होते हैं जो आप फ़ाइल सेव करने के बाद शुरू करते हैं। /System/Library/Sounds/ की आवाज़ें इस्तेमाल करने के लिए फ़्री हैं: Glass, Ping, Pop, Purr, Submarine और भी।

स्रोत: hooks reference · hooks guide

Codex: notify सेटिंग

Codex CLI हर turn के बाद आपका एक प्रोग्राम चलाता है, जो ~/.codex/config.toml में notify से सेट होता है। Codex आख़िरी argument के तौर पर उस turn का JSON ब्योरा जोड़ता है (उसका type है agent-turn-complete), जिसे आवाज़ वाली एक सीधी command अनदेखा कर सकती है:

notify = ["sh", "-c", "afplay /System/Library/Sounds/Glass.aiff"]

notify एक top-level key है: इसे फ़ाइल में किसी भी [section] से ऊपर रखें। Codex के terminal UI में built-in notifications भी हैं ([tui] के नीचे notifications), जो terminal की अपनी notification या bell इस्तेमाल करती हैं; banner दिखेगा या नहीं, यह आपके terminal पर निर्भर है।

Codex का notify तब चलता है जब एक turn पूरा होता है। उसमें Claude Code के Notification hook जैसा अलग “आपकी मंज़ूरी चाहिए” event नहीं है।

स्रोत: Codex docs: advanced configuration

Clacky का Agent Alerts: यही सब, बिना config के

अगर JSON और TOML नहीं छेड़ना चाहते, तो Clacky (Mac का एक menu-bar ऐप) में Agent Alerts है। यह ऊपर वाले hooks ही इस्तेमाल करता है, इसलिए न कुछ आपकी स्क्रीन देखता है, न आपका terminal पढ़ता है:

1. Clacky का डैशबोर्ड खोलें → Agent Alerts।
2. Claude Code या Codex के बगल में Set Up… पर क्लिक करें। Clacky ठीक वही लाइनें दिखाता है जो वो जोड़ेगा; Add Hooks पर क्लिक करें। वो आपकी फ़ाइल का एक backup उसी के बगल में रखता है (settings.json.clacky-backup)।
3. दोनों आवाज़ें सुनने के लिए Send a Test Alert पर क्लिक करें।

आपको क्या मिलता है:

• काम पूरा (चढ़ता हुआ एक chord) और आपकी ज़रूरत है (दो टैप और एक सवाल) के लिए अलग आवाज़, हर एजेंट के लिए चुनने को पाँच आवाज़ें।
• चाहें तो लगभग एक सेकंड के लिए स्क्रीन के किनारे पर हल्की चमक। इसके आर-पार क्लिक होता है और यह रिकॉर्डिंग में कभी नहीं दिखती।
• Quiet when it’s in front (जब एजेंट का terminal सामने वाला ऐप हो तब चुप) और Quiet during calls (जब माइक इस्तेमाल में हो तब चुप), दोनों पहले से चालू।
• Menu bar में हर session का एक बिंदु: काम चल रहा है, इंतज़ार में है, या पूरा हुआ। किसी पर क्लिक करें तो उसका terminal सामने आ जाता है।
• Keep Awake → Until My Agent Is Done, ताकि Mac के सो जाने से कोई लंबा काम बीच में न रुके।

Claude Code किसी भी terminal में और Claude ऐप के Code टैब में चलता है। Codex, CLI के साथ चलता है और उसे काम पूरा वाली आवाज़ मिलती है (Codex “आपकी ज़रूरत है” वाला event नहीं भेजता)। अगर आपके Codex config में पहले से notify लाइन है, तो Clacky उसे बदलने की जगह वैसे ही छोड़ देता है और आपको बता देता है। Remove… सिर्फ़ Clacky की लाइनें हटाता है।

अगर कुछ न हो

• Session दोबारा शुरू करें। Hooks session शुरू होते वक़्त पढ़े जाते हैं, इसलिए पहले से चल रहा session notification नहीं देगा।
• देखें कि फ़ाइल सही parse होती है। settings.json में एक comma छूटने से हर hook रुक जाता है। इसे किसी भी JSON checker में paste करें।
• Command अकेले चलाकर देखें। Terminal में afplay /System/Library/Sounds/Glass.aiff चलाएँ। आवाज़ नहीं आई? अपना output device और volume देखें।
• Banners नहीं दिख रहे? System Settings → Notifications में अपना terminal (या osascript के लिए Script Editor) देखें, और Focus modes भी।
• एक साथ दो आवाज़ें? आपके पास दो सेटअप हैं (जैसे आपका अपना hook और Clacky का)। एक ही रखें।