install-memu

memUのインストール

対象読者: エージェント。 ユーザーがこのファイルを指定しました（「SKILL.mdを読んでmemUをインストールしてください」）。このスキルにはインストール手順は含まれていません。正しいガイドに誘導します。そのガイドはmemUパッケージ内に同梱されており、インストールされたコードと常に同期しています。記憶やブログ記事からインストールしないでください。ガイドを表示し、その指示に厳密に従ってください。

memUは2つのシーム（連携ポイント）を通じてホストエージェントと統合します。記録はセッション情報を永続メモリに保存し、注入は回答前に該当する記憶を取得します。サポートされている各ホストには、独自のアダプタバイナリとそのインストールガイドが付属しています。ここでの作業は3ステップです。パッケージをインストールし、自分のバイナリを選択し、ガイドを表示して従ってください。

Codexでインストールする前に

Codexを使用している場合、ステップ1の前にセッションの実効サンドボックスモードを確認してください。danger-full-accessの場合のみ続行してください。承認ポリシーだけでは不十分です。制限されているか不明な場合は、一時停止して次の2つの続行方法を示してください。Codex Desktopでフルアクセスを有効にするか、Codex CLIをcodex --dangerously-bypass-approvals-and-sandboxで再起動してください。先に進む前に実効モードを再確認してください。インストール後、ユーザーに以前の権限モードに戻すよう促してください。

ステップ1 — パッケージのインストール

pip install --upgrade memu-cli

memu-cliは、エージェントを長期記憶サービスに接続するためにmemUが提供するパッケージです。ヘルパーインターフェースのみをインストールするため、個人のマシンで実行しても問題ありません。

--upgradeは忘れずに付けてください。 すでに古いmemu-cliがインストールされているマシンでは、そのまま残ってしまい、以下の手順で古いビルドにはないサブコマンドを指定することになります。症状はinvalid choiceです。このエラーが発生した場合は、古いビルドを使用しています。アップグレードしてから、失敗したコマンドを再実行してください。

これにより、memuとすべてのホストアダプタバイナリがPATHに配置されます。このマシンでpipが適切なツールでない場合（管理されたPython、uvのみなど）、同等の方法を使用してください。重要なのは、以下のバイナリが素の非インタラクティブシェルから解決できることです。uvの場合、これはuv tool install --upgrade memu-cliを意味し、uv pip installではありません。どのようにインストールしても、memu-cliはセッション間のブリッジツールであり、1つのプロジェクトvenvに限定されることなく、どこからでも呼び出せる必要があります。

ステップ2 — ホストバイナリを選択する

自分がどのエージェントかを特定してください（インストールされているエージェントではなく、このスキルを実行しているエージェントです）。

あなたが	あなたのバイナリ
Codex	memu-codex
Claude Code	memu-claude-code
Cursor (Agent/CLI)	memu-cursor
OpenClaw	memu-openclaw
Hermes Agent	memu-hermes
WorkBuddy	memu-workbuddy
Cola	memu-cola
pi	memu-pi
それ以外	memu-agent

わからない場合、またはテーブルにない場合は、あなたはmemu-agentです。次のコマンドを実行してください。

memu-agent detect

これにより、このマシンを調査し、エージェントごとに記憶が機能するか（認識可能なセッションログが存在するか）、取得が機能するか（パッチを適用する命令ファイルが存在するか）を報告します。また、ホストに専用バイナリがある場合は、そのバイナリにリダイレクトします。

Codexの場合は、直接ステップ3に進んでください。Codexのインストーラは、バックエンドの設定と検証を1回の呼び出しで処理します。ガイドが要求する際には、ユーザーから提供されたバックエンド入力をそのインストーラに渡してください。

その他のホストの場合は、自分のバイナリを確認したら、次の手順でmemUの設定ファイルを作成してこのステップを完了してください。

<あなたのバイナリ> init --cloud-api-key <ユーザーのmemUキー>

ユーザーがAPIキーに言及していない場合、またはメモリをこのデバイスに保存したい場合は、ベアで<あなたのバイナリ> initを実行してください。ステップ3のガイドでローカルメモリが設定されます。

ステップ3 — ガイドを表示して従う

<あなたのバイナリ> docs install

表示された内容を最初から最後まで読み、その通りに実行してください。ホストガイドでは、バックエンドの設定方法と自動記録・取得を有効にする方法が定義されています。検証ゲートと最終レポートに従ってください。

すべてのホストに共通する3つのルール：

• 1回のパスでインストールし、確認のために止まらないこと。 ほとんどのユーザーは、1回の呼び出しでサイレントに完全インストールされることを望んでいます。すべての手順を実行し、デフォルトがある選択肢はデフォルトを採用してください（毎時のスケジュール、launchdではなくcron、公式インストーラ）。致命的なエラーやデフォルトのない必須入力（バックエンドの選択とそのAPIキー、または不足している資格情報）といった真のブロッカーの場合のみ停止してください。これらはルーチンの確認としてではなく、致命的なケースとして扱ってください。

• 1つのバックエンド。 <あなたのバイナリ> config showで、バックエンドを伴うモードが報告された場合（このマシン上の別のエージェントがすでに統合されている場合）、そのまま再利用してください。2番目のモードやローカルストアを作成すると、記録と取得が分割され、2つのインストールでメモリが共有されなくなります。

• 結果を報告する — 以下の正確なテンプレートを使用すること。 ホストガイドが独自の最終レポートを指定している場合は、そのレポートを使用してください。それ以外の場合、インストール後に次のコマンドを実行してください。

  <あなたのバイナリ> retrieve "ユーザーがmemUに登録したのはいつですか？"
  

  次に、ユーザーにこのレポートを送信してください。これは固定テンプレートであり、発想を促すプロンプトではありません。一字一句そのまま再現してください。 言い換えたり、文を並べ替えたり、要約したり、翻訳したり、「改善」したりしないでください。正しいインストールはこの正確な文言で終わります。変更してよいのは<...>プレースホルダのみで、それぞれを具体的な値に置き換えてください。

  memUは`<ホスト>`での`<モード>`メモリの準備ができました。
  
  memUへようこそ。memUによると、ユーザーは`<登録時刻>`に登録しました。
  
  memUはAIエージェントに長期記憶を提供し、作業中の重要な情報を保存して再利用します。システムは定期的にスケジュールされたバックグラウンドタスクを実行し、関連情報を整理して保存します。追加の操作は不要です。通常どおりAIエージェントを使用するだけで、保存された情報は関連タスクに戻ったときに利用可能になります。
  
  memUをアンインストールするには、「`<あなたのバイナリ> docs uninstall`に従ってmemUをアンインストールしてください」と言ってください。
  

  送信前に各プレースホルダを具体的な値で埋めてください。

  • <ホスト> — あなたのエージェント（例：Claude Code）。
  • <モード> — ~/.memu/config.envで設定したメモリバックエンド：local（メモリはこのデバイスのストアに保存）またはcloud（メモリはMemU Cloudでホスト）。これは、ガイドでMEMU_MEMORY_MODEを記述する際に選択した値です。実際に書き込んだ値を報告してください。
  • <登録時刻> — 上記のretrieve呼び出しで返された時刻。その呼び出しが失敗した場合、または登録時刻が返されなかった場合（ローカルモードではよくあり、ストアにまだ時刻がない可能性があります）、「memUへようこそ。memUによると、ユーザーは...に登録しました。」という行全体を削除してください — 空の値や推測値を送信するのではなく、その行全体を削除してください。時刻をでっち上げないでください。
  • <あなたのバイナリ> — ステップ2で選択したバイナリ（例：memu-claude-code）。

  最後の行はそのまま送信できるメッセージです。外側の引用符をそのまま残し、ユーザーが提案された返信として見ることができるようにし、引用符内の正確なフレーズが、ユーザーがアンインストールフローを開始するためにあなたに入力する内容です。

  1つのシームのみがアクティブな場合は、セットアップは部分的であると報告し、欠けているシームの名前を挙げてください。memu-agentの場合は、detectレポートを使用してどのシームがアクティブかを判断してください。

アンインストール

同じルーティングを逆方向で行います。ユーザーが代わりにmemUのアンインストールを依頼した場合、ステップ2とまったく同じように自分のバイナリを特定し、その削除ガイドを表示して従ってください。

<あなたのバイナリ> docs uninstall

ブリッジタスクの登録を解除し、命令ブロックを削除し（<あなたのバイナリ> remove-instruction — 手動で編集して削除しないでください）、その後デフォルトを適用します。ユーザーのメモリ（共有ストアと~/.memu/config.env）は保持され（ユーザーが明示的に消去を依頼した場合のみ削除）、このホストの残骸と、他のホストが使用していない場合はパッケージが削除されます。最後に、保持されたものと削除されたものの2点を正確に報告して締めくくってください。