feat: add channels and usage reset alerts

Author: mylee04

README.md

@@ -13,19 +13,19 @@ Desktop notifications for AI coding tools - get alerts when tasks complete or in
   <img src="assets/multi-tools-support-02.png" width="48%" alt="All tools enabled"/>
 </p>
 
-[![Version](https://img.shields.io/badge/version-1.8.0-blue.svg)](https://github.com/mylee04/code-notify/releases)
+[![Version](https://img.shields.io/badge/version-1.9.0-blue.svg)](https://github.com/mylee04/code-notify/releases)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![macOS](https://img.shields.io/badge/macOS-supported-green.svg)](https://www.apple.com/macos)
 [![Linux](https://img.shields.io/badge/Linux-supported-green.svg)](https://www.linux.org/)
 [![Windows](https://img.shields.io/badge/Windows-supported-green.svg)](https://www.microsoft.com/windows)
 
 ---
 
-## What's New in v1.8.0
+## What's New in v1.9.0
 
-- **Immediate AskUserQuestion alerts**: `cn alerts add ask_user` now enables a Claude `PreToolUse` hook for `AskUserQuestion` prompts
-- **Preserves custom PreToolUse hooks**: enabling or removing `ask_user` only manages code-notify's own hook and keeps existing user hooks intact
-- **Windows UTF-8 stdin fix**: Windows notifications now read redirected Claude hook payloads as UTF-8 before parsing question text
+- **Slack and Discord delivery**: `cn channels` can mirror Code-Notify alerts to incoming webhooks
+- **Codex and Claude usage alerts**: `cn usage` can warn at 20%/10% and announce daily (5h) or weekly (7d) token resets
+- **Distinct reset announcements**: token reset alerts use separate voice/sound controls and include README voice samples
 
 ---
 
@@ -38,6 +38,8 @@ Desktop notifications for AI coding tools - get alerts when tasks complete or in
 - **macOS click-through control** - Choose which app notification clicks activate
 - **Sound notifications** - Play custom sounds on task completion
 - **Voice announcements** - Hear when tasks complete (macOS, Windows)
+- **Slack/Discord delivery** - Mirror notifications to incoming webhooks
+- **Usage alerts** - Opt-in Codex/Claude 20%, 10%, and reset notifications
 - **Tool-specific messages** - "Claude completed the task", "Codex completed the task"
 - **Project-specific settings** - Different configs per project
 - **Quick aliases** - `cn` and `cnp` for fast access
@@ -117,6 +119,8 @@ curl -s https://raw.githubusercontent.com/mylee04/code-notify/main/docs/installa
 | `cn click-through`   | Show current macOS click-through mappings    |
 | `cn click-through add <app>` | Add a macOS click-through mapping    |
 | `cn alerts`          | Configure which events trigger notifications |
+| `cn channels`        | Configure Slack/Discord delivery channels    |
+| `cn usage`           | Configure Codex/Claude usage alerts          |
 | `cn sound on`        | Enable sound notifications                   |
 | `cn sound set <path>`| Use custom sound file                        |
 | `cn voice on`        | Enable voice (macOS, Windows)                |
@@ -201,6 +205,51 @@ Alert-type matching applies to Claude Code notification hooks and Gemini CLI not
 
 Agent-team and subagent workflows can be noisy if `permission_prompt` is enabled. If you only want idle pings, run `cn alerts remove permission_prompt && cn on`. Codex currently uses completion events from `notify`, so `permission_prompt` and `idle_prompt` settings do not change Codex behavior.
 
+### Slack And Discord
+
+Code-Notify can also send the same notification to Slack or Discord through incoming webhooks. Desktop notifications still work normally; remote delivery is an extra channel.
+
+```bash
+cn channels add slack https://hooks.slack.com/services/...
+cn channels add discord https://discord.com/api/webhooks/...
+cn channels status
+cn channels test all
+```
+
+Webhook URLs are stored locally in `~/.config/code-notify/channels.json` and are redacted in `cn status`.
+
+### Usage Alerts
+
+Usage alerts are opt-in for Codex and Claude:
+
+```bash
+cn usage on
+cn usage check
+cn usage watch --interval 300
+cn usage thresholds set 20,10
+cn usage reset-alerts voice on
+cn usage reset-alerts sound default
+```
+
+Code-Notify checks the daily (5h) and weekly (7d) usage windows. It sends a warning when remaining usage crosses 20% or 10%, and sends a reset notification when a window returns to 100%.
+
+Reset alerts are intentionally separate from normal task-complete alerts. By default they use a different title, voice message, and reset sound so it is clear that tokens have refilled. The voice message identifies the window, for example `Codex token daily limit reset` or `Codex token weekly limit reset`. You can disable or customize that behavior:
+
+Voice samples:
+
+| Alert | Sample |
+| --- | --- |
+| Codex daily limit reset | [Listen](assets/audio/codex-token-daily-limit-reset.m4a) |
+| Codex weekly limit reset | [Listen](assets/audio/codex-token-weekly-limit-reset.m4a) |
+
+```bash
+cn usage reset-alerts off
+cn usage reset-alerts voice off
+cn usage reset-alerts sound set ~/sounds/tokens-reset.wav
+```
+
+Codex usage checks read `~/.codex/auth.json`. Claude usage checks read `~/.claude/.credentials.json`. Code-Notify does not launch provider CLIs, start login flows, or install a background daemon.
+
 ## Troubleshooting
 
 **Command not found?**

assets/audio/codex-token-daily-limit-reset.m4a

@@ -6,7 +6,7 @@
 set -e
 
 # Version
-VERSION="1.8.0"
+VERSION="1.9.0"
 
 # Determine the directory where the script is located (resolve symlinks)
 SCRIPT_PATH="${BASH_SOURCE[0]}"
@@ -48,7 +48,7 @@ case "$COMMAND_NAME" in
             "version"|"-v"|"--version")
                 show_version
                 ;;
-            "on"|"off"|"status"|"test"|"setup"|"voice"|"sound"|"alerts"|"update")
+            "on"|"off"|"status"|"test"|"setup"|"voice"|"sound"|"alerts"|"channels"|"usage"|"update")
                 source "$LIB_DIR/commands/global.sh"
                 handle_global_command "$@"
                 ;;
@@ -78,7 +78,7 @@ case "$COMMAND_NAME" in
     "code-notify"|*)
         # Called as 'code-notify' - full command parsing
         case "${1:-help}" in
-            "on"|"off"|"status"|"test"|"setup"|"voice"|"sound"|"alerts"|"update")
+            "on"|"off"|"status"|"test"|"setup"|"voice"|"sound"|"alerts"|"channels"|"usage"|"update")
                 source "$LIB_DIR/commands/global.sh"
                 handle_global_command "$@"
                 ;;

assets/audio/codex-token-weekly-limit-reset.m4a

@@ -9,6 +9,8 @@ Code-Notify adds desktop notifications to Claude Code, Codex, and Gemini CLI. Yo
 - Tasks complete
 - Claude or Gemini needs your input
 - Voice announcements (macOS)
+- Slack or Discord webhook messages when channels are configured
+- Codex or Claude usage crosses configured thresholds or resets
 
 Codex currently exposes completion notifications through its `notify` hook. Approval and `request_permissions` prompts do not currently trigger Code-Notify through Codex.
 
@@ -49,6 +51,30 @@ cn status     # Should show: Global notifications: ENABLED
 cn test       # Should trigger a desktop notification
 ```
 
+### Optional Slack/Discord Delivery
+
+```bash
+cn channels add slack https://hooks.slack.com/services/...
+cn channels add discord https://discord.com/api/webhooks/...
+cn channels test all
+```
+
+Webhook URLs are stored locally and are redacted in status output.
+
+### Optional Usage Alerts
+
+```bash
+cn usage on
+cn usage check
+cn usage watch --interval 300
+cn usage reset-alerts voice on
+cn usage reset-alerts sound default
+```
+
+Usage alerts currently support Codex and Claude daily (5h) and weekly (7d) windows. Low-usage warnings use normal Code-Notify delivery. Token reset alerts are separate and can use their own voice/sound controls with `cn usage reset-alerts ...`. Reset voice messages identify the window, such as `Codex token daily limit reset` or `Codex token weekly limit reset`.
+
+They use existing local login state from `~/.codex/auth.json` and `~/.claude/.credentials.json`. Code-Notify does not start provider login flows or install a background scheduler.
+
 ### Enable Voice (macOS only)
 
 ```bash
@@ -97,6 +123,9 @@ After installation, these files are created:
 - `~/.claude/settings.json` - Hook configuration on the default Claude Code path
 - `~/.config/.claude/settings.json` - Hook configuration on some Windows Claude Code setups
 - `~/.claude/notifications/voice-enabled` - Voice setting (if enabled)
+- `~/.config/code-notify/channels.json` - Slack/Discord channel config (if configured)
+- `~/.config/code-notify/usage.json` - Usage alert config (if enabled)
+- `~/.config/code-notify/usage-state.json` - Usage alert dedupe state (if alerts have fired)
 
 ### Uninstallation
 
@@ -164,6 +193,8 @@ cd code-notify
 | `cn status`   | Check current status            |
 | `cn update`   | Update code-notify              |
 | `cn update check` | Check the latest release and show the update command |
+| `cn channels` | Configure Slack/Discord delivery |
+| `cn usage`    | Configure Codex/Claude usage alerts |
 | `cn voice on` | Enable voice (macOS)            |
 | `cnp on`      | Enable for current project only |
 

bin/code-notify

@@ -8,6 +8,8 @@ source "$GLOBAL_CMD_DIR/../utils/voice.sh"
 source "$GLOBAL_CMD_DIR/../utils/sound.sh"
 source "$GLOBAL_CMD_DIR/../utils/help.sh"
 source "$GLOBAL_CMD_DIR/../utils/click-through.sh"
+source "$GLOBAL_CMD_DIR/../utils/channels.sh"
+source "$GLOBAL_CMD_DIR/../utils/usage.sh"
 
 CODE_NOTIFY_RELEASES_API="https://api.github.com/repos/mylee04/code-notify/releases/latest"
 
@@ -44,6 +46,12 @@ handle_global_command() {
         "alerts")
             handle_alerts_command "$@"
             ;;
+        "channels")
+            handle_channels_command "$@"
+            ;;
+        "usage")
+            handle_usage_command "$@"
+            ;;
         "click-through")
             handle_click_through_command "$@"
             ;;
