Gemini CLI

读取 https://mem.nowledge.co/SKILL.md，按其中说明为 Gemini CLI 安装或更新 Nowledge Mem。用 nmem status 和 Working Memory 检查验证结果，并总结你改了什么。

对大多数用户来说，心智模型可以很简单：先从官方 Gallery 安装扩展，确认一次 nmem 正常，再开一个新的 Gemini 会话。扩展内置本地 MCP 连接，用于检索和写入记忆；nmem 继续负责钩子、真实线程保存、状态检查和远程客户端配置。

开始之前

• Nowledge Mem 已在本地运行（安装指南），或你已经有可访问的远程 Mem 服务
• 已安装 Gemini CLI
• nmem 在你的 PATH 中

如果你已经在同一台机器上运行 Nowledge Mem 桌面应用，最省事的方式是打开 设置 → 偏好设置 → 开发者工具 → 安装 CLI。这样会把随应用附带的 nmem 安装到 PATH，并直接连上默认的本地 Mem 服务。

你也可以单独安装 nmem：

# 方式一：pip
pip install nmem-cli

# 方式二：uvx
curl -LsSf https://astral.sh/uv/install.sh | sh
uvx --from nmem-cli nmem --version

一分钟安装

更新

gemini extensions update nowledge-mem-gemini-cli

如果你更习惯通过扩展库更新，也可以直接在 Gemini CLI 扩展库里更新 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

如果只想导入某个项目，用 -p /path/to/project 代替 --all-projects。这个命令会读取本机 Gemini CLI 会话文件，并写入 nmem 当前配置的 Mem 服务器。

安全地自定义

想调整行为时，优先使用 Gemini 自己的上下文文件：

• 项目里的 GEMINI.md
• 如果你想做个人默认规则，可用 ~/.gemini/GEMINI.md

如果规则变长，可以继续用 @file.md 拆分。不要直接去改已安装扩展里的文件。完整对照表见 安全地自定义连接行为。

第一次成功应该看到什么

当下面几件事成立时，就说明 Gemini 已经接通：

• 你已经从 Gallery 成功安装扩展
• nmem status 可以正常返回
• 新开的 Gemini 会话里可以看到 Nowledge 命令
• 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 工具也连接远程 Mem，请在 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 原生的上下文注入、生命周期钩子、命令和技能
• 内置本地 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 有两条不同的保存路径，而且应该继续严格区分：

• 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 官方文档也支持 gemini extensions install <source>（GitHub 或本地 source），以及 gemini extensions link <path>（本地开发）。对大多数用户来说，上面的已上架官方扩展安装流程仍然是最简单的选择。

相关内容

• 连接总览
• Claude Code
• Codex
• 远程访问