feat(notify): add --icon flag for custom contentImage in notifications

[wozniakos10]

Summary

• Adds optional --icon <path> CLI argument to the notify subcommand
• The path is forwarded through cmd_notify → send_local_notification_if_needed → send_notification and passed as -contentImage to terminal-notifier
• No default value — behaviour is unchanged when --icon is omitted
• Adds hook configuration examples (with and without icon) to --help output

Motivation

On macOS 12+, terminal-notifier -appIcon is blocked by the OS for third-party apps. -contentImage is the supported way to display a custom image in notifications. This change lets users configure a custom icon per-hook without modifying the source.

Example hook configuration

{
  "hooks": {
    "SessionStart": [{"matcher": "*", "hooks": [{"type": "command",
      "command": "$HOME/.cc-notifier/cc-notifier init"}]}],
    "Stop": [{"matcher": "*", "hooks": [{"type": "command",
      "command": "$HOME/.cc-notifier/cc-notifier notify --icon $HOME/.claude/hooks/my-icon.png"}]}],
    "Notification": [{"matcher": "permission_prompt|elicitation_dialog",
      "hooks": [{"type": "command",
      "command": "$HOME/.cc-notifier/cc-notifier notify --icon $HOME/.claude/hooks/my-icon.png"}]}],
    "SessionEnd": [{"matcher": "*", "hooks": [{"type": "command",
      "command": "$HOME/.cc-notifier/cc-notifier cleanup"}]}]
  }
}

Test plan

• cc-notifier notify (no flag) — behaviour unchanged, no image in notification
• cc-notifier notify --icon /path/to/icon.png — notification shows image on the right
• cc-notifier notify --icon /nonexistent.png — gracefully skips -contentImage, no crash
• cc-notifier --help — shows updated usage and examples

🤖 Generated with Claude Code

[trentmcnitt]

Cool idea. I'll try to check this out soon. Has it been working well for you?