hamzafer / claude-code-mods

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
 [code] 
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 ` /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:
 [code] 
To try one without installing:
 [code] 
> **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, `layout: rows` keeps one per row | `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`