Skip to content

Latest commit

 

History

58 Commits

Folders and files

Repository files navigation

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
📡 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 Haiku, Sonnet or Opus for each subagent before it starts, using Jev or simple rules. Shows each pick and what the run cost compared with the model Claude asked for /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

About

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.

Topics

Resources

Contributing

Security policy

Stars

120 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages