claude-mods

Small, beautiful mods for Claude Code. A mod is three files (a manifest, a hooks list, one TypeScript module) that can draw a pane beside the chat, a band above the prompt, a status-line entry, play a sound, register a slash command, or intercept a tool call. This repository is a plugin marketplace: every mod installs with one line.

Mod	Surface	What it does
pomodoro	band, status, command	/pomo focus timer with a progress bar and break nudge
context-gauge	band, status	context-window fill, cost and turns, colored by pressure
git-pulse	band	branch, staged, modified, untracked, ahead/behind, live
chime	audio	ding on a long turn, buzz on a tool error, chirp on a question
file-heat	pane	/heat ranks the files this session keeps touching
seatbelt	tool guard	refuses rm -rf /, force pushes, DROP TABLE, edits to secrets
timeline	pane	/timeline draws every turn as a strip of colored tool calls
scratchpad	pane, input	/pad notes that survive sessions, one press into the prompt
snippets	prompt rewrite	;;name expands to saved text before the model reads it
rubber-duck	pane, model	/duck asks you questions and never gives answers

More mods are coming soon. Stay tuned.

Install

The marketplace is on GitHub at Adityakumar-blip/claude-mods. Pick one of two ways.

Inside Claude Code

1. Start Claude Code and run the install command for the mod you want:

   /plugin install pomodoro --marketplace Adityakumar-blip/claude-mods
   

2. Answer y to add the marketplace.

3. Pick a scope (user, project or local).

From a terminal

1. Add the marketplace once:

   claude plugin marketplace add Adityakumar-blip/claude-mods
   

2. Install a mod by name, using <mod>@claude-mods:

   claude plugin install pomodoro@claude-mods
   

3. Restart Claude Code, or start a new session, so the mod loads.

Mods with options (pomodoro, context-gauge, chime, seatbelt, rubber-duck) show them in /config once installed.

From a local checkout

git clone https://github.com/Adityakumar-blip/claude-mods.git
claude plugin marketplace add /path/to/claude-mods
claude plugin install pomodoro@claude-mods

Try one without installing

claude --plugin-dir mods/timeline

The folder is watched: save a file and the mod reloads.

Hacking

• claude plugin validate mods/<name> reads the manifest and module the way the engine will.
• Each mod's types/index.d.ts is its state contract. Change the shape tag on an atom when a stored value's fields change.
• Bands compose: each band mod draws its own row and then whatever is beneath it, so several can be installed together.
• Built against Claude Code 2.1.310. The hooks API is early access and moves between releases.

Contributing a mod

One folder under mods/, a README with a screenshot or GIF of it running, a passing claude plugin validate, and an entry in .claude-plugin/marketplace.json. Keep it to one idea. Nothing in a mod may read or send anything outside the session without saying so in its README.