| name | localgpt-memory |
| description | LocalGPT 設計ログ／メモリを Pi から操作。cross-session 設定・ワールド構築意図・長期アシスタントコンテキストの記録と検索。ユーザーが「前に言った設定」「前回のデザイン判断」「ワールド構築の意図」に言及した時に活用。 |
LocalGPT Memory
pi-localgpt の LocalGPT メモリ（設計ログ）ツール群は、cross-session で持続する設計意図・設定・コンテキストを記録・検索するためのインターフェース。
全メモリ操作は localgpt-gen mcp-server --connect の 1-shot CLI 経由（常駐プロセスなし）。詳細は skills/localgpt-gen/SKILL.md を参照。
Python RAG 版「LocalGPT」（langchain ベースのローカル RAG）とは無関係。 本パッケージは localgpt.app の LocalGPT Gen（Bevy エンジン 3D ワールド構築ツール）のメモリ機能を操作する。
いつ使うか
| 状況 | 使うもの |
|---|
| 前回のセッションで決めた設計方針・テーマを思い出したい | localgpt_design_log_search または localgpt_memory_search |
| 過去のワールド構築で試した設定・好みを確認したい | localgpt_design_log_search または localgpt_memory_search |
| 検索結果の内容をもっと詳しく読みたい | localgpt_memory_get |
| 長期間保持すべき設計判断・好みを保存したい | localgpt_design_log_save |
| 今日の作業ログに簡単なメモを追記したい | localgpt_design_log_log |
| ワールド構築の設計意図（plan/evaluate/export への参照付き）を保存したい | localgpt_remember_worldgen |
| vault qmd 内のプロジェクトメモ・設計ドキュメントを参照したい | vault qmd（本 skill の対象外） |
| gen / vault との双方向同期が必要な高度なユースケース | 将来検討 — 詳細は backlog-deferred 参照 |
LocalGPT memory vs vault qmd の使い分け
| 側面 | LocalGPT memory（設計ログ） | vault qmd（プロジェクトメモ） |
|---|
| 用途 | cross-session 設計意図・設定プレファレンス・簡易メモ | 設計ドキュメント・PRD・仕様・長期的ナレッジ |
| 更新頻度 | 高（毎セッション） | 低（設計完了時・レビュー時） |
| 検索方法 | localgpt_memory_search（semantic + keyword） | vault 検索 / 手動参照 |
| 検索範囲 | LocalGPT workspace 内の DESIGN-LOG.md + daily logs | vault 全体の .qmd / .md |
| Pi からの操作 | 全ツール・コマンドから直接アクセス可能 | 外部（本 skill の対象外） |
| 双方向 sync | なし（将来検討） | なし（将来検討） |
前提
localgpt-gen がインストール済み（cargo install localgpt-gen）- localgpt-gen がインタラクティブモードで起動中（Bevy 窓あり）—
--connect リレーがこれに接続する
- LocalGPT workspace が設定済み（
localgpt config init または LOCALGPT_WORKSPACE 環境変数）
- 初回利用前に
localgpt_status で workspace 準備状態を確認推奨
ツール一覧（MVP）
Status（到達性確認）
| 状況 | Tool |
|---|
| LocalGPT workspace（DESIGN-LOG.md / daily log）の準備状態確認 | localgpt_status |
| localgpt-gen binary + relay 到達性確認 | localgpt_gen_status |
Search & Read（検索・読み取り）
| 状況 | Tool |
|---|
| 設計ログを semantic + keyword 検索 | localgpt_design_log_search（推奨）または localgpt_memory_search |
| 検索結果の行範囲を path + startLine/endLine で読む | localgpt_memory_get |
| 検索結果の ID でエントリ詳細を読む | localgpt_design_log_get |
Write（書き込み）
| 状況 | Tool |
|---|
| 長期設計ログ（cross-session 設定・好み）を保存 | localgpt_design_log_save（推奨）または localgpt_memory_save |
| 日次ログ（タイムスタンプ付きメモ）に追記 | localgpt_design_log_log（推奨）または localgpt_memory_log |
| ワールド構築の設計意図（plan/evaluate/export/world 参照付き）を保存 | localgpt_remember_worldgen |
レガシーエイリアス
| 現行名 | エイリアス | 状態 |
|---|
localgpt_design_log_save | localgpt_memory_save | 後方互換あり（将来削除予定） |
localgpt_design_log_log | localgpt_memory_log | 後方互換あり（将来削除予定） |
localgpt_design_log_search | localgpt_memory_search | 後方互換あり |
localgpt_memory_search と localgpt_memory_get は独自のファイルシステム フォールバック実装を持ち、binary なしでも keyword 検索・行範囲読み取りが可能な独立ツールとして設計されている。
コマンド一覧（MVP）
| コマンド | 動作 |
|---|
/localgpt:status | LocalGPT workspace 準備状態を確認（binary spawn 不要） |
/localgpt:gen-status | localgpt-gen binary + relay 到達性を確認 |
/localgpt:search | 対話的プロンプトで memory 検索（localgpt_memory_search を呼ぶ） |
/localgpt:get | パス + 行範囲を指定してメモリ読み取り（localgpt_memory_get を呼ぶ） |
/localgpt:remember | 対話的プロンプトで DESIGN-LOG.md に追記（localgpt_design_log_save を呼ぶ） |
/localgpt:remember-worldgen | ワールド構築 rationale を保存（localgpt_remember_worldgen を呼ぶ） |
推奨フロー
# 1. 到達性確認（初回）
localgpt_status → workspace 準備状態の確認
localgpt_gen_status → binary + relay の確認（必要な場合）
# 2. セッション開始時に過去の設定・判断を確認
localgpt_design_log_search(query="前回のテーマ配色や照明設定")
↓ スニペット不足なら
localgpt_memory_get(path="DESIGN-LOG.md", startLine=10, endLine=30)
↓ entry ID があれば
localgpt_design_log_get(id="...")
# 3. 設計判断・好みを長期保存
localgpt_design_log_save(content="Level 2 のテーマは abandoned factory。照明は warm tint、曇り空。")
↓ 日次メモも併用
localgpt_design_log_log(content="今日は harbor chokepoint の blockout を試行。lighthouse を唯一の安全ルートに。")
# 4. ワールド構築後の設計意図保存（worldgen 連携）
localgpt_remember_worldgen(
rationale="Harbor chokepoint: warehouse_row は intentionally low cover",
references={plan: ..., evaluate: ..., export: ...}
)
# 5. 次回セッション
localgpt_design_log_search(query="abandoned factory warm tint")
制約
- メモリは 1-shot MCP bridge 経由 — 各 tool call で
localgpt-gen mcp-server --connect が spawn される。localgpt-gen の Bevy 窓が起動していないと全ツールが失敗
localgpt_status は binary spawn 不要 — 設定ファイルと workspace ファイルを直接読み取る keyword モード- Python RAG LocalGPT とは無関係 — 詳細は README 参照
- vault qmd との双方向 sync は未実装 — 高度な vault 連携は backlog-deferred で将来検討
参考リンク
