Claude Code mod

heads-up

Watches the running session and shows a heads-up when something is off: failing tools or tests in a row, edits outside the project, a context spike, or a run that stalls.

Context & usage modsValidates on Claude Code 2.1.316 Source

Install

From source
git clone https://github.com/soenkenils/claude-code-mods.git
claude --plugin-dir ./claude-code-mods/heads-up

The repo has no marketplace file, so load the plugin folder directly with --plugin-dir.

What it can access

Reach
L1Reads: reads env vars, reads mod state, draws
Sees
every prompt, every tool call
Draws in
AbovePrompt
Hooks
session.startprompt.submitturn.startturn.completetool.callsession.measurecommand.runui.render

From a static scan of the mod's code by awesome-claude-code-mods. It shows what the code asks for, not a security review.

How Claude Code mods work

  • A mod is a plugin with a JavaScript or TypeScript module that runs inside Claude Code (version 2.1.287 or later). It can draw panes beside the transcript, a band above the prompt, buttons and toasts, restyle the spinner and tool rows, and watch or rewrite tool calls and prompts.
  • It installs like any plugin: add its marketplace with /plugin marketplace add owner/repo, then /plugin install name@marketplace.
  • Check what a mod can reach before installing: it runs with your permissions. Reach goes from drawing only, to reading files, to writing files or running processes, to the network. Run claude plugin validate on a clone to list its hooks and calls without running it.
  • Turn one off from the Installed tab in /plugin, or start Claude Code with --safe-mode to skip every customization for a session.
Claude Code docs

Details

Repository
soenkenils/claude-code-mods
Folder
heads-up
Author
Sönke
Type
Context & usage mods
Last updated
31 October 2026
Listed in
awesome-claude-code-mods

FAQ

What is heads-up?

Watches the running session and shows a heads-up when something is off: failing tools or tests in a row, edits outside the project, a context spike, or a run that stalls. It is a mod for Claude Code, from soenkenils/claude-code-mods on GitHub.

What can the heads-up mod access?

Its widest reach is "reads" (reads env vars, reads mod state, draws). It sees every prompt, every tool call. It draws in AbovePrompt. Like any mod, it runs with your permissions.

How do I install heads-up?

Clone soenkenils/claude-code-mods and start Claude Code with --plugin-dir pointing at the mod's folder (heads-up).

More context & usage mods

hawkeye

akkaradej/hawkeye

Bands above the prompt: session status dot, prompt-cache countdown, context ring, Reborn (continue in a new session), Suggest, Auto effort and auto-answered recommendations

Context & usage mods

hearth-band

koenrohrer/hearth-band

Hearth: a pixel creature per model beside a prompt-cache campfire, with your limits and context, animated above the prompt

Context & usage mods/plugin install

handover

pradyb/claude-mods

/handover writes a handover note from the conversation (served from the prompt cache), saves it under ~/.claude/projects/<project>/handovers/<session-title>.md, clears the session and continues from the note in a fresh context. Suggests it when context passes a threshold.

Context & usage mods/plugin install

hook-flow

legibleco/hook-flow

A side pane that shows Claude Code's agent loop as it runs: every hook event, a flow chart of the loop, a span timeline of each turn, and the tokens and dollars spent

Context & usage mods/plugin install

hamster

nickpotet/claude-hamster

A pixel hamster above the prompt in the Claude desktop app: it lives on your context window and tells you when to compact or clear. 110 tips on saving tokens, skills, plugins and MCP servers.

Context & usage mods/plugin install

hud

benelog/claude-mods

A colored line above the prompt with plan, organization, model, effort, context usage, prompt-cache state and rate-limit quota

Context & usage mods/plugin install

Browse the most popular Claude Code mods, all context & usage mods, or the skills and MCP server directories.