Hush Puppy 🐕

Quiet, visual tab notifications for Claude Code. Never miss when Claude needs your input.

Why?

When running multiple Claude Code sessions, it's hard to know which tab needs attention. This hook changes the terminal tab title to 🔴 INPUT NEEDED - [project] when Claude finishes and is waiting for your input.

No sounds. No popups. Just a quiet visual indicator.

Install

curl -fsSL https://raw.githubusercontent.com/avtomate/hush-puppy/master/install.sh | bash

Then restart Claude Code.

Uninstall

curl -fsSL https://raw.githubusercontent.com/avtomate/hush-puppy/master/uninstall.sh | bash

How it works

Uses Claude Code's hooks system with 3 hooks working together:

Hook	Action
UserPromptSubmit	Clears title when you submit a prompt
PreToolUse	Clears title when Claude uses tools (keeps it clear while working)
Stop	Sets "🔴 INPUT NEEDED" when Claude finishes

This ensures the notification only appears when Claude is truly waiting for your input, not during tool execution or subagent work.

Compatibility

• Linux ✅ (tested on WSL2 + Windows Terminal)
• macOS ✅ (should work, untested)
• Windows ⚠️ (WSL only)

Manual Install

If you prefer not to pipe to bash:

git clone https://github.com/avtomate/hush-puppy.git /tmp/hush-puppy
cd /tmp/hush-puppy && ./install.sh
rm -rf /tmp/hush-puppy

Related

• Feature Request #7229 - Vote for built-in support!

License

MIT