Where Am I：プロンプト上に Claude Code セッション要約を表示

Where Am I は、Hamza Zafar（hamzafer）による claude-code-mods コレクションの一つで、Claude Code セッション要約をプロンプトの上に表示するコミュニティ Mod です。長い回答のあとや、席を離れて戻ったときに、顔を上げるだけで今どこにいるのかが分かります。バンドには、セッションの目標、今起きていること、Claude があなたに待っていること、次の一手が表示されます。作者は流れを見失いやすい人のために作っており、背後のシステムプロンプトは平易な言葉を使うよう求めています。

バンドは最大 3 行です。◆ Goal: は全体の目標で、はっきり変わらない限り前の目標を保つようモデルに指示されています。now: の行は Claude の作業をリアルタイムで追い、reading src/index.js のようなラベルになり、next: は同じ行に並びます。黄色の waiting on you: の行は、Claude があなたに何かを求めているときだけ現れます。各フィールドは 1 文、最大 70 文字に切り詰められます。

要約は、各ターンの終了後に小さなモデル呼び出しで書かれます。/where は求めに応じて長めの要約を作ります。会話の直近 12 件のメッセージから、最大 6 項目の箇条書きです。複数のバンド系 Mod を使っている場合、Where Am I は共有のバンド順ファイルを使ってそれらと並び順を調整し、作者のテストがこの動作をカバーしています。

録画では、小さなデモプロジェクトでこの Mod を読み込んだ Claude Code を起動し、README.md を読んでプロジェクトを一文で説明するよう Claude に頼みます。Claude が作業している間、プロンプトの上のバンドはまだ空です。ターンが終わると Claude の回答と done の行が現れ、数秒後に要約がプロンプトの上に表示されます。デモアプリを理解するという内容の Goal: の行、README を読んだことを示す now: の行、そして next: の行です。そのあと Ctrl+C でクリップが終わります。

インストール欄のどの方法でも使えます。いずれも作者自身のマーケットプレイスから直接インストールします。バンドは最初のターンが終わると現れ、/where はセッション開始時に登録されます。

要約はホストが保持する $.state のアトムに入るので、ホットリロードしても残ります。要約を書くモデル呼び出しは turn.complete から実行され、待機されないため、ターンはすぐに終わります。hooks/register.tsx より：

on('turn.complete', async ($, e, next) => {
  const r = await next(e)
  if (!e.agentId) {
    await update($, live, () => '')
    void summarize($, prompt, log, e.answer).catch(() => {}) // in the background, so the turn ends at once
  }
  return r
})

summarize は haiku モデルで $.model.complete を呼びます。送るのは、前回の要約、あなたの最新メッセージ（先頭 1500 文字）、このターンのツール呼び出しのラベル、Claude の回答の先頭 2500 文字で、goal、now、waiting、next を持つ JSON を求めます。parseRecap は JSON を囲むコードフェンスを許容し、フィールドを整え、長いダッシュを置き換えます。tool.call フックは now のラベルを書き込み、次の要約のために直近 20 件のラベルを保持します。観察するだけで、呼び出しはそのまま返します。サブエージェントのターンはスキップされ、ほかの Mod による呼び出しは next.origin を確認して無視されます。バンドは AbovePrompt の描画位置に描かれ、アンケートが開いている間は消えます。

/config にオプションはなく、コマンドは /where だけです。見た目や動作を変えるには register.tsx を編集します。MODEL は要約に使うモデル、MAX_LOG は保持するツール呼び出しラベルの数、clip は 70 文字の上限を決め、summarize と longRecap の 2 つのシステムプロンプトが口調を決めます。ほかのバンド系 Mod の中での並び順は、設定フォルダーの bands.json からセッションごとに一度だけ読まれるため、変更を反映するには Claude Code を再起動してください。

何かを実行する前に、プラグインが実行できるすべてのファイルを読みました。hooks/hooks.json、hooks/register.tsx、hooks/bands.ts、型宣言、テストです。package.json、インストールスクリプト、バイナリ、バンドルされたコードはなく、隠し文字、eval、動的 import も見つかりませんでした。MIT ライセンスはリポジトリのルートにあります。

• モデル呼び出し。 $.model.complete は、メインエージェントの各ターンのあとと /where で実行されます。あなたのプロンプト、ツールのラベル、Claude の回答（/where では直近 12 件のメッセージ）を Claude Code 経由で haiku モデルに送るため、プランまたは API の使用量を消費します。Mod 自身にネットワークのコードはなく、ほかのホストへは何も送られません。
• 環境変数とファイル。 CLAUDE_CONFIG_DIR と HOME を読み、存在すれば 1 つのファイル <config dir>/claude-code-mods/bands.json を読んでバンドの順序を得ます。ファイルは書き込まず、要約は $.state にあります。
• フック。 prompt.submit と tool.call は観察するだけで、すべてをそのまま通します。validate は、どちらにも .catch がないと注記しています。Mod は何もブロックも書き換えもしません。/where を追加し、プロンプトの上の UI を変更します。
• 存在しないもの。 プロセス、シェルコマンド、デーモン、テレメトリ、シークレット、設定の変更はなく、2 つの要約プロンプト以外にモデルへの指示もありません。

claude plugin validate はエラーも警告も報告せず、作者の 7 件のテストは Claude Code 2.1.303 の claude plugin test で全件合格しました。

macOS 上の Claude Code 2.1.303 で確認しました（validate、テスト、録画）。バンドが表示されないときは：

• まず 1 ターンを完了させてください。要約はその後に書かれ、モデル呼び出しが失敗したり解析できない返答だったりすると、バンドは空のままです。
• 入力欄の上でアンケートが開いている間は非表示で、閉じると戻ります。
• /where が不明なコマンドになる場合、Claude Code に同名のコマンドがすでにあり、Mod はそのコマンドなしで起動します。
• /where が「Could not build a recap right now」と返す場合は、モデル呼び出しに応答がありませんでした。もう一度試してください。

バンドは next-steps の状態を読むため、その Mod が一覧を表示している間は、自分の next の部分を隠します。