@@ -600,6 +608,43 @@ show_status() {
     local alert_types=$(get_notify_types)
     echo "  ${BELL} Alert types: ${CYAN}$alert_types${RESET}"
 
+    echo ""
+    if channels_has_python3; then
+        local channel_summary
+        channel_summary="$(channels_list_redacted 2>/dev/null | awk -F '\t' '
+            $1 == "enabled" { enabled = $2 }
+            $1 == "channel" { count++; providers[$3] = 1 }
+            END {
+                if (enabled == "") enabled = "true"
+                provider_list = ""
+                for (provider in providers) {
+                    provider_list = provider_list (provider_list ? "," : "") provider
+                }
+                if (count == "") count = 0
+                print enabled "\t" count "\t" provider_list
+            }
+        ')"
+        local channels_enabled channels_count channels_providers
+        IFS=$'\t' read -r channels_enabled channels_count channels_providers <<< "$channel_summary"
+        if [[ "$channels_enabled" == "true" && "$channels_count" -gt 0 ]]; then
+            echo "  ${CHECK_MARK} Channels: ${GREEN}ENABLED${RESET} ($channels_count configured: $channels_providers)"
+        elif [[ "$channels_count" -gt 0 ]]; then
+            echo "  ${MUTE} Channels: ${DIM}DISABLED${RESET} ($channels_count configured)"
+        else
+            echo "  ${MUTE} Channels: ${DIM}not configured${RESET}"
+        fi
+    fi
+
+    if usage_has_python3; then
+        local usage_enabled
+        usage_enabled="$(usage_read_config_json | python3 -c 'import json,sys; print("true" if json.load(sys.stdin).get("enabled", False) else "false")' 2>/dev/null || echo false)"
+        if [[ "$usage_enabled" == "true" ]]; then
+            echo "  ${CHECK_MARK} Usage alerts: ${GREEN}ENABLED${RESET}"
+        else
+            echo "  ${MUTE} Usage alerts: ${DIM}DISABLED${RESET}"
+        fi
+    fi
+
     # Notification tool status (platform-specific)
     local current_os
     current_os="$(detect_os)"

docs/installation.md

@@ -15,6 +15,8 @@ NOTIFIER_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 source "$NOTIFIER_DIR/../utils/detect.sh"
 source "$NOTIFIER_DIR/../utils/voice.sh"
 source "$NOTIFIER_DIR/../utils/sound.sh"
+source "$NOTIFIER_DIR/../utils/channels.sh"
+source "$NOTIFIER_DIR/../utils/usage.sh"
 source "$NOTIFIER_DIR/../utils/click-through-store.sh"
 source "$NOTIFIER_DIR/../utils/click-through-runtime.sh"
 source "$NOTIFIER_DIR/../utils/click-through-resolver.sh"
@@ -475,6 +477,20 @@ case "$HOOK_TYPE" in
         VOICE_MESSAGE="Notifications are working"
         SOUND="Glass"
         ;;
+    "usage")
+        TITLE="${CODE_NOTIFY_USAGE_TITLE:-$TOOL_DISPLAY usage alert}"
+        SUBTITLE="Usage Alert"
+        MESSAGE="${CODE_NOTIFY_USAGE_MESSAGE:-$TOOL_DISPLAY usage changed}"
+        VOICE_MESSAGE="${CODE_NOTIFY_USAGE_VOICE_MESSAGE:-$TOOL_DISPLAY usage alert}"
+        SOUND="Ping"
+        ;;
+    "usage_reset")
+        TITLE="${CODE_NOTIFY_USAGE_TITLE:-$TOOL_DISPLAY tokens reset}"
+        SUBTITLE="Tokens Reset"
+        MESSAGE="${CODE_NOTIFY_USAGE_MESSAGE:-$TOOL_DISPLAY tokens have reset. Usage is back to 100%.}"
+        VOICE_MESSAGE="${CODE_NOTIFY_USAGE_VOICE_MESSAGE:-$TOOL_DISPLAY tokens have reset}"
+        SOUND="Hero"
+        ;;
     "PreToolUse")
         # AskUserQuestion: extract question text and show notification
         ASK_QUESTION_TEXT=""
@@ -593,6 +609,10 @@ send_windows_notification() {
 
 # Check if voice is enabled for this tool
 should_speak() {
+    if [[ "$HOOK_TYPE" == "usage_reset" && "${CODE_NOTIFY_USAGE_RESET_VOICE:-true}" == "true" ]]; then
+        return 0
+    fi
+
     # Check tool-specific voice setting first
     if [[ -n "$TOOL_NAME" ]]; then
         local tool_voice_file="$HOME/.claude/notifications/voice-$TOOL_NAME"
@@ -612,6 +632,17 @@ should_speak() {
 
 # Get voice setting (tool-specific or global)
 get_voice_setting() {
+    if [[ "$HOOK_TYPE" == "usage_reset" ]]; then
+        local usage_reset_voice
+        usage_reset_voice=$(get_voice "tool" "$TOOL_NAME" 2>/dev/null || get_voice "global" 2>/dev/null || true)
+        if [[ -n "$usage_reset_voice" ]]; then
+            printf '%s\n' "$usage_reset_voice"
+            return
+        fi
+        printf '%s\n' "Samantha"
+        return
+    fi
+
     # Check tool-specific voice first
     if [[ -n "$TOOL_NAME" ]]; then
         local tool_voice_file="$HOME/.claude/notifications/voice-$TOOL_NAME"
@@ -627,9 +658,30 @@ get_voice_setting() {
 
 # Check if sound should play
 should_play_sound() {
+    if [[ "$HOOK_TYPE" == "usage_reset" ]]; then
+        [[ "${CODE_NOTIFY_USAGE_RESET_SOUND:-true}" == "true" ]]
+        return $?
+    fi
     is_sound_enabled
 }
 
+get_notification_sound_file() {
+    if [[ "$HOOK_TYPE" == "usage_reset" ]]; then
+        if [[ -n "${CODE_NOTIFY_USAGE_RESET_SOUND_FILE:-}" ]]; then
+            printf '%s\n' "$CODE_NOTIFY_USAGE_RESET_SOUND_FILE"
+            return
+        fi
+        case "$(detect_os 2>/dev/null || uname -s | tr '[:upper:]' '[:lower:]')" in
+            "macos"|"Darwin"|"darwin")
+                printf '%s\n' "/System/Library/Sounds/Hero.aiff"
+                return
+                ;;
+        esac
+    fi
+
+    get_sound
+}
+
 # Send notification based on OS
 OS=$(detect_os)
 case "$OS" in
@@ -644,14 +696,14 @@ case "$OS" in
         fi
         # Sound notification if enabled (separate from voice)
         if should_play_sound; then
-            play_sound
+            play_sound "$(get_notification_sound_file)"
         fi
         ;;
     linux)
         send_linux_notification
         # Sound notification if enabled
         if should_play_sound; then
-            play_sound
+            play_sound "$(get_notification_sound_file)"
         fi
         ;;
     wsl)
@@ -685,7 +737,7 @@ case "$OS" in
         fi
         # Sound notification if enabled
         if should_play_sound; then
-            play_sound
+            play_sound "$(get_notification_sound_file)"
         fi
         ;;
     windows)
@@ -698,6 +750,16 @@ case "$OS" in
 esac
 
 # Log the notification
+channels_deliver "$TITLE" "$MESSAGE" "$TOOL_NAME" "$PROJECT_NAME" "${CODE_NOTIFY_USAGE_CONTEXT:-}" || true
+
+if [[ "${CODE_NOTIFY_SKIP_USAGE_CHECK:-}" != "1" ]]; then
+    case "$TOOL_NAME" in
+        "codex"|"claude")
+            usage_check_with_lock "$TOOL_NAME" >/dev/null 2>&1 || true
+            ;;
+    esac
+fi
+
 LOG_DIR="$HOME/.claude/logs"
 if [[ -d "$LOG_DIR" ]]; then
     echo "[$(date '+%Y-%m-%d %H:%M:%S')] [$TOOL_NAME] [$PROJECT_NAME] $MESSAGE" >> "$LOG_DIR/notifications.log"