Gemini CLI

Read https://mem.nowledge.co/SKILL.md and follow the instructions to install or update Nowledge Mem for Gemini CLI. Verify with nmem status and the Context Bundle or Working Memory check, then summarize what changed.

ほとんどのユーザーにとって、メンタルモデルはシンプルです。 ギャラリーから拡張機能をインストールし、nmemが一度動作することを確認してから、新しいGeminiセッションを開始します。 拡張機能には取得とメモリ書き込み用のローカルMCP接続が含まれています。 nmemは引き続き、起動コンテキスト、実際のスレッド保存、ステータス、リモートクライアント設定を処理します。

始める前に

• Nowledge Memがローカルで実行されている (インストール)、または到達可能なリモートMemサーバー
• Gemini CLIがインストールされている
• PATHにnmemがある

Nowledge Memが同じマシン上でデスクトップアプリを通じてすでに実行されている場合、最も簡単な方法はSettings → Preferences → Developer Tools → Install CLIです。 これにより、バンドルされたnmem CLIがインストールされ、デフォルトのローカルMemサーバーを指すようになります。

nmemを単独でインストールすることもできます:

# Option 1: pip
pip install nmem-cli

# Option 2: uvx
curl -LsSf https://astral.sh/uv/install.sh | sh
uvx --from nmem-cli nmem --version

1分セットアップ

更新

gemini extensions update nowledge-mem-gemini-cli

ギャラリーを希望する場合は、Gemini CLI Extensions Galleryを開いてNowledge Memを更新しても同じ結果になります。 重要なのは、更新後に新しいGeminiセッションを開始することです。

古いセッションをインポートする

自動キャプチャは拡張機能のインストール後に開始されます。 古いGemini CLIセッションをNowledge Memに取り込むには、まずプレビューします:

nmem t sync --from gemini-cli --all-projects --limit 20

次にインポートします:

nmem t sync --from gemini-cli --all-projects --apply

1つのプロジェクトだけを対象にしたい場合は、--all-projectsの代わりに-p /path/to/projectを使用します。 このコマンドはこのマシン上のローカルGemini CLIセッションファイルを読み取り、nmemで設定されたMemサーバーに書き込みます。

安全にカスタマイズする

動作の変更にはGemini自身のコンテキストファイルを使用します:

• プロジェクトGEMINI.md
• 個人のデフォルト用の任意の~/.gemini/GEMINI.md

ルールが大きくなった場合は、ファイルに分割し、@file.mdでインポートします。 インストールされた拡張機能のファイルを直接編集しないでください。 全体像: 統合動作のカスタマイズ。

最初の成功状態

次の状態になれば、Geminiが正しく接続されていることがわかります:

• ギャラリーからのインストールが成功する
• nmem statusが正常に返る
• 新しいGeminiセッションでNowledgeコマンドが利用可能になる
• 表示するコンテキストがある場合、新しいセッションの開始時にContext BundleまたはWorking Memoryが表示される
• save-threadが実際のGeminiセッションをインポートし、長いセッションは圧縮前とセッション終了時の両方で保存される

リモートMem

推奨されるリモートセットアップは次のとおりです:

nmem config client set url https://mem.example.com
nmem config client set api-key nmem_your_key

これにより、このマシン用の共有ローカルクライアント設定が書き込まれます。 nmem t save --from gemini-cliはGeminiが実行されているマシン上のGeminiのローカルセッションファイルを読み取り、正規化されたスレッドメッセージをMemにアップロードします。 リモートMemサーバーは~/.geminiに直接アクセスする必要はありません。

リモートモードでGemini MCPツールを使用するには、Geminiのsettings.jsonでnowledge-memサーバーを定義します。 Geminiはユーザー設定を拡張機能のバンドルされたローカルMCPサーバーより優先します:

nmem config mcp show --host gemini-cli

生成されたJSONをGeminiのsettings.jsonに貼り付けます。 直接のMCPクライアントは~/.nowledge-mem/config.jsonを自動的に読み取りません。 これにより、Gemini MCPとnmemが同じMemサーバーを指すようになります。

得られるもの

• GeminiネイティブのContext Bundle / Working Memory起動コンテキスト、フック、コマンド、スキル
• 取得とメモリ書き込み用のバンドルされたローカルMCPツール
• コンテキスト圧縮前とセッション終了時を含む、nmem t save --from gemini-cliによる完全なセッションキャプチャ
• 組み込みコマンドでは範囲が狭すぎる場合の、直接のnmemコンポジション
• nmemによるクリーンなローカルおよびリモート認証

コマンド

• /nowledge:read-working-memory
• /nowledge:search-memory <query>
• /nowledge:distill-memory
• /nowledge:save-thread
• /nowledge:save-handoff
• /nowledge:status

スレッド保存とハンドオフ

Geminiは2つの異なる保存パスをサポートしており、それらは区別されたままにしておくべきです:

• save-threadはnmem t save --from gemini-cliを通じて実際のGeminiセッションをインポートします
• save-handoffは再起動と継続のための簡潔で再開可能なサマリーを保存します

拡張機能は、Geminiがコンテキストを圧縮する前とセッション終了時にも同じスレッドインポートを実行します。 これにより、ハンドオフサマリーを偽のトランスクリプトにすることなく、記録された会話全体を検索可能に保ちます。

手動インストール

GitHubまたはローカルチェックアウトからインストールする場合は、この方法を使用します:

git clone https://github.com/nowledge-co/nowledge-mem-gemini-cli.git
cd nowledge-mem-gemini-cli
gemini extensions link .

Geminiの公式ドキュメントは、GitHubまたはローカルソース用のgemini extensions install <source>と、ローカル開発用のgemini extensions link <path>もサポートしています。 ほとんどのユーザーにとって、上記のギャラリーインストール方法が最も簡単な選択です。

関連

• コネクタの概要
• Claude Code
• Codex
• リモートアクセス