PowerShell script for Windows toast notifications from Claude Code. No dependencies. Use it to get real-time alerts for code events, improving developer productivity and workflow integration.
git clone https://github.com/soulee-dev/claude-code-notify-powershell.gitClaude Code Notify PowerShell is a lightweight automation tool that displays Windows toast notifications triggered by Claude Code hook events. The script integrates directly with Claude Code's hook system to alert developers about session starts, session ends, responses, and custom notifications without requiring external dependencies. It uses only built-in Windows APIs and PowerShell, making it easy to install and configure. Developers can customize notification messages by editing the script's switch block. This skill helps Windows developers stay informed about code execution events and improves workflow visibility without leaving their editor.
[{"step":"Save the script as `claude-code-notify-powershell.ps1` in your project directory or a shared scripts folder.","tip":"Use a consistent location for scripts to avoid path issues. Example: `C:\\Scripts\\claude-code-notify-powershell.ps1`"},{"step":"Run the script from Claude Code or PowerShell with required parameters. Example: `.\"claude-code-notify-powershell.ps1\" -Title \"Build Complete\" -Message \"Project compiled successfully.\" -Action \"Open Output\"`","tip":"Use `-Action` to define a workflow-specific action, like opening a log file or triggering another script."},{"step":"Integrate the script into your CI/CD pipeline or build tools (e.g., GitHub Actions, Azure DevOps) to trigger notifications on events like build failures or test completions.","tip":"For GitHub Actions, use a step like: `powershell -File .\\scripts\\claude-code-notify-powershell.ps1 -Title \"Build Status\" -Message \"Build ${{ job.status }} for ${{ github.repository }}.\"`"},{"step":"Customize the toast template in the script to include images, buttons, or progress bars if needed. Modify the `$toastXml` variable to match your requirements.","tip":"Refer to the [Microsoft Toast Notification Documentation](https://learn.microsoft.com/en-us/windows/uwp/design/shell/tiles-and-notifications/adaptive-interactive-toasts) for advanced formatting options."},{"step":"Test the notification locally before deploying to ensure it appears correctly and triggers the intended action.","tip":"Run the script in a PowerShell window to debug any issues with toast display or actions."}]
Get real-time alerts when Claude Code sessions start and end
Receive notifications when responses finish processing
Monitor code execution progress without checking the editor
Customize alert messages for specific hook events
No install command available. Check the GitHub repository for manual installation instructions.
git clone https://github.com/soulee-dev/claude-code-notify-powershellCopy the install command above and run it in your terminal.
Launch Claude Code, Cursor, or your preferred AI coding agent.
Use the prompt template or examples below to test the skill.
Adapt the skill to your specific use case and workflow.
Generate a PowerShell script that creates a Windows toast notification for [EVENT_DESCRIPTION]. The notification should include [TITLE], [MESSAGE], and a clickable action to [ACTION]. Use the script: `claude-code-notify-powershell.ps1` and ensure it works with Windows 10/11 without dependencies. Format the script to accept [PARAMETERS] like -Title, -Message, and -Action.
```powershell
# claude-code-notify-powershell.ps1
# Windows Toast Notification Script for Claude Code
# Usage: .\claude-code-notify-powershell.ps1 -Title "Build Failed" -Message "Project X build failed on line 42. See logs for details." -Action "Open Logs"
param (
[string]$Title = "Claude Code Alert",
[string]$Message = "No message provided",
[string]$Action = "Dismiss"
)
Add-Type -AssemblyName System.Windows.Forms
Add-Type -AssemblyName Microsoft.Toolkit.Uwp.Notifications
$toastXml = @"
<toast>
<visual>
<binding template="ToastText02">
<text id="1">$Title</text>
<text id="2">$Message</text>
</binding>
</visual>
<actions>
<action content="$Action" activationType="system" arguments="$Action" />
</actions>
</toast>
"@
$xmlDoc = New-Object System.Xml.XmlDocument
$xmlDoc.LoadXml($toastXml)
$toast = [Microsoft.Toolkit.Uwp.Notifications.ToastNotification]::new($xmlDoc)
[Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier("Windows PowerShell").Show($toast)
Write-Host "Toast notification sent: $Title - $Message"
```
**Example Usage:**
```powershell
."claude-code-notify-powershell.ps1" -Title "Test Passed" -Message "All unit tests passed for Module Y." -Action "View Report"
```
**Output:**
A Windows toast notification appears in the bottom-right corner with:
- Title: "Test Passed"
- Message: "All unit tests passed for Module Y."
- Action button: "View Report"
Clicking the button would trigger the action defined in your workflow (e.g., opening a report or dismissing the alert).AI assistant built for thoughtful, nuanced conversation
Get more done every day with Microsoft Teams – powered by AI
Automate security compliance and monitor real-time security posture seamlessly.
Automate your spreadsheet tasks with AI power
Agentic AI Workflow platform
Connected workspace for docs, wikis, and projects
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan