setup

Install BurntToast module, register the claude-notify:// protocol handler, and register notification identity.

Execution method: For each PowerShell code block below, save the code to a temporary .ps1 file (e.g., ~/.claude/work/setup-step.ps1), then execute via powershell.exe -NoProfile -ExecutionPolicy Bypass -File "<path>". Delete the temp file after each step succeeds. Do not pass PowerShell code inline via -Command — bash escaping will break it.

Prerequisites

• Windows 10 / 11
• Windows PowerShell 5.1 (built-in, no extra install needed)

Step 1: Install BurntToast Module

No Administrator required — -Scope CurrentUser installs for current user only. Check if already installed; skip if present:

if (Get-Module -ListAvailable -Name BurntToast) {
    Write-Host "BurntToast already installed, skipping."
} else {
    Install-Module -Name BurntToast -Scope CurrentUser -Force
    Write-Host "BurntToast installed successfully."
}

If a certificate error occurs during install, retry with -SkipPublisherCheck:

Install-Module -Name BurntToast -Scope CurrentUser -Force -SkipPublisherCheck

Verify BurntToast

Import-Module BurntToast
New-BurntToastNotification -Text 'BurntToast works!'

You should see a test notification in the bottom-right corner of your screen.

Step 2: Register Click-to-Focus Protocol

This registers the claude-notify:// URI protocol so clicking a notification activates the terminal/IDE window. This is a one-time setup and does not require Administrator privileges (writes to HKCU only).

Execute directly without prompting the user:

# Auto-detect plugin root path (marketplace/plugin-name/version)
$pluginRoot = (Get-ChildItem "$env:USERPROFILE\.claude\plugins\cache\*\win-toast-notification\*" -Directory |
               Where-Object { Test-Path (Join-Path $_.FullName "scripts") } |
               Select-Object -Last 1).FullName
if (-not $pluginRoot) { throw "Plugin root not found. Is the plugin installed?" }

$scriptPath = Join-Path $pluginRoot "scripts\focus-terminal.ps1"

# Register protocol in HKCU (no admin needed)
# Reference: https://learn.microsoft.com/en-us/previous-versions/windows/internet-explorer/ie-developer/platform-apis/aa767914(v=vs.85)
$regPath = "HKCU:\Software\Classes\claude-notify"
New-Item -Path "$regPath\shell\open\command" -Force | Out-Null
Set-ItemProperty -Path $regPath -Name "(Default)" -Value "URL:Claude Notify Protocol"
Set-ItemProperty -Path $regPath -Name "URL Protocol" -Value ""
Set-ItemProperty -Path "$regPath\shell\open\command" -Name "(Default)" `
    -Value "powershell.exe -WindowStyle Hidden -NoProfile -ExecutionPolicy Bypass -File `"$scriptPath`" `"%1`""

Write-Host "Registered protocol handler at: $scriptPath"