bm-status

Basic Memory のステータス

このプロジェクトのプラグインの現在の状態を報告し、簡潔にまとめます。 これは簡易診断です。事実を収集して整理し、調査しすぎないでください。

収集

1. CLI に接続できますか？ basic-memory --version、次に bm --version、次に uvx --prerelease=allow basic-memory --version を実行します。どのランチャーも解決できない場合は、CLI のステータスを 利用不可と報告し、MCP／設定の確認を続けてください。プラグインのフックは uv で管理される環境を引き続き使用できます。

2. 設定。 フックの優先順位に従って basicMemory ブロックを読み取ります。 ユーザーレベルのベース設定では、環境変数が存在する場合、CLAUDE_CONFIG_DIR のリテラル値に settings.json を追加します。この値の末尾を削除したり、~ を展開したり、空の値を未設定として扱ったりしてはいけません。 変数が存在しない場合に限り ~/.claude/settings.json を使用します。次に、プロジェクトの .claude/settings.json と .claude/settings.local.json がキーごとに上書きします。結果を報告し、 値がユーザーレベルのブロックとプロジェクトのどちらに由来するかを明記します。

   • basicMemory ブロックから：primaryProject（固定されていない場合はその旨を記し、デフォルトのプロジェクトが使われることを示す）、secondaryProjects（チーム／共有の読み取り元）、teamProjects（/basic-memory:bm-share の共有先）、captureFolder（デフォルトは sessions）、rememberFolder（デフォルトは bm-remember）、preCompactCapture モード（デフォルトは extractive）、sessionProfile（デフォルトは general）、repository（コーディングプロファイルのみ）、captureEvents（デフォルトは true）。
   • basicMemory ではなく、ルート設定オブジェクトから：outputStyle が basic-memory かどうか、つまりキャプチャの反射動作が有効かどうか。

3. コアフックの状態。 最初に利用できるランチャーで、 basic-memory hook status --harness claude --project-dir <project-root> を実行します。 共有インボックスのパス、保留中のエンベロープ数、アーカイブ済みのエンベロープ数、保留中のチェックポイント要求数、最後の flush、設定の状態、解決されたプライマリプロジェクト、キャプチャの状態、キャプチャフォルダー、Basic Memory のバージョン、uv のバージョンを報告します。インボックスの件数は、サポート対象のハーネス全体で共通です。滞留を Claude のみに起因するものとして扱ってはいけません。このコマンドによる設定の解決結果をフックの動作に関する正式な値として扱います。手動で統合した設定と異なる場合は、その不一致を示してください。ランチャーを解決できない場合は、これらの項目を利用不可とし、続行してください。

4. 最近のチェックポイント。 metadata_filters={"type": "session"}、page_size 5 を指定して search_notes を実行します。primaryProject が設定されている場合は、そのプロジェクトに範囲を限定します。sessionProfile が coding の場合は、metadata_filters={"type": "coding_session", "repository": "<configured repository>"} でもクエリを実行し、結果を統合して重複を除き、新しい順に並べ替え、最新の5件を残します。タイトルとパーマリンクを一覧表示します。

5. アクティブなタスク。 metadata_filters={"type": "task", "status": "active"} を指定して search_notes を実行し、件数のみ報告します。

これらのクエリを primaryProject に範囲限定する場合は、project として渡すか、external_id の UUID であれば project_id として渡します（project に UUID をそのまま渡してもルーティングされません）。

表示

次の形式にまとめます（実際の値を入れ、特定できなかった項目はレポート全体を中止せず、「—」または短い注記を記載します）。

## Basic Memory status

- CLI:               basic-memory <version>
- Project:           <primaryProject, or "default project (not pinned)">
- Reads from (team): <secondaryProjects joined, or "none">
- Share targets:     <teamProjects keys joined, or "none">
- Capture folder:    <captureFolder>
- Remember folder:   <rememberFolder>
- Output style:      <enabled | not enabled>
- PreCompact:        <mode>
- Session profile:   <general | coding>
- Repository:        <owner/name or none>
- Event capture:     <enabled | disabled>
- Shared hook inbox: <path or unavailable>
- Shared pending envelopes: <count or unavailable>
- Shared archived envelopes: <count or unavailable>
- Pending checkpoint requests: <count or unavailable>
- Last flush:        <timestamp, never, or unavailable>
- Hook runtime:      basic-memory <version>; uv <version or missing>
- Recent checkpoints: <n across session and coding_session>
    - <title> — <permalink>
    ...
- Active tasks:      <n>

チェックポイントがまだない場合は「まだありません」と記載し、コンテキスト圧縮の前にチェックポイントが自動的に書き込まれること（書き込むには primaryProject の設定が必要であることも）をユーザーに伝えてください。

イベントキャプチャが有効で、保留中のエンベロープが蓄積している場合、または最後の flush が never の場合は警告します。別のハーネスが共有件数に含まれている可能性があることも明記してください。キャプチャが無効の場合は、インボックスが空であることについて警告しないでください。