claude-notifications

What This Skill Does

The claude-notifications skill provides a robust bridge between Claude Code and the macOS native notification center. Whether you are working locally on your machine or inside remote devpod environments, this skill ensures you never miss a request for input or a permission prompt. It utilizes a combination of terminal-notifier, SSH reverse tunneling, and launchd background listeners to push alerts from terminal sessions directly to your macOS system desktop.

By configuring Claude Code hooks for permission_prompt, idle_prompt, and elicitation_dialog, this tool effectively turns your terminal-based AI into an interactive, proactive assistant. For remote users, it dynamically updates SSH configurations and tmux settings to ensure that even deep within remote containers, your AI agent can 'ping' you when it needs assistance.

Installation

To install this skill, use the ClawHub CLI: clawhub install openclaw/skills/skills/ajitsingh25/claude-notifications. Once installed, navigate to ~/.claude/skills/claude-notifications/ to execute the setup script. Use python3 scripts/setup_notifications.py for local-only setups, or append --devpod <host> for each remote environment you wish to monitor. Ensure you are running this from your local Mac, as the script handles all remote configuration via SSH.

Use Cases

This skill is ideal for developers who keep Claude running in background terminal tabs or long-running tmux sessions. It is specifically designed to eliminate the need to manually check for terminal output while waiting for a task to progress. Use this if you are running automated test suites, long refactoring sessions, or complex MCP interactions that require periodic human validation. It is a critical productivity utility for power users who leverage devpods to keep their primary development environment clean.

Example Prompts

1. "Setup notifications for my local Claude terminal and my devpod at dev.project-x.com."
2. "I'm not getting alerts when Claude needs attention, can you install the notification hooks?"
3. "Configure devpod notifications for my current session."

Tips & Limitations

• macOS Exclusive: This skill relies on terminal-notifier and launchctl, meaning it will not work on Linux or Windows subsystems directly.
• Permission Checks: Always ensure your Terminal app and 'Script Editor' have full notification permissions enabled in macOS System Settings. If alerts aren't appearing, verify that 'Do Not Disturb' is disabled or that the application is allowed to bypass it.
• Session Management: Remember to restart any existing SSH connections after running the setup script; the new reverse tunnel settings only apply to new terminal sessions. If you face issues, check the ~/.ssh/config file to ensure the RemoteForward line was added correctly for your specific host.