ClaudeCodeMod

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.

In Claude Code
/plugin marketplace add v-amorim/moonlight-claude-mods
/plugin install mod-heads-up@claude-mods
Open the repo

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

The Features section of the author's README: a side check every sixth step of a long turn, a note card above the prompt tagged You should know or Heads up, the Heads up panel with Got it, Ask Claude and Reword, and the Last turn summary on the pill.
Screenshot of the author's GitHub page.

What it hooks into

  • ui.toastA Claude Code event
  • session.startWhen a session starts
  • command.runWhen you run its slash command/mod-heads-up
  • turn.stepAt each step of a turn
  • turn.startWhen Claude starts a turn
  • turn.completeWhen a turn ends
  • tool.callAround a tool call, where it can hold one
  • agent.spawnWhen a subagent starts
  • prompt.submitWhen you send a prompt
  • ui.renderDraws into the sessionUserMessageAbovePromptPane
  • session.endWhen a session ends
  • ui.closeWhen its pane closes
  • state.setA Claude Code event
  • ui.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 0
  • SessionEndexec 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
Repo
v-amorim/moonlight-claude-mods
Folder
mod-heads-up
Version
2.0.0
License
MIT
Repo stars
5
Last change
2026-10-30
Language
TypeScript
Files
37

Other mods in Workflow

mod-managerv-amorimDraws a panel that lists every mod, installs the ones you tick, turns them on or off, updates them, and edits their settings; a first-run card starts it.mod-model-effortv-amorimDraws a pill with the session's model and effort level; a click changes either, and hovering shows the last reply's time to first token and tokens per second.mod-next-stepsv-amorimDraws up to three one-line next prompts above the input after each finished turn; a click puts one in the prompt to edit, and nothing is sent.mod-progressv-amorimDraws a Progress panel of the main session and each subagent: model, effort, context, tokens, time and gates, with their background shells and live output.mod-promptsv-amorimDraws a Prompts sidebar of every prompt in the session with its full text; a button jumps the transcript back to it, and a Chain tab lists handed-off sessions.mod-skill-panelv-amorimDraws a Skills panel of your skills and agents, grouped by color tag and model; a click adds one to the prompt, and tags badge skills in the slash list.mod-wrap-upv-amorimDraws a Wrap up pill that hands off to a fresh session or fills /compact with what you keep, and can hand off by itself at 400K tokens or 65% of the window.kairos-forgeVilelaAIHolds a commandDraws a panel of the delivery arc and a band when a human gate waits, asks before a call a revert cannot undo, and masks secrets in tool output.altimate-codeAltimateAIDraws a band for GitHub, Jira and Linear credentials it finds, an /integrations pane, and a /lineage pane of the dbt model Claude reads or edits.xcrewbreferrariHolds a commandDraws a live line above the prompt for each Xcode build and test, gives Claude only the failures, and asks you before Claude rewrites a generated project file.commit-medev-build-deployHolds a commandDenies a git commit whose message is not a Conventional Commit, with commit-me's error text and the allowed types and scopes, so Claude rewrites it.noctia-modsEtienneP-26Draws a Noctia band above the prompt, a side panel of subagents, an agent graph, a task checklist, and toasts when a Noctia guard blocks or questions a command.
All 396 in Workflow