taskbar-flash

Taskbar Flash

This skill manages Claude Code taskbar flashing for Windows. Supports three operations: setup, update, and uninstall.

Usage

• /taskbar-flash or "setup taskbar flash" — first-time setup
• "update taskbar flash" or "升级任务栏闪烁" — update the script to latest version
• "uninstall taskbar flash" or "卸载任务栏闪烁" — remove everything

Operation: Setup (default)

When asked to set up taskbar flash, follow these steps:

Step 0: Check if already configured

Check if ~/.claude/flash-taskbar.ps1 exists AND ~/.claude/settings.json contains the three hooks (PreToolUse with AskUserQuestion matcher, PermissionRequest, Stop) referencing flash-taskbar.ps1.

If already fully configured, tell the user: "任务栏闪烁已配置，无需重复安装。如需更新脚本请说 'update'，如需卸载请说 'uninstall'。" Stop here — do not proceed to Step 1.

If the script exists but some hooks are missing, proceed to Step 1 and repair the missing hooks.

Step 1: Detect OS

Run echo "$OSTYPE" (bash) or check if Windows. Windows only for now. On macOS/Linux, say "macOS/Linux 暂不支持，目前仅支持 Windows。"

Step 2: Copy the flashing script

Copy the bundled PowerShell script to ~/.claude/:

cp "<plugin_root>/skills/taskbar-flash/scripts/flash-taskbar.ps1" ~/.claude/flash-taskbar.ps1

<plugin_root> is the directory containing .claude-plugin/plugin.json. Use the actual path from the environment.

Step 3: Configure hooks

Read ~/.claude/settings.json. Merge the following hooks into the "hooks" key. If the key doesn't exist, create it. If individual hooks already exist, skip them (don't duplicate).

Hooks to add:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "AskUserQuestion",
        "hooks": [{
          "type": "command",
          "command": "powershell -NoProfile -ExecutionPolicy Bypass -Command \"& (Join-Path (Resolve-Path ~) '.claude\\flash-taskbar.ps1')\"",
          "async": true
        }]
      }
    ],
    "PermissionRequest": [
      {
        "matcher": "",
        "hooks": [{
          "type": "command",
          "command": "powershell -NoProfile -ExecutionPolicy Bypass -Command \"& (Join-Path (Resolve-Path ~) '.claude\\flash-taskbar.ps1')\"",
          "async": true
        }]
      }
    ],
    "Stop": [
      {
        "matcher": "",
        "hooks": [{
          "type": "command",
          "command": "powershell -NoProfile -ExecutionPolicy Bypass -Command \"& (Join-Path (Resolve-Path ~) '.claude\\flash-taskbar.ps1')\"",
          "async": true
        }]
      }
    ]
  }
}

Permission to add (if not already present):

"Bash(powershell *)"

Add it to permissions.allow array in ~/.claude/settings.json.

Step 4: Confirm

Tell the user:

• "配置已保存。重启 Claude Code 后生效。"
• "测试方法：切到其他窗口，当 Claude 提问或完成任务时任务栏会闪烁。"
• "更新：/taskbar-flash 后说 'update'。卸载：说 'uninstall taskbar flash'。"

Operation: Update

When the user asks to update the taskbar flash script, you MUST do ALL of the following steps. Do NOT skip any step.

Step 1: Detect OS

Windows only. On macOS/Linux say "暂仅支持 Windows。"

Step 2: Copy the latest script

Copy from <plugin_root>/skills/taskbar-flash/scripts/flash-taskbar.ps1 to ~/.claude/flash-taskbar.ps1, overwriting.

Step 3: MANDATORY — Scan for and replace outdated hook commands

Read ~/.claude/settings.json. Search the entire file for the string $HOME/.claude/flash-taskbar.ps1 (the old/broken command format).

If found: You MUST replace EVERY occurrence of the old command:

powershell -ExecutionPolicy Bypass -File "$HOME/.claude/flash-taskbar.ps1"

with the current command:

powershell -NoProfile -ExecutionPolicy Bypass -Command "& (Join-Path (Resolve-Path ~) '.claude\flash-taskbar.ps1')"

This is the most important step. The old $HOME format does NOT work for CMD users. Do NOT skip this replacement.

Step 4: Verify hooks and permission exist

Check that the three hook entries (PreToolUse/AskUserQuestion, PermissionRequest, Stop) and Bash(powershell *) permission exist. If any are missing, add them.

Step 5: Confirm

Tell the user: "更新完成。脚本已替换；hook 命令已更新为兼容格式；无需重启，下次触发自动生效。"

Operation: Uninstall

When the user asks to uninstall taskbar flash:

1. Read ~/.claude/settings.json.
2. Remove the three hook entries from "hooks":
   • The PreToolUse entry with "matcher": "AskUserQuestion" whose command references flash-taskbar.ps1
   • The PermissionRequest entry whose command references flash-taskbar.ps1
   • The Stop entry whose command references flash-taskbar.ps1
3. If a hook key (PreToolUse/PermissionRequest/Stop) has an empty array after removal, remove the key entirely.
4. Remove "Bash(powershell *)" from permissions.allow if present.
5. Delete ~/.claude/flash-taskbar.ps1.
6. Tell the user: "已卸载。hooks 配置和脚本均已移除。重启 Claude Code 后生效。"

Cross-Platform Design Notes

When adding macOS/Linux support:

• macOS: use osascript -e 'display notification ...' for notifications, or bounce the Dock icon via osascript -e 'tell app "Terminal" to activate'
• Linux: use notify-send or zenity for desktop notifications
• The SKILL.md operations should branch by OS
• Add platform-specific scripts under scripts/macos/ and scripts/linux/
• The hooks command field should use OS-appropriate commands