fimemory

FIMemory

接続して指示すれば、AI ツールが読み取れるローカルストアです。

FIMemory（Future Industries による FI Memory）は、メモをお使いのコンピューター上に保存し、AI ツールをそこに接続することで、セッションごとに同じプロジェクトについて説明し直す手間をなくします。ストアはご自身のファイルを集めた通常のフォルダーです。独自形式もサーバーもアカウントもなく、どこにもアップロードされません。新しいストアは、デフォルトで保存時に暗号化されます。パスフレーズを設定すると、24 語のリカバリーフレーズが一度だけ表示されます。ファイルは、Git ホスト、クラウドバックアップ、USB メモリなど、どこに保存してもプライベートなままです。テキストエディターで直接開けるファイルがよい場合は、セットアップ時に明示的に選択すればプレーンテキストにできます。暗号化されたストアも、キーさえあればいつでも読み取り可能な Markdown にエクスポートできます。

まずはこちら

コマンドは 2 つです。

npm i -g fimemory
fimemory setup

最初のコマンドが EACCES: permission denied で失敗した場合（npm のデフォルトのグローバルフォルダーが root の所有になっている macOS でよく起こります）は、自分が所有するフォルダーを npm に指定して、もう一度実行してください。sudo は必要ありません。

npm config set prefix ~/.npm-global
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
npm i -g fimemory

すでに起動していた AI ツールは、設定を起動時に読み込むため、いったん終了して再起動してください。

インストールはこれで完了です。setup はストアがなければ作成し、このマシンで見つかったすべての AI ツールを接続してから、処理内容を確認し、反映された設定と反映されなかった設定を表示します。もう一度実行しても安全で、余計な処理は行われません。設定済みの項目はすべて unchanged と表示され、書き換えもありません。うまくいったか分からない場合は、もう一度実行してください。

ターミナルでストアを作成すると、setup が暗号化の手順を案内します。パスフレーズを選ぶか、キーを押して --plaintext で暗号化を無効にすると、24 語のリカバリーフレーズが一度だけ表示され、書き留めたことを確認するよう求められます。その後、このマシンでは約 8 時間、ストアのロックが解除された状態になります。スクリプトや CI では確認プロンプトは表示されません。--passphrase "..." を渡すか、GESTALT_PASSPHRASE を設定するか、--plaintext を指定してください。いずれも指定されていない場合、推測で処理を進めるのではなく、適切にエラーを返します。パスフレーズと 24 語のフレーズの両方を失うと、設計どおりデータは失われます。「サーバーではなく、自分のキーで管理する」ことにはそうした代償が伴います。ガイドに沿って実行すれば、気付かないうちにそうなることはありません。

setup が代わりに完了できない手順が 1 つあります。独自の設定ファイルを管理する Claude Code です。このマシンに claude コマンドがあるかどうかを setup が確認します。ある場合は、貼り付け用の claude mcp add コマンドを 1 行表示します。ない場合（VSCode 拡張機能とデスクトップアプリはコマンドラインをインストールしません）は、代わりに正確な JSON ブロックと、それを書き込むファイルを表示します。いずれの場合も、ほかの表示に流されないよう、「次の手順」の下に表示されます。

手順が失敗しても、処理は続行され、失敗した項目には専用の行が表示されます。その行の問題を解決して fimemory setup をもう一度実行すれば、すでに完了した手順はそのまま維持されます。

あとで使うことになるコマンドは 3 つです。

• fimemory onboard は、セットアップ後のガイド付き初期手順です。最初に提案された編集を承認する方法を案内し、作業の進め方について 3 つの質問をして回答をストアに書き込み、自分についての情報を使った検索結果を表示します。接続済みのストアに自分の情報が何もないと、問題がなくても壊れているように感じます。この手順が、その状態を手早く解消します。
• fimemory doctor はセットアップ全体を読み取り、不足しているものと対処方法を分かりやすい言葉で伝えます。インストールの一部が未完了であることが、最もよくある問題の原因です。
• fimemory setup --plaintext は、暗号化されていないストアを使って同じインストールを行います。すべてのファイルはテキストエディターで読み取ることができ、あなたはもちろん、フォルダーにアクセスできる人やプログラムも読み取れます。これは明示された実際の選択肢であり、隠れたダウングレードではありません。プレーンテキストで作成したストアも、あとから fimemory encrypt で暗号化できます（実際のデータが増える前に行うのが最も簡単です）。

