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.

Install · All mods · Docs · What are mods?

📊 context-bar what fills your context	🔍 review-watch running code reviews, live	📝 md-preview Markdown rendered like GitHub
💥 blast-radius see what rm -rf would delete	🎵 now-playing Spotify and its lyrics, live	📱 reels Shorts while Claude works
📍 where-am-i goal, now, waiting on you	🌦️ token-weather and friends lines above the prompt	🛰️ mission-control agents and the code they touch

🚀 Install

npx claude-code-mods@latest

Tick the mods you want in a checklist, see what each one adds, and press Enter to install. Untick a mod to disable it (its settings stay). Restart Claude Code after. @latest makes npx skip an old cached copy.

• --project installs for this project only
• --dry-run prints the claude commands instead of running them
• --pick a,b turns on exactly these mods, no checklist

It edits the Claude profile that claude uses here, shown at the top. For another profile, set it first: CLAUDE_CONFIG_DIR=~/.claude-other npx claude-code-mods@latest.

Order your bands

Press o in the checklist to order your bands (the lines above the prompt). Move the cursor with up/down or j/k, move a band with Shift+up/down or K/J, and press Enter to save. Esc goes back without saving. The order goes to <config dir>/claude-code-mods/bands.json, where the config dir is CLAUDE_CONFIG_DIR or ~/.claude. Restart Claude Code to apply it. Bands not in the file sit on top.

Other ways

By hand:

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

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. language sets their language	1 2 3, 0 hides
💰	usage-meter	5-hour and 7-day plan usage, the reset countdown and the session's cost
🔥	heatmap	A GitHub-style grid of your Claude Code time, with your streak, peak hours and top projects	/heatmap
💳	openai-balance	Your OpenAI API credit: an estimated balance with a gauge, today's spend, where the money mostly went, and the last call. Needs an OpenAI organization Admin key	/openai-balance
🪙	openrouter-balance	Your OpenRouter credit: the real balance with a gauge, today's spend and the model the money mostly went to. A regular API key shows the balance too when OpenRouter allows it, plus its own spend and limit	/openrouter-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

🤝 Community mods

Mods by other people, in their own marketplaces. They're not maintained here, so read the code before you install.

	Mod	What it does	Install
🏷️	last-prompt-title by @zhangbububu	Session titles that follow your latest prompt: cut for the CLI, written by Haiku for the desktop sidebar	claude plugin marketplace add zhangbububu/session-titles then claude plugin install last-prompt-title@session-titles
🌏	cc-zh by @jiangnanquan	Simplified Chinese UI localization via static dictionary: slash-command descriptions, /config labels, spinner, hints, notices, command output, tool summaries and turn duration. Zero tokens / network; verified on CC 2.1.296	claude plugin marketplace add jiangnanquan/claude-code-zh then claude plugin install cc-zh@claude-code-zh
🎛️	subagent-tuner by @Kruhlikau	Picks the model and effort of every subagent: a Manual/Auto band, a pick pane, review → Opus and search → Haiku, and a saved default that overrides what the agent asked for	claude plugin marketplace add Kruhlikau/subagent-tuner then claude plugin install subagent-tuner@subagent-tuner
🛒	mod-store by @hellosverre	An app store in a pane: /mods browses, searches and installs about 2,700 community mods, with what each one can access shown before you install. Or ask Claude to find one	claude plugin marketplace add hellosverre/mod-store then claude plugin install mod-store@mod-store
📈	cache-meter by @T-AI-Labs	The share of each turn the prompt cache served, next to the context fill, with an auto-compact threshold and Compact and Clear buttons	claude plugin marketplace add T-AI-Labs/claude-code-mods then claude plugin install cache-meter@T-AI-Labs
⏳	usage-limits by @T-AI-Labs	5-hour and weekly plan limits in percent, with the time left until each resets	claude plugin marketplace add T-AI-Labs/claude-code-mods then claude plugin install usage-limits@T-AI-Labs

Built one? Open a PR that adds a row.

🛰️ 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.

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

• 📖 docs/mods.md: how they behave, setup notes and build your own
• 🎥 docs/demo.md: videos and screenshots
• ⭐ Earlier project: cursor-commands , 600+ stars for Cursor slash commands
• 🤝 CONTRIBUTING.md: add your own mod