What is heads-up?
heads-up is a Claude Code mod by IanTerHaar that a popup at the top right and a boxed notice above the prompt when Claude is waiting on you, a tool call fails or a long turn finishes. It is listed under Interface and has no public popularity data yet.
| Type | Claude code mod |
|---|---|
| Author | IanTerHaar |
| Repository | IanTerHaar/ith-mods |
| Popularity | no public popularity data yet |
| Category | Interface |
| Security | Low risk (84/100) |
| Rank | #3,406 of 5,272 Claude Code mods; #1,414 in Interface |
| Last commit | 2026-10-09 |
| Hooks | 6 events |
| Sees | classic hooks, every prompt, every tool call |
| Draws on | AbovePrompt |
Is heads-up safe to install?
heads-up scores 84/100 on the MCPMods security check: Low risk. Things to review: watches every prompt or event. It passed 6 of 8 checks.
Mod footprints come from claude plugin validate, which lists every event a mod hooks and every API call it makes without running it.
| Check | Result |
|---|---|
| No network access | Pass |
| Starts no processes | Pass |
| Writes no files or config | Pass |
| Doesn't read environment variables | Pass |
| Watches every prompt or event | Review |
| Doesn't drive Claude | Pass |
| Passes claude plugin validate | Pass |
| No license detected | Note |
API calls in its code
| Call | What it means |
|---|---|
$.clock.now | |
$.ui.invalidate | draws interface |
$.ui.resolve | draws interface |
$.ui.toast | draws interface |
How do I install heads-up?
- Check your Claude Code version. Mods need Claude Code 2.1.287 or later and are on by default.
claude --version
- Read its footprint. This lists every event it hooks and every API call it makes, without running it.
git clone https://github.com/IanTerHaar/ith-mods claude plugin validate ./ith-mods/plugins/heads-up
- Install it. Run this in your terminal, then /reload-plugins in an open session.
claude plugin marketplace add IanTerHaar/ith-mods && claude plugin install heads-up@ith-mods
Or ask Claude to set it up
Paste this into Claude Code and it installs heads-up for you:
Install the "heads-up" Claude Code mod from https://github.com/IanTerHaar/ith-mods/tree/main/plugins/heads-up. Run claude plugin validate on it first and show me what it can access before you enable it.
More from IanTerHaar/ith-mods
This repository has 6 Claude Code mods on MCPMods.
- context-bar: Progress bar above the prompt showing context used, e.g. 111.2k / 1M (Low risk)
- file-tree: File tree of the session cwd in the sidebar, with git status and a shimmer on files Claude touches. A trimmed fork of Ku (Review before installing)
- reels: Instagram Reels open while Claude is working, and close when the turn ends or Claude is waiting on you (Review before installing)
- ruin: RUIN, a retro first-person shooter you play in a pane: four levels, textured walls, enemies, keys, weapons (/ruin) (Low risk)
- usage-limits: Shows how much of the 5-hour and weekly limits is left, above the prompt (Low risk)