Profile
Back to NewsBack
GitHub Trending 5 min
Reader Mode
hamzafer/claude-code-mods: Claude Code mods: plugins built on hooks that add live lines above the prompt, guards, panes and games. Context bar, usage meter, Codex review watch, Markdown preview, Spotify now playing and more.

hamzafer/claude-code-mods: Claude Code mods: plugins built on hooks that add live lines above the prompt, guards, panes and games. Context bar, usage meter, Codex review watch, Markdown preview, Spotify now playing and more.

17 hours ago

Claude Code mods

Make Claude Code show what it's doing.
Plugins for Claude Code, built on function hooks: live lines above the prompt, guards, panes and games. Install only the ones you want.

MIT CI

Install · All mods · Docs · What are mods?

context-bar: Claude Code context window usage as a stacked bar, a color per category
📊 context-bar
what fills your context
review-watch: live lines for running Codex and subagent code reviews in Claude Code
🔍 review-watch
running code reviews, live
md-preview: Markdown that Claude Code edits, rendered like GitHub next to the diff
📝 md-preview
Markdown rendered like GitHub
blast-radius: a Claude Code hook holds rm -rf and lists the files it would delete
💥 blast-radius
see what rm -rf would delete
now-playing: Spotify track, progress bar and synced lyrics inside Claude Code
🎵 now-playing
Spotify and its lyrics, live
reels: YouTube Shorts in a Claude Code pane while it works
📱 reels
Shorts while Claude works
where-am-i: the session goal, current step and what waits on you, above the Claude Code prompt
📍 where-am-i
goal, now, waiting on you
token-weather, usage-meter and other Claude Code status lines stacked above the prompt
🌦️ token-weather and friends
lines above the prompt
mission-control: Claude Code subagents, tool calls and the files they touch, live
🛰️ mission-control
agents and the code they touch

🚀 Install

Add the marketplace once, then install any mod by name:

claude plugin marketplace add hamzafer/claude-code-mods
claude plugin install context-bar@claude-code-mods

Or install the general-purpose set in one go:

for m in context-bar token-weather usage-meter where-am-i next-steps agent-radar review-watch replay-theater md-preview blast-radius mission-control; do
  claude plugin install "$m@claude-code-mods"
done

Restart Claude Code after installing. To try one without installing:

git clone https://github.com/hamzafer/claude-code-mods && cd claude-code-mods
claude --plugin-dir mods/context-bar
Needs Claude Code 2.1.287+. A few mods need more (Chrome, gh, a connector); the tables say which.

🧩 The mods

👀 See what's happening

| | Mod | What it does | Command | | --- | --- | --- | --- | | 🛰️ | mission-control | Live map of agents, tool calls and the code they touch | /mission | | 📊 | context-bar | Your context window as one stacked bar, a color per category, with token counts and where it compacts | /context-bar | | 🌦️ | token-weather | Context fill from Clear to Compact soon, plus a prompt-cache countdown | | | ⏱️ | cache-clock | A prompt-cache line under your status line, from Claude Code's own figures: time left, hit rate and misses, and the tokens your next message re-caches once it goes cold. Needs Node and Claude Code 2.1.251+ | /cache-clock setup | | 📍 | where-am-i | Goal, doing now, waiting on you, next step | /where | | ➡️ | next-steps | 2 or 3 likely next prompts after each turn, one key to draft one | 1 2 3, 0 hides | | 💰 | usage-meter | 5-hour and 7-day plan usage, the reset countdown and the session's cost | | | 💳 | openai-balance | Your OpenAI API credit: an estimated balance with a gauge, today's spend, and the model and key of the last call. Needs an OpenAI organization Admin key | /openai-balance | | 📡 | agent-radar | One live line per running subagent | /radar | | 🔍 | review-watch | One live line per running code review (Codex or a review subagent) with the model, target, elapsed time and Codex's latest output. A toast lists the findings when it ends | | | 🌐 | browser-lanes | Whether this session has a browser, and who holds it | /browser | | 🕌 | prayer-times | The current prayer and how long is left, the next one, and zawal. Computed on your computer, Hanafi or standard Asr | /prayers | | 🎬 | replay-theater | Steps through the last turn's edits, one diff at a time | /replay | | 📝 | md-preview | Renders the Markdown files Claude edits like GitHub does, with before and after side by side. Needs Chrome and a terminal that shows images | /md |

🛡️ Guard your repo

| | Mod | What it does | Command | | --- | --- | --- | --- | | 💥 | blast-radius | Holds rm -r, force pushes and migrations, shows what they'd delete, cancels after 60 s with no answer | |

💸 Spend less

| | Mod | What it does | Command | | --- | --- | --- | --- | | 🔀 | switchboard | Picks the model for each subagent that doesn't name one, with OpenAI's Decisions API or Jev, from its short label only. Shows what every subagent cost | /route |

🔧 My setup (fork and adapt)

These are built around my own tools and rules. Fork them and change the rules to yours.

| | Mod | What it does | Command | | --- | --- | --- | --- | | 👀 | glance | One line with what needs you: next meeting, PRs, Linear issues, Slack DMs. Needs gh and the Google Calendar, Linear and Slack connectors | /glance | | 🚦 | merge-gate | Holds gh pr merge until CI is green and Codex reviewed once. Needs gh and the Codex CLI. Reviews run on one fixed model; change it to yours | /gate | | 📏 | rulebook-guard | Enforces my writing and git rules: rewrites em dashes, asks before --amend, unformatted pushes, emails and phone numbers in notes | | | 💾 | session-saver | Saves where you left off, shows it on resume. Needs unpause | /park [note] |

🎮 For fun (opt-in)

| | Mod | What it does | Command | | --- | --- | --- | --- | | 📱 | reels | YouTube Shorts while Claude works, pauses when it's done | /reels | | 🐍 | snake | Snake while Claude works | /snake | | 🎵 | now-playing | What Spotify is playing, with a progress bar, the lyric being sung, and ⏮ ⏸ ⏭ buttons. Needs macOS and the Spotify app | /music |

🛰️ Flagship: mission-control

Every subagent, every tool call and every file they touch, in a pane next to the chat. Shown at 4x: two subagents building a logout feature across four files.

!mission-control at 4x: two subagents and a logout feature landing across four files

Install it like any mod, restart, and type /mission (or /mission code to open the code map). q closes it.

  • 🤖 w shows the agents and every tool call, live
  • 🗺️ c shows the code map, with import arrows
  • 🔵 Blue while the agent reads a file
  • 🟠 Orange while it writes
  • 🟢 Green when done, with one line on what changed
The Code view also needs macOS, Google Chrome and a terminal that shows images (Ghostty, kitty, iTerm2). The Who view works everywhere.

📚 More

Chat with me