claude-code-notify-powershell

🥈Silver

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.

6720Updated 1mo ago

Intermediate30min to implementautomation

Saves ~15 min per use

Quick InstallView Source

git clone https://github.com/soulee-dev/claude-code-notify-powershell.git

Works with:

Claude

Overview

About This Skill

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.

How to Use

[{"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."}]

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/soulee-dev/claude-code-notify-powershell

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

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.

Example Output

```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).