BeLazy167@BeLazy167
BeLazy167/claude-mods-skill/tree/main/examples/branch-band
GitHub repositories · by BeLazy167
branch-band
Example Claude Code mod that shows the current git branch and working-tree status in a band above the prompt, refreshed on a timer via $.process.run and held in $.state.
About this mod
branch-band is an example Claude Code mod shipped in the claude-mods-skill repository. It displays a band above the prompt containing the current git branch and working-tree status, refreshed on a timer using $.process.run and stored in $.state. It runs git branch --show-current and git status --porcelain from a TypeScript function-hook module that loads inside Claude Code (requires 2.1.287 or later; tested with 2.1.290). The repository provides installation via /plugin install claude-mods-skill --marketplace BeLazy167/claude-mods-skill or claude plugin marketplace add plus claude plugin install, and the example can be tried for a session with claude --plugin-dir examples/branch-band. Each example passes claude plugin validate, claude plugin test and tsc, and a scripts/check.sh helper re-validates all examples after Claude Code updates.
Installation
Check the author's README for the marketplace and plugin name first. Commands may change as the repository evolves.
claude plugin marketplace add BeLazy167/claude-mods-skill claude plugin install branch-band@claude-mods-skill
Original text / README
claude-mods-skill
A Claude Code skill that teaches an agent how to build Claude Mods:
plugins whose behaviour is a TypeScript function-hook module that runs
inside Claude Code. It ships five small example mods that the agent copies.
Each example passes claude plugin validate, claude plugin test and tsc.
Tested with Claude Code 2.1.290. Mods need 2.1.287 or later and are on
by default. The old CLAUDE_CODE_ENABLE_FUNCTION_HOOKS flag is ignored;
remove it from your settings.
Claude Code also has a built-in plugin-authoring skill. That one knows
your exact build. This skill sits on top of it: tested examples, traps seen
on real builds, and how to prove and ship a mod.
Install
At the Claude Code prompt:
/plugin install claude-mods-skill --marketplace BeLazy167/claude-mods-skill
Or from your shell:
claude plugin marketplace add BeLazy167/claude-mods-skill
claude plugin install claude-mods-skill@claude-mods-skill
Then ask Claude to build a mod. The creating-mods skill loads on its own.
What is inside
skills/creating-mods/SKILL.md: the workflow, which example to copy, quick reference, loader rules, sharing.skills/creating-mods/references/gotchas.md: version-tagged traps from real builds.skills/creating-mods/references/examples.md: Anthropic and community mods worth reading.examples/:
| Example | Shows |
|---|---|
| hello-mod | Block a tool call; fail-closed .catch; smoke.sh proves the deny |
| redact-output | Rewrite Bash output before the model reads it |
| branch-band | Git branch above the prompt; $.process.run on a timer; $.state |
| notes-pane | /note and /notes; a pane with a Button; $.store |
| dice-tool | A tool the model can call |
Try one for a session: claude --plugin-dir examples/notes-pane.
Keeping it current
The mods API changes between releases. After a Claude Code update, run:
scripts/check.sh
It validates, tests and type-checks every example against your build.
Links
- Docs: https://code.claude.com/docs/en/plugins/mods/overview
- Built-in mods source: https://github.com/anthropics/claude-code/tree/main/mods
- Design thread: https://github.com/anthropics/claude-code/issues/91870
- Community catalogue: https://github.com/karanb192/awesome-claude-code-mods
Other works with the same name
- branch-bandbaselane-sh · ★ 1
Similar projects
ruvnet@ruvnet
Documentation generation, drift detection, and API docs automation plugin that also acts as a function-hook guard refusing doc writes or worker dispatch containing secrets.
claude / ruflo-docs
❯ /ruflo-docs▰▰▰▰▰▰▰▰ Dashboards & HUD
✳︎ ruflo-docs
└─ Make every conversation easier
Text preview · Not a project screenshot✳︎ ruflo-docs
└─ Make every conversation easier
ruflo-docs
Stars 74.4KPermission footprint L2
Repowise ships Lens, a Claude Code mod that visualizes your indexed codebase in real time—files light up as Claude searches, reads and edits them, and importers/reverse dependencies highlight too. It includes a Flow tab showing impacted files and covering tests, plus a review row with health changes and a button to run suggested tests.
A claude code mod that shows every file an edit touches
Stars 7.5KPermission footprint L3
alexgreensh@alexgreensh
A status bar for the Claude desktop app. It draws above your prompt and shows session quality, context fill, cache countdown, and your 5-hour and weekly limits, with Clawd acting out what the session is doing.
claude / token-optimizer
❯ /token-optimizer▰▰▰▰▰▰▰▰ Dashboards & HUD
✳︎ token-optimizer
└─ Make every conversation easier
Text preview · Not a project screenshot✳︎ token-optimizer
└─ Make every conversation easier
token-optimizer
Stars 2.5KPermission footprint L32 with this name