これまでは、正常に動作しているインストールと動作していないインストールを見分けられませんでした。これからは、インストール時にどちらなのかが分かります。

誠実な期待値

• Windows、macOS、Linuxで、実際にインストールして使用しています。 ランナーでの実行実績を主張しているのではありません。実機に手動でインストールし、その後実際の作業で使用しています。2種類のAIツールが1つのストアを読み書きしながら、数か月にわたって毎日使っています。WindowsマシンとMacでは、それぞれClaude CodeとGrokをストアに接続して使い、Linuxマシンではヘッドレスで実行しています。さらにCIでは、プッシュのたびにLinuxとmacOSのランナーでパッケージをビルド、型チェック、テストし、グローバルインストールします。それでも網羅できていないのが、ホストアプリの幅広い互換性です。ランナーにはデスクトップセッションがないため、以下に記載したもの以外のクライアントについては、設定ファイルにsetupが書き込んだ内容が実際に読み込まれるかを確認できていません。Linuxではクリップボードコマンドにxclip、またはWaylandではwl-clipboardが必要ですが、どちらも標準ではインストールされません。問題があるようならfimemory doctorを実行し、ぜひご報告ください。
• 記憶しない場合より安くなるわけではありません。 少額の割増料金を払うだけの価値はありますし、すべてを貼り付けるよりはずっと安価です。
• 接続して指示すれば、エージェントはストアを読み込みます。 setupはMCP設定、ルールテキスト、検索フックを書き込みますが、どの記憶製品も、ホストが毎回、指示なしにストアを参照するよう強制することはできません。
• 自動同期機能はまだ提供していません。 複数マシンでの利用には、ご自身のアカウントで、ご自身のgitリモートを使います。同期サービスはまだないため、ご自身でリモートを設定しない限り、書き込んだ内容がマシンの外に送られることはありません。
• 提供する機能の対象は、複数のエージェントを使うご自身のマシンです。 2台のマシンを1つのプライベートgitリモートに接続します。2台目のマシンでfimemory join <url>を実行し、セッションの前後にfimemory pullを実行してください。同じノートへの編集が暗黙にマージされることはありません。競合した側は保留中の提案となり、ご自身で確認できます。ご自身のリモートを超えるチーム機能は含まれていません。

setupが実際に実行する内容

次の5つのステップを、この順序で実行します。

1. ストアが~/.fimemoryに存在しない場合に限り、initを実行します（以前のインストールで作成された~/.gestaltがあれば検出して保持します）。すでにストアがある場合はスキップし、上書きしません。
2. install-mcpを実行し、検出した各ホスト設定ファイルにMCPサーバーのエントリーを書き込みます。これにより、アシスタントがストアを読み込めるようになります。
3. install-hooksを実行し、Claude Codeの検索フックを~/.claude/settings.jsonに書き込みます。~/.claudeが存在しない場合はスキップします。
4. install-rulesを実行し、各ホストのルールファイルにメモリールールのブロックを書き込みます。これにより、アシスタントが実際にストアを使うようになります。
5. doctorを実行し、すべての設定を読み戻して結果を報告します。

フックをルールより先に実行するのは意図的です。shimルールのテキストは、関連するノートが検索フックによってすでに現在のターンに挿入されている可能性があると、モデルに伝えます。この説明が正しいのはフックがインストールされた後だけなので、先にフックを実行し、その結果に応じて文言を選びます。フックがインストールされた場合はClaude Codeにshimの文言を使い、フックがスキップされた場合は、無条件に正しい検索優先の文言をすべてのホストに使います。フックなしでshimの文言を書き込むと、モデルは検索をやめる一方で、実際には届かない挿入を期待することになり、何もしないよりも悪い結果になります。

各ステップは個別にラップされているため、失敗してもそのステップの行に結果が記録され、処理は続行されます。ルールファイルに書き込めなくてもMCPの登録を失敗させてはなりません。また、そのどちらかの失敗によって、どの処理が成功したかを示すdoctorの判定結果が得られなくなってもいけません。setupはロックされた暗号化ストアでも実行されます。2台目のマシンではこれが通常の状態であり、doctorがロック状態を報告します。

個々のコマンドも引き続き利用でき、単独で実行できます。 init、install-mcp、install-hooks、install-rules、doctor。

各ツールの設定先

ツール	MCP 設定	ルールブロック	検索フック
Claude Code	出力されるコマンド。ファイルへの書き込みはありません	~/.claude/CLAUDE.md	はい、~/.claude/settings.json
Codex CLI	~/.codex/config.toml	~/.codex/AGENTS.md	いいえ、下記を参照
Gemini CLI	~/.gemini/settings.json	~/.gemini/GEMINI.md	いいえ、下記を参照
Grok CLI	~/.grok/config.toml	~/.grok/AGENTS.md	いいえ、下記を参照
Windsurf	~/.codeium/windsurf/mcp_config.json *	~/.codeium/windsurf/memories/global_rules.md *	いいえ、下記を参照
Cursor	~/.cursor/mcp.json *	書き込みなし。下記を参照	いいえ、下記を参照
Claude Desktop	claude_desktop_config.json *	書き込みなし。下記を参照	いいえ、下記を参照

* ベンダーのドキュメントに記載されていますが、ディスク上では未検証です。 確認したどのマシンにも Windsurf、Cursor、Claude Desktop はインストールされていないため、これらのパスが存在することを確認できていません。setup で installed と表示された後にストアが認識されない場合、まずここを疑ってください。アプリ独自の設定でルールの実際の保存先を確認し、fimemory install-rules --file <path> を再実行してください。 表内のその他のパスは、すべてディスク上で確認済みです。

• Claude Code は、install-mcp が設定を書き込まない唯一のホストです。Claude Code CLI が ~/.claude.json のスキーマを管理しているため、代わりに claude mcp add fimemory -s user -- ... を出力します。ルールブロックとフックは自動で書き込まれます。
• Cursor：Cursor のルールファイルは書き込みません。Cursor がユーザーレベルのルールをどこに保存するのか、また ~/.cursor/rules を読み込むのかどうかは未検証です。確認したどのマシンにも Cursor はインストールされておらず、このディスクにも Cursor のドキュメントはありません。このページの以前のバージョンでは、これらの制約を事実として記載していました。しかし、それらは情報源から確認したものではなく、下記の ~/.grok/GROK.md と同じ誤りだったため、削除しました。第三者の情報は逆の可能性を示しています。Grok 独自の 12-project-rules.md には、スキャン対象のルールディレクトリとして ~/.cursor/rules/ が記載されています。Cursor が読み込むファイルがわかっている場合は、install-rules --file <path> で同じブロックを書き込めます。
• Claude Desktop：Claude Desktop のルールファイルは書き込みません。ディスク上にルールファイルが存在するかどうかも未検証です。確認したどのマシンにもインストールされていません。MCP 設定は書き込まれます。
• Gemini CLI では、~/.gemini/settings.json の contextFileName でコンテキストファイルの名前を変更できます。install-rules はこの設定を読み取って反映するため、ブロックは Gemini が実際に読み込むファイルに配置されます。
• その他すべてのツール（これまで存在を知らなかったホストを含む）：install-mcp は、クライアント独自の設定に貼り付ける汎用的な JSON スニペットを出力します。

担当者が Claude Code と Grok で、Windows 11 と macOS においてエンドツーエンドで動作確認済みです。 これらは実際にインストールして、共有ストアに対して日々の作業で使用した組み合わせです。表内のその他のホストについては、設定とルールを書き込みます。ホストごとの正確な対応状況一覧は、事前ではなく、測定できた時点で公開します。

ホストが通常と異なる場所にある場合：CODEX_HOME、GEMINI_CLI_HOME、GROK_HOME が設定されていると、install-rules、install-mcp、doctor はすべてそれらに従うため、3 つのコマンドすべてでホストの場所が一致します。Claude Desktop の設定パスはプラットフォームによって異なります（Windows では APPDATA にも依存します）。Cursor と Windsurf の残りのパスは固定です。

フックの詳細

install-hooks が書き込むファイルは 1 つだけです。Claude Code の ~/.claude/settings.json です。これはこのソフトウェアについての説明です。他のツールにフックがないという主張ではありません。また、そう主張していたこの文のバージョンは 2026-07-31 に確認され、誤りでした。 Grok CLIは、2026-07-31にディスク上のgrok 0.2.117で実機検証しました。Grokはデフォルトで~/.claude/settings.jsonのフックをスキャンします（[compat.claude] hooks = true。~/.grok/docs/user-guide/05-configuration.mdに記載されており、10-hooks.mdのHook Locations表では、このファイルがグローバルな常時信頼されるソースとして挙げられています）。2つのハンドラーは読み込まれますが、独立した2つの理由により、注入を行えません。

1. Grokはフックの標準出力を破棄します。 回避策がないため、これが重要な問題です。4つの出力形式（ClaudeのhookSpecificOutput、トップレベルのadditionalContext、プレーンテキスト、systemMessage）を測定しました。それぞれ、書き込んだマーカーファイルによって実際に実行されたことを確認しましたが、注入されたコンテキストは一切生成されませんでした。一方、陽性対照では、ハーネスが注入されたコンテキストを表示できることを確認しています。測定はヘッドレスの-pモードで行い、対話型TUIでは測定していません。Grokの公式ドキュメントだけでは結論が出ません。10-hooks.mdでは、判断を行えるのはPreToolUseと停止イベントのみで、「その他のすべてのイベントは受動的」と説明されています。また、Passive Hooksの節では、標準出力が無視されるイベントの例としてSessionStartやPostToolUseを挙げていますが、UserPromptSubmitは挙げていません。そのため、ここではドキュメントではなく実験結果を根拠としています。
2. ハンドラー形式にargsフィールドがありません。 10-hooks.mdのKey Fields表には、type、command、url、timeout、envが列挙されており、こちらの呼び出し全体はargsに入っています。Grokはインタープリターを引数なしで起動するため、そのプロセスはただちに終了します。commandではインラインのシェルコマンドを指定できるので、こちらは修正できそうですが、修正してもフックが実行されるようになるだけです。（1）のため、依然として何も注入されません。

どちらの場合も処理はブロックされません。Grokはフェイルオープンです。ただし、「フェイルオープン」は「何も表示されない」という意味ではありません。10-hooks.mdによると、フックの失敗はすべてUIのスクロールバックに記録されるため、Grokでプロンプトを送るたびにフック失敗の行が表示されます。表示をなくすには、~/.grok/config.tomlで[compat.claude] hooks = falseに設定してください。~/.claude/settings.jsonからハンドラーを削除しないでください。これはClaude Codeが実際に使用するファイルであり、そこから削除すると、フックが機能する唯一のホストで無効になってしまいます。

Grokは~/.claude/CLAUDE.mdも読み込みます。 ルールファイルが、そのディレクトリを持つホストだけに限定されるわけではありません。Grokの12-project-rules.mdには、Claude互換機能が有効な場合（デフォルト）、ホームディレクトリ直下の~/.claude/もスキャンし、CLAUDE.mdなどを探すと記載されています。また、実機でgrok inspect --jsonを実行したところ、まさにそのファイルが一覧に表示されました。そのため、Claude CodeとGrokを併用する環境では、「Claude Code向け」として書かれたシムの文言がGrokにも届いていました。現在は届きません。フックを実行できないホストが検出され、ルールファイルを共有している場合、そのファイルには検索優先の文言が設定されます。名目上どのホストが所有しているかは関係ありません。fimemory doctorでは、ブロックの有無だけでなく、各ルールファイルにどちらの本文が含まれているかも報告されます。

Codex CLIにはフックがあります。出荷済みバイナリの@openai/codex 0.145.0を2026-08-01に読み取り、確認しました。イベントセットにはuser_prompt_submit、session_start、pre_tool_use、stopが含まれ、バイナリにはhooks/src/events/のソースパスとhooks/hooks.jsonローダーがあります。こちらではCodex用のフック設定を書き込んでいないため、フックはそこで実行されません。ハンドラーのスキーマや、user_prompt_submitフックの標準出力が注入されるかを含め、Codexでこちらのハンドラーが機能するかどうかは未検証であり、どちらとも主張しません。 Gemini CLI にはフックがあり、私たちが書き込むまさにそのファイルをインポートする、公式のインポート機能も備わっています。@google/gemini-cli 0.52.0（2026-08-01）を確認してください。UserPromptSubmit は Gemini の BeforeAgent イベントに対応し、gemini hooks migrate は <cwd>/.claude/settings.json を読み込んで、そのフックをインポートします。このコマンドを使う場合の注意点が1つあります。インポーターがコピーするのは command、type、timeout だけで、Grok と同じように args は引き継がれません。ハンドラーを含む .claude/settings.json が置かれたディレクトリで実行すると、すべてのプロンプトで失敗する Node プロセスが生成されます。Gemini のフック設定は書き込まないため、これはご自身で移行を実行した場合にのみ発生します。

Windsurf と Claude Desktop：フックをサポートしているかどうかは未検証です。私たちが確認したどのマシンにもインストールされていません。どちらについてもフック設定は書き込まず、それ以上の制限があるとは主張しません。

Cursor：Grok のドキュメントには Cursor のフックファイル（~/.cursor/hooks.json）が記載されています。私たちはこのファイルを書き込まず、ハンドラーの動作確認もしていません。

fimemory install-rules --list-hosts を実行すると、お使いのマシンについて、検出されたホスト、各ホストのルールファイルの場所、フックに関するホストごとの理由とその情報源がすべて表示されます。

重要なのはルールブロックです

install-mcp を使うと、アシスタントがストアを読み取れるようになります。 install-rules --mode shim を使うと、プロンプトより前に関連するメモが挿入されるため、頼まれなくてもストアを読み取るようになります。私たちの測定では、アシスタントにツール呼び出しでストアを検索させる場合と比べて、そのコストはごくわずかです。これがなければ、ツールは利用可能でも、ほとんど使われません。

shim の文言が書き込まれるのは、検索フックが実際に実行されるホストだけが専用で読み込むファイルです。現時点では、Grok CLI がインストールされていないマシン上の Claude Code がこれに該当します。それ以外のファイルには、検索を優先するブロックが書き込まれます。この文言は、それらのアシスタントに fimemory_search を自分で呼び出すよう指示するものです。アシスタント向けには何も挿入されないためです。Grok CLI をインストールすると、Grok もそのファイルを読み込むため、次回の setup で ~/.claude/CLAUDE.md の文言は検索優先に戻ります。

問題があるように見える場合

fimemory doctor は、ストアのモード、キーの取得元、各ホストの設定における MCP 登録、ルールブロック、検索フック、カタログインデックス、ストアが最後に読み取られた時刻を確認します。不足しているものと、その対処方法を示し、実際に問題がある場合はゼロ以外の終了コードを返します。インデックスがない、またはディスク上にあるメモがインデックスに記載されていないストアは、警告ではなく失敗です。検索はインデックスを読み取るため、インデックスが空だとアシスタントは何も見つけられず、そのことにも気付きません。

保存時の暗号化（デフォルト）

新しいストアは、Argon2id のパスフレーズを使った XChaCha20-Poly1305 で暗号化され、作成時に24単語のリカバリーフレーズが一度だけ表示されます（fimemory encrypt を実行すると、以前のストアや --plaintext のストアも同じ状態になります）。パスフレーズとリカバリーフレーズの両方を失うと、設計上、データは失われます。アカウントもリセット手段もありません。だからこそ、このフレーズが重要です。

ツールは GESTALT_PASSPHRASE を使ってストアを開きます。お使いのシェルに合った方法で設定してください。

$env:GESTALT_PASSPHRASE = 'your passphrase here'          # PowerShell
set "GESTALT_PASSPHRASE=your passphrase here"             # cmd.exe
GESTALT_PASSPHRASE='your passphrase here' fimemory list   # macOS, Linux

一度ロックを解除すると、約8時間はコマンドをすばやく実行できます（sessionKeyCacheTtlHours。0にすると無効になります）。fimemory lock を実行すれば、それより早くロックできます。

2日目以降に知っておいてほしいことです。予期しないことが起きないように説明します。この時間が過ぎ、環境変数にパスフレーズが設定されていない場合、CLI コマンドは再入力を求めます。MCP ツールは呼び出しのたびに、「ストアがロックされています」という明確なエラーを返し、解決方法を示します（ツールの実行環境で GESTALT_PASSPHRASE を設定するか、任意のターミナルで fimemory unlock を実行します。実行中のサーバーは再起動せず、次回の呼び出し時にロック解除を認識します）。プロンプトごとの取得フックは、プロンプトを止めずに何も出力しません。この状態を明示するのは fimemory doctor です。GUI アプリ（Claude Desktop など）はシェルのプロファイルではなく、OS のユーザー環境変数を読み込みます。そのため、デスクトップセッションから参照できる場所に変数を設定してください。

境界についても率直に説明します。ストアのロックを解除すると、接続された MCP クライアントはファイルシステムツールと同等の読み取りアクセス権を持ちます。これはすべてのメモリ MCP に当てはまることです。私たちは明確にお伝えします。

アンインストール

レイヤーごとにコマンドは1つずつで、それぞれインストーラーが書き込んだものだけに作用します。

fimemory uninstall-mcp      # remove the MCP entry from every host config
fimemory uninstall-rules    # remove the memory rule block, nothing else in the file
fimemory uninstall-hooks    # remove our two handlers from Claude Code's settings

現時点では、すべてを一括して削除するコマンドはありません。そのため、uninstall-mcp は残り2つのコマンドを表示し、削除手順を1画面にまとめます。

uninstall-mcp は、置換対象を空にした install-mcp と同じスキャンを行います。対象ホスト、対象ファイル、ホストの設定ディレクトリによってインストール済みかどうかを判断するルールも同じです。削除するのは当ツールのエントリーだけで、それ以外には触れません。解析できない設定ファイルは変更せずに残し、書き換えません。拒否された場合の終了コードは1なので、fimemory uninstall-mcp && rm -rf ~/.fimemory はそこで停止し、続行しません。当ツールのエントリーがないホストは成功として扱われ、終了コード0で終了します。

Claude Code では、インストール時と対称的な処理になります。claude mcp remove fimemory -s user を表示し、~/.claude.json は読み取り専用で参照して、エントリーが登録されているかどうかをお知らせします。

削除前のパスフレーズの確認

install-mcp --env-passthrough GESTALT_PASSPHRASE を実行したことがある場合、暗号化されたストアのパスフレーズがホストの設定ファイルに平文で保存されています。当ツールのエントリーを削除すると、パスフレーズもエントリーとともに削除されます。人によっては、その設定ファイルが唯一のコピーである場合もあります。そのため、どちらの場合も順序が重要です。

• ストアを保持する場合： 削除を始める前に、覚えているパスフレーズ、または24単語のリカバリーフレーズを使ってストアを開けることを確認してください。まず fimemory uninstall-mcp --dry-run を実行してください。削除対象の環境変数名は表示しますが、その値は表示せず、書き込みも一切行いません。
• ストアを破棄する場合： 先に設定を削除し、その後でストアのフォルダーを削除してください。これが正しい順序であり、設定ファイルにパスフレーズが残りません。
• Claude Code のバイナリ自体が、claude mcp remove は環境変数やヘッダーを含むサーバー設定を完全に削除すると明示しています。そのため、表示されるコマンドを実行すると、それらの値も削除されます。

ストアはユーザーのフォルダーにあります。そのため、ストアの削除はディレクトリの削除を意味します。~/.fimemory（名前変更前にインストールした場合は ~/.gestalt）、または --home で指定した場所です。メモを保持したい場合は、先にエクスポートしてください。

ファイルも、終了方法も、自分で決められます

fimemory export --plaintext <dir> を実行すると、すべてのメモ、ログ、提案された編集内容が、ストアの外にプレーンな Markdown として書き出されます。これは本当に使える退出手段であり、初日から利用できます。

名前に関する注記

ユーザー向けの名称はすべて fimemory です。コマンド、MCP サーバーのキー、ツール ID（fimemory_search、fimemory_get など）が該当します。名称変更前のインストール環境も引き続き動作します。~/.gestalt にあるストア、GESTALT_* 環境変数、以前の gestalt MCP エントリーは、すべて引き続き検出され、使用されます。

ライセンス

ソース公開ライセンス FSL-1.1-ALv2 のもとで提供されています（LICENSE.md を参照）。自由に使用、変更できます。販売したり、競合するサービスとして運用したりすることはできません。各バージョンはリリースから2年後に Apache-2.0 になります。