claude-code-toast
🥈SilverA Claude Code Notification hook for MacOS that displays a toast message when Claude Code is waiting for the user to respond.
1710Updated 2mo ago
Intermediate30min to implementautomation
Saves ~5 min per use
Quick InstallView Source
git clone https://github.com/eyalzh/claude-code-toast.gitWorks with:
Claude
Overview
About This Skill
Claude Code Toast is a notification hook designed for macOS that integrates with Claude Code to display toast messages whenever Claude Code is waiting for user input. The skill uses AppleScript to create unobtrusive notifications that keep developers aware of pending interactions without requiring constant manual checking. Installation is straightforward through Claude Code's `/hooks` command, and the script runs locally on your machine. This automation eliminates the need to repeatedly check whether Claude Code requires your attention, improving productivity in development workflows that rely on iterative Claude Code interactions.
How to Use
Use the `/hooks` command in Claude Code to add a new Notification hook. Add the command: `python /path/to/this/repo/claude-code-toast.py`. Review the script before use to ensure it's safe for your environment.
Use Cases
Get notified when Claude Code requires user feedback during long-running tasks
Reduce context-switching by knowing when Claude Code is waiting without manual checks
Improve development workflow efficiency by automating Claude Code status notifications
Stay informed of Claude Code interaction points during multitasking sessions
Tags
Setup & Installation
Quick Install
No install command available. Check the GitHub repository for manual installation instructions.
Alternative Install (Git Clone)
git clone https://github.com/eyalzh/claude-code-toastRequirements
- Claude Code or compatible AI agent
- Works with: Claude
Quick Start Guide
1
Install the Skill
Copy the install command above and run it in your terminal.
2
Open Your AI Agent
Launch Claude Code, Cursor, or your preferred AI coding agent.
3
Try It Out
Use the prompt template or examples below to test the skill.
4
Customize
Adapt the skill to your specific use case and workflow.
Usage Examples
Prompt Template
Create a Claude Code Notification hook for MacOS that displays a toast message when Claude Code is waiting for the user to respond. The toast should appear in the top-right corner of the screen and include the following details: [MESSAGE], [TIMESTAMP], and a button to [ACTION]. Ensure the toast is non-intrusive but noticeable, with a gentle animation and a subtle sound effect.
Example Output
```python
import os
import time
from pync import Notifier
def claude_code_notification(message, action):
timestamp = time.strftime("%Y-%m-%d %H:%M:%S")
notification_title = "Claude Code Notification"
notification_message = f"{message}\n\nTimestamp: {timestamp}"
Notifier.notify(
title=notification_title,
message=notification_message,
app_icon="path/to/claude_icon.png",
sound=True,
group="ClaudeCodeNotifications",
execute=f"open 'claude://{action}'"
)
# Example usage
claude_code_notification(
message="Claude Code is waiting for your response.",
action="respond_to_claude"
)
```Apply to these tools
Browse all toolsSage
Accounting software with automated invoicing and reporting
Claude
AI assistant built for thoughtful, nuanced conversation
Hook
Agents that listen, think and act for you.
Microsoft Teams
Get more done every day with Microsoft Teams – powered by AI
Respell
Agentic AI Workflow platform
Notion
Connected workspace for docs, wikis, and projects
Compatible MCP servers
Browse all MCP servers
Find the right skills for your stack
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan