All shelves / Mods / Workflow
mod-heads-up
By v-amorim
mod-heads-up is a Claude Code workflow mod by v-amorim.
Draws a card above the prompt with one thing you might miss, and a Heads up panel of notes by turn; the side check behind them is off until you turn it on.
Draws
Install
The marketplace name is claude-mods.
/plugin marketplace add v-amorim/moonlight-claude-mods /plugin install mod-heads-up@claude-mods
It runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.
- Version
- 2.0.0
- License
- MIT
- Repo stars
- 5
- Last change
- 2026-10-30
What it can reach
- Draws in the session
- Reads usage or context figures
Needs Claude Code 2.1.287 or newer; the author tested on Windows Terminal and macOS iTerm2. /plugin install asks where to install the mod: keep Install for you (user scope), press Enter, press Esc to leave the plugin screen, then run /reload-plugins. Auto-update is off for unofficial marketplaces; turn it on under /plugin, Marketplaces, claude-mods. The README warns that mods are not sandboxed and run with your permissions. Opens by itself or from the Heads up pill. By default the mod makes no model call. Turn on Check while Claude works and every sixth step of a turn, at most once per turn, a side check reads the session, which spends tokens and counts against your plan quota; each Reword click makes one more call. The command hooks need a POSIX shell, Git Bash on Windows; without one they write nothing and the mod falls back to what it can find on its own.
The marketplace, claude-mods, holds 13 mods in the Moonlight look, and other repositories use that name too, so add v-amorim/moonlight-claude-mods. Flagging the one thing you might miss during a long turn is why this page files it under workflow. loop-breaker notices Claude going in circles, the same command failing 3 times or the same code rewritten 3 times in a turn, tells you, and tells Claude to stop and rethink. aside opens a pane beside the transcript where you ask about the session so far, answered by a tool-less fork that writes nothing back. This one asks a model to read the session on every sixth step of a turn, at most once per turn, and most checks show nothing. A note shows as a card with its tag, You should know or Heads up, and the panel keeps every note under its turn with Got it, Ask Claude, and Reword. Hovering the pill after a turn shows how long it took, the subagents it started, its edits and tool errors, and how much the session cost grew.
Demo

What it hooks into
ui.toastA Claude Code eventsession.startWhen a session startscommand.runWhen you run its slash command/mod-heads-upturn.stepAt each step of a turnturn.startWhen Claude starts a turnturn.completeWhen a turn endstool.callAround a tool call, where it can hold oneagent.spawnWhen a subagent startsprompt.submitWhen you send a promptui.renderDraws into the sessionUserMessageAbovePromptPanesession.endWhen a session endsui.closeWhen its pane closesstate.setA Claude Code eventui.messageAdds a message to the session
Read from the on() calls in its hook modules. Open its source under Files to check what each one does.
Slash commands 1
/mod-heads-up
Hooks 2
SessionStartexec 2>/dev/null; IN=$(cat); D="${CLAUDE_CONFIG_DIR:-$HOME/.claude}/mods-data/mod-heads-up/bridge"; S=$(printf '%s' "$IN" | sed -n 's/.*"session_id":"\([^"]*\)".*/\1/p'); [ -n "$S" ] && mkdir -p "$D" && printf '%s\n' "$IN" >> "$D/$S.jsonl" && find "$D" -name '*.jsonl' -type f -mtime +7 -exec rm -f {} + >/dev/null 2>&1; exit 0SessionEndexec 2>/dev/null; IN=$(cat); D="${CLAUDE_CONFIG_DIR:-$HOME/.claude}/mods-data/mod-heads-up/bridge"; S=$(printf '%s' "$IN" | sed -n 's/.*"session_id":"\([^"]*\)".*/\1/p'); [ -n "$S" ] && rm -f "$D/$S.jsonl" >/dev/null 2>&1; exit 0
Files
The author's README and source, 4 files. They load when you open them.
Facts
- Author
- v-amorim
- Category
- Workflow
- Marketplace
- claude-mods
- Folder
- mod-heads-up
- Version
- 2.0.0
- License
- MIT
- Repo stars
- 5
- Last change
- 2026-10-30
- Language
- TypeScript
- Files
- 37