---
title: "branch-band"
url: "https://claudemods.dev/ja/builds/branch-band-357a65"
source: "https://github.com/BeLazy167/claude-mods-skill/tree/main/examples/branch-band"
source_type: "github"
repo: "https://github.com/BeLazy167/claude-mods-skill/tree/main/examples/branch-band"
author: "BeLazy167"
author_handle: "BeLazy167"
stars: 9
category: "ダッシュボード・HUD"
categories: ["hud"]
tags: ["git-branch", "hooks", "process-run", "state", "statusline"]
permission_level: 2
scan_complete: true
install: "claude plugin marketplace add BeLazy167/claude-mods-skill\nclaude plugin install branch-band@claude-mods-skill"
added: "2026-10-12T04:02:11.567Z"
updated: "2026-10-06T05:05:14Z"
locale: "ja"
content_locale: "ja"
---

# branch-band

プロンプトの上に現在の git ブランチと作業ツリーの状態を表示する Claude Code モッドの例。$.process.run で定期的に更新し、$.state に保持します。

## Description

branch-band は claude-mods-skill リポジトリに含まれる Claude Code モッドの例です。プロンプトの上に現在の git ブランチと作業ツリーの状態を含むバンドを表示し、$.process.run を使用して定期的に更新され、$.state に保存されます。Claude Code 内で読み込まれる TypeScript 関数フックモジュールから git branch --show-current と git status --porcelain を実行します（2.1.287 以降が必要、2.1.290 でテスト済み）。このリポジトリでは /plugin install claude-mods-skill --marketplace BeLazy167/claude-mods-skill または claude plugin marketplace add と claude plugin install によるインストールを提供しており、この例は claude --plugin-dir examples/branch-band でセッション中に試すことができます。各例は claude plugin validate、claude plugin test、tsc を通過し、scripts/check.sh ヘルパーが Claude Code の更新後にすべての例を再検証します。

## Install

```
claude plugin marketplace add BeLazy167/claude-mods-skill
claude plugin install branch-band@claude-mods-skill
```

## Original 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:

```sh
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:

```sh
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
