Claude Code の Git ブランチ表示：ブランチと変更をプロンプトの上に

Claude Code の Git ブランチ表示 Mod は、入力欄の上に 1 行を追加し、Git 上のどこにいるのかを教えてくれます。表示はたとえば ⎇ main · 3 changed · ↑1 ↓0 のようになります。ブランチ名、git status が変更ありと報告したパスの数、そしてブランチがアップストリームよりどれだけ先行・遅行しているかがわかります。HEAD が detached の場合は、代わりに短いコミットハッシュを表示します。Git リポジトリの外では、この行は表示されません。

特に役立つのは、Claude があなたの代わりに編集しているときです。セッションがフィーチャーブランチではなく main で始まってしまった場合もすぐに気づけますし、Claude が編集するにつれて変更数が増えていくので、レビューとコミットのタイミングがわかります。Claude Code 2.1.287 以降が必要です。

録画では、小さなデモ用プロジェクトでこの Mod を読み込んだ状態の Claude Code を起動しています。最初のプロンプトを入力する前から、入力欄の上の帯にはブランチと変更ファイル数が表示されています。続いて Claude に src 内のファイル一覧を頼むと、ターンの実行中も帯はその場に残り、ターンが完了すると更新されます。

インストールブロックにある 3 つの方法のどれでもかまいません。1 行で済む方法は実行中のセッション内で使えます。シェルからの方法では、すでに開いているセッションで /reload-plugins を実行する必要があります。

この Mod は最新の Git の状態を $.state のアトムに保持し、AbovePrompt の描画箇所に表示します。hooks/register.tsx のフックは次のとおりです。

on('session.start', async ($, e, next) => {
  const started = await next(e)
  await refresh($)
  $.clock.every(intervalMs, () => {
    refresh($).catch(() => undefined)
  })
  return started
})

on('turn.complete', async ($, e, next) => {
  const result = await next(e)
  if (e.agentId === undefined) await refresh($)
  return result
})

on('tool.call', { tool: 'Bash' }, async ($, e, next) => {
  const ran = await next(e)
  if (mentionsGit(e.command)) await refresh($)
  return ran
}).catch(($, e, next) => next(e))

更新のタイミングは 3 つあります。session.start は最初の読み取りを行い、Claude Code の外で行われた変更を拾うためのタイマーを開始します。turn.complete はメインループの各ターンの後に更新します。サブエージェントのターン（agentId を持つもの）はスキップされます。Bash 向けの tool.call フックは、まず await next(e) でコマンドを実行させ、そのコマンドが git や gh pr checkout/merge に触れている場合にだけ更新します。その .catch は呼び出しをそのまま通すので、Mod 側で失敗が起きてもコマンドがブロックされることはありません。

refresh は $.session.cwd() で git status --porcelain=v1 -b を 1 回だけ実行します。この 1 つのコマンドでブランチ、アップストリーム、ahead/behind、変更一覧がすべて得られるので、rev-parse や rev-list を別に呼び出す必要はありません。hooks/git.ts の純粋関数 parseStatus は、コミットがまだない新しいリポジトリや detached HEAD にも対応しています。Git が見つからない、または応答が遅い場合は、古いデータを表示するのではなく帯を非表示にします。

以下のオプションは、/config の Mod 名の下で変更できます。変更すると Mod は新しい値で再読み込みされます。タイマーのデフォルト値は register の先頭にある Math.max(2_000, ... 15_000) で設定されており、これが 2 秒の下限も保証しています。帯の見た目を変えたい場合は、ui.render フック内の Text 要素を編集してください。ブランチ名は cyan の bold で、詳細は dimColor で描画されています。

コマンドを実行 が表示されるのは、この Mod が $.process.run を呼び出すためです。実行するプログラムは厳密に 2 つだけです。git status --porcelain=v1 -b と、HEAD が detached のときに限った git rev-parse --short HEAD です。どちらも読み取り専用で、シェルを介さない argv 配列で実行され、10 秒のタイムアウトが設定されています。

ツール呼び出しを傍受 が表示されるのは、Bash の tool.call にフックしているためです。ただし観察するだけで、コマンドを変更したり拒否したりすることはなく、更新はコマンドの完了後に行います。UI を変更 は帯の表示のためのものです。

ファイルの中身を読むこと、ネットワークを使うこと、モデルを呼び出すことはありません。完全にオフにするには /plugin disable cm-git-branch を実行します。1 回のセッションだけすべての Mod をオフにして始めるには claude --safe-mode を使います。

macOS のターミナル上で Claude Code 2.1.291 にてテスト済みです。帯が表示されない場合は、次の順に確認してください。

• claude --version が 2.1.287 以降であること。
• セッションが Git リポジトリ内で開始されていること。同じフォルダーで git status が動作するはずです。
• Mod が有効になっていること。/plugin メニューの Installed タブに表示され、「mod active」の行があるはずです。
• シェルから開いているセッションにインストールした場合は、/reload-plugins を実行すること。
• 入力欄の上でアンケートや別のプロンプトが開いていないこと。それらが表示されている間、帯は場所を譲り、閉じた後に戻ってきます。

非常に大きなリポジトリでは、git status の実行回数を減らすために intervalMs を大きくしてください。