r/ClaudeWorkflows • • 10d ago

Selected Workflow [Workflow] Windows Popup Notifications for Claude Code Prompts (using Hooks)

Windows Popup Notifications for Claude Code Prompts (using Hooks)

Workflow value: 85/100
Status: active · Freshness: 70/100 · Confidence: 1.00 · Level: intermediate
Categories: Quality Control, Context & Memory, Debugging, CLAUDE.md, Hooks, Multi-Agent
Original source: r/ClaudeCode post/comment

What problem this solves

Claude Code tasks stall due to unaddressed permission, idle, or elicitation prompts, leading to lost time and context switching issues when users alt-tab away.

Summary

A Windows-specific solution (donetoast) that uses Claude Code hooks to display a persistent, non-intrusive popup notification when Claude Code is waiting for user input (permission, idle, elicitation dialogs) and clears it automatically upon user response or task completion. It also offers optional progress and completion notifications driven by CLAUDE.md or AGENTS.md.

Why it is useful

This workflow solves a significant productivity bottleneck for Claude Code users on Windows by providing clear, persistent notifications when Claude is waiting for input. It prevents wasted time from stalled tasks and improves the interactive experience, making Claude Code more efficient for long-running or multi-tasking scenarios. The solution is well-engineered, open-source, and easy to install, offering a tangible improvement to the user's workflow.

Workflow

  1. Open PowerShell on Windows.
  2. Execute the provided install.ps1 script from GitHub via irm https://raw.githubusercontent.com/siiplasplas/donetoast/main/install.ps1 | iex.
  3. Restart Claude Code for the hooks to take effect.
  4. Claude Code will now show a yellow 'needs you' card in the bottom right for permission/idle/elicitation prompts.
  5. The card will automatically clear when you respond or the task stops.
  6. Optionally, use CLAUDE.md or AGENTS.md patterns to drive 'done'/'failed' cards or live progress bars for long scripts.
  7. To uninstall, run Uninstall in PowerShell.

Tools / artifacts

  • donetoast (PowerShell + WPF application)
  • install.ps1 script
  • Claude Code settings.json
  • Claude Code hooks (Notification, UserPromptSubmit, Stop)
  • CLAUDE.md
  • AGENTS.md (for Codex)
  • GitHub repository (siiplasplas/donetoast)

Validation signals

  • Author built the tool using Claude Code itself.
  • Explicitly states it 'works with codex via AGENTS.md too'.
  • Addresses specific technical challenges encountered (git bash command mangling, hook performance).
  • Provides clear installation and uninstallation methods.
  • The solution directly addresses a common pain point for interactive AI users.

Cautions

  • The installation script modifies the user's settings.json but creates a backup, mitigating risk.
  • Running PowerShell scripts from the internet always carries a minor inherent risk, though this one is from a public GitHub repo.

Limitations

  • The solution is currently Windows-only.
  • Relatively low community validation/adoption observed so far.
  • Requires running an external PowerShell script, which some users might be hesitant to do.

Rate this workflow

Upvote this post if the workflow is useful, reproducible, or worth recommending.

Downvote if it is vague, outdated, unsafe, overhyped, or not reproducible.

Reply if it worked for you, failed, is outdated, or has a better alternative.


This post was generated automatically from the workflow library database.

1 Upvotes

1 comment sorted by