remindb-setup

remindb-setup — セットアップウィザード

あなたがウィザードです。このスキルは、ライブセッション内から remindb ワークスペースをセットアップまたは再設定する際に従うスクリプトです。個別の UI はありません。Bash、Memory* ツール、ファイルへの書き込みを使って進めてください。

常設の指示 — まず --help で CLI フラグを確認する

remindb のサブコマンドを実行する前に、remindb <subcommand> --help（remindb compile --help、remindb inspect --help など）でフラグを確認してください。記憶した構文を信用しないでください。位置引数を誤って指定してもエラーにならず、間違った動作をすることが、このウィザードで最もよくある落とし穴です（例：remindb inspect <path> は無視されます。指定すべきフラグは --db <path> で、デフォルトの memory.db は CWD に空のファイルをひっそりと開きます）。

2 つの要素、2 つのパス — どちらの段階かを判定する

remindb は、個別にインストールする 2 つの要素として提供されています。スキル（これ。npx skills add 経由）と MCP プラグイン（ホストごと）です。スキルは先にインストールされ、プラグインが接続される前に実行できます。これにより、設定を先に行う順序が可能になります。今のセッションでサーバーが接続されているかどうかで、段階を判定します。

• 利用可能なツールセットに Memory* ツールがない → パス 1：初回の設定先行セットアップ（§パス 1）。デフォルトの初回実行です。
• Memory* ツールがある → パス 2：検証／再設定（§パス 2）。

モード

• /remindb-setup — 対話型：各選択肢について、書き込みの前に承認を求めます。
• /remindb-setup automode — すべてのパラメーターを推定し、直接書き込んでから報告します。それでも確認が必要な信頼に関わる操作は、リモートインストーラーの実行（ステップ 1）、プラグインのインストール実行（ステップ 7）、ホストの MCP 設定の書き込み（ステップ 8）です。推定ルール → references/automode-playbook.md。
• /remindb-setup only-config — ブリッジホスト向けのショートカット：パス 1 の ステップ 1～4 のみ（バイナリ → ホスト → ソース → .remindb/）を実行してから、1 行の要約を出して終了します。プロンプト本文から Source root:（必須。ない場合は推測せず、対話型でも automode でも明確なエラーにする）と Also adjacent-seed:（任意。呼び出し元ホストが後でコンパイルするためにキューに登録する、改行区切りの絶対パス）を解析します。automode と組み合わせて使用できます。呼び出し元ホストが独自のパイプラインでコンパイル、プラグインのインストール、環境変数の接続を管理する場合に使用してください。references/host-wiring.md のブリッジホストに関する注記を参照してください。解析ルールは references/automode-playbook.md にあります。

ホストによっては、これを文字どおりの /remindb-setup コマンドとして提供しているとは限りません。references/host-wiring.md の該当ホストの行に従って呼び出してください。呼び出し後は、どのホストでも同じウィザードが実行されます。

パス 1 — 初回の設定優先セットアップ（サーバー未接続）

順序が重要です。コンパイルする前に.remindb/を作成してください。こうすることで、ignore／pinned／temperatures.jsonが挿入時に適用されます。後から反映するための--reseedは不要です。**only-config**を指定すると、このリストは手順1〜4に短縮され、概要を表示して終了します（上記のモードを参照）。

1. バイナリ。（Bashで）remindb --versionを実行します。見つからない場合はインストールしてください。自動モードでも、リモートインストーラーを実行する前に確認を取ってください。ワンライナーとPATHの詳細は、references/config-model.mdの§Bootstrapを参照してください。
2. ホストを特定します。 使用中のエージェントランタイムはすでに分かっているはずです。システムプロンプトと、このセッションで公開されているツール／スキルを確認してください（例：/plugin installならClaude Code、/skillsピッカーならCodex、openclaw mcpならOpenClaw、activate_skillならGemini CLIです。OpenCodeでは通常の言葉でスキルを有効化します）。ホスト固有の設定パスは、ファイルシステムを調べるよりも、まずランタイム固有の情報（システムプロンプト、読み込み済みのホスト固有スキル、ランタイムのドキュメントなど）を参考にしてください。ランタイムの状況が依然として曖昧な場合は、ユーザーに尋ねてください（自動モードでは、最も可能性の高いものを選び、その前提を記録します）。次に、references/host-wiring.mdで該当する行を確認してください。
3. ソースルートを特定します。 コンパイルするディレクトリを確認してください。.remindb/もこのディレクトリに置きます。まだ接続前のため、読み取れるREMINDB_SOURCEはありません。ユーザーと相談して決めてください（自動モードでは、ホストの状態ディレクトリから推測します。例：~/.claude/projects）。
4. .remindb/を作成します。 <source>/.remindb/にignore／pinned／temperatures.json／config.jsonを作成します。各設定の意味と変更の反映方法についてはreferences/config-model.mdを、ワークスペースの種類ごとのコピーして使えるテンプレートについてはreferences/config-examples.mdを参照してください。対話モードでは、まず計画を提示してください。自動モードでは作成後、判断が分かれる選択肢をそれぞれ要約してください。
5. コンパイルします。 remindb compile <source> --db <db>を実行します。挿入時に適用されるため、設定はすでに反映済みです。--reseedは不要です。
6. 隣接コンテキストをシードする（任意）。 ソースルート外のファイル（CLAUDE.md／AGENTS.md／GEMINI.md／README.md）はDBに含まれません。CLIを使って取り込むかどうかを提案してください（まだ接続前なので、ツールのMemoryCompileは利用できません）。ファイルごとに、絶対パスを指定してください：

   remindb compile /abs/path/CLAUDE.md --db <db>
   

7. MCP プラグインをインストール／有効化します。 references/host-wiring.mdのホスト別「Plugin install」列に従ってください（例：Claude Codeなら/plugin install remindb@remindb、Codexならcodex plugin marketplace add radimsem/remindb）。インストールコマンドをBashから実行できる場合は、ウィザードで実行できます。Claude Codeの場合は、ウィザードからユーザーに指示してください（/plugin installはシェルコマンドではありません）。インストールを実行する前に確認を取ってください。読み込まれる設定がインストール後に確定するホスト（Claude Codeのキャッシュ、OpenClawのMCPストアなど）では、手順8より前にプラグインをインストールしておく必要があります。
8. MCP の環境変数を設定します。 プラグインをインストールしたら、読み込まれる設定ファイルにREMINDB_DB／REMINDB_SOURCEを設定します。まずファイルの場所を特定してください。ホストごとの設定ファイルはreferences/host-wiring.mdに記載されています。不明なホストの場合は、grep -rl REMINDB <host-config-dir>で検索してください。記憶に頼らないでください。優先するのはスコープ付き編集です（複数のブレインを安全に扱えるため）。スコープ付き編集が現実的でない場合（不明なホスト、またはClaude Codeマーケットプレイスでユーザーが明示的に希望した場合）に限り、シェルでのexportを代替手段として使用してください。詳しくはhost-wiring.mdの§Env-wiring principleを参照してください。自動モードでも、ホスト設定ファイルに書き込む前に確認を取ってください。その後、ホストを再読み込みしてください。

パス1の最後に、ホストの再読み込み後、REMINDB_DB／REMINDB_SOURCEが解決されてサーバーが接続されることをユーザーに伝えてください。ウィザードを再実行して（パス2）、MemoryStatsのdb_pathがコンパイル済みDBと一致することを確認してください。

パス 2 — 検証／再設定（サーバー接続済み）

• 検証。 MemoryStats() → 報告されたデータベースパスがコンパイルしたものと一致し、ノード数が 0 より大きいことを確認します。次に remindb://doctor を読み、FTS5／古いルートのチェックを確認します（機械的に確認できるパスとして、remindb://overview には db_path フィールドがあります）。コールドノードの通知には、クライアントからのワンショットの SetLoggingLevel（logging/setLevel）が必要です。ほとんどのクライアントは自動的に送信します。送信しない場合もサーバーに問題はありませんが、クライアント側でオプトインする必要があります（詳細 → references/config-model.md）。
• 診断 — db_path の不一致／ノード数が 0。 MemoryStats が、コンパイルした DB ではない db_path を報告する場合、特にノード数が 0 で、文字列 $PWD/${REMINDB_DB} がそのまま表示される場合（Claude Code のパターンです。キャッシュされた ${VAR} の引き継ぎは、変数が未設定のシェル環境で評価されます）、環境変数がサーバーの起動場所で解決されていないことを意味します。環境変数が未設定か、間違った設定ファイルを編集したかのどちらかです。修正方法：実際に読み込まれる設定（ホスト上で該当するファイルは references/host-wiring.md で再確認してください）または起動シェルで REMINDB_DB／REMINDB_SOURCE を設定し、再読み込みします。
• 既存のブレインを再設定。 .remindb/ 内のファイルを再編集し、references/config-model.md の 3 層モデルに従って適用します。ライブ再読み込み（temperature／rescan）→何もしません。挿入時（temperatures.json／pinned）→再シードします（以下を参照）。固定（budgets／server／redaction）→再起動します。
• 既存ノードに再シード（再設定専用）。 後から temperatures.json／pinned を編集しても、すでにコンパイル済みのノードには反映されません。既存の DB に適用するには：

  remindb compile <source> --db <db> --reseed-temperatures --reseed-pinned
  

  警告： --reseed-pinned は一致するものすべてに .remindb/pinned を再適用し、手動で行った MemoryUnpin の設定を上書きします。WAL と busy_timeout(5s) により、serve がファイルを保持していても安全に実行できます。MemoryCompile（ツール）はピンを再シードしないため、CLI を使用します。

完了しましたか？準備ができています：remember（自然言語で操作する入り口）、remind（読み取りツール）、memorize（書き込みツール）。