Yoink

Themed Windows (WSL) Claude notification hooks, whatever theme you fancy, be it 🦄, 🌸, 🐉 or The Matrix, we've got you covered. Fully configurable.

yoink-unicorn.mp4

Install

/plugin marketplace add itenium-be/Yoink
/plugin install yoink@yoink-marketplace

Manual Install

Running from a checkout, point ~/.claude/settings.json at the hook scripts. If the repo lives at ~/.claude/yoink:

"hooks": {
  "SessionStart": [
    { "hooks": [ { "type": "command", "command": "bash ~/.claude/yoink/hooks/notify-capture.sh" } ] }
  ],
  "Stop": [
    { "hooks": [ { "type": "command", "command": "bash ~/.claude/yoink/hooks/notify-fire.sh done" } ] }
  ],
  "Notification": [
    { "hooks": [ { "type": "command", "command": "bash ~/.claude/yoink/hooks/notify-fire.sh needs-input" } ] }
  ]
}

Note: Start a fresh session after installation. This will capture the window handle for correct screen display.

Usage

• Left click — activate the originating terminal.
• Right click — close the notification without activating the terminal.

Settings

Fully configurable by updating settings.json. Put your copy at ~/.claude/yoink/settings.json — it overrides the defaults bundled with the plugin and survives plugin updates. Custom sounds go in ~/.claude/yoink/sounds/.

Use the editor if you want to test-drive the different themes and options. It writes settings.json next to itself, so run it from a checkout and copy the result into ~/.claude/yoink/.

.\settings-editor.ps1

Configuration

Possible replacements for the notification body text.

Token	Resolves to
{{folder}}	Basename of the working directory
{{cwd}}	Full working-directory path
{{repo}}	Git repository name (top-level dir), empty outside a repo
{{branch}}	Current git branch
{{dirty}}	● when the working tree has uncommitted changes, else empty
{{message}}	Claude Code's notification reason (needs-input only)
{{last_prompt}}	Your most recent prompt
{{last_assistant}}	Claude's last message
{{model}}	Active model id
{{agents}}	Background agents still running (empty when none)
{{pending_tool}}	Name of the most recent tool call
{{permission_mode}}	auto / default / plan / acceptEdits
{{event}}	done or needs-input

Requirements

WSL with jq on PATH.

sudo apt install jq

Trigger manually

From a PowerShell prompt, in the repo directory:

.\show-notification.ps1 -Event done -Folder Notify
.\show-notification.ps1 -Event needs-input -Folder Notify

Switch	Effect
-Event	done (default) or needs-input
-Seconds <n>	Auto-close after n seconds (default: stay until focused/clicked)
-Folder <s>	Folder name shown in the card body
-Hwnd <n>	Terminal to flash + auto-close once it regains focus

Flash and auto-close on this terminal:

.\show-notification.ps1 -Event done -Hwnd ([int64](Get-Process -Id $PID).MainWindowHandle)

Tests

bash ~/.claude/yoink/tests/run.sh

Credits

Thanks to Wale-Durojaye Ayotomiwa for the awesome Claude mascot animations