Gemini CLI
通过官方扩展路径安装 Nowledge Mem,并在大约一分钟内让 Gemini CLI 连上本地或远程 Mem。
现已上线 Extensions Gallery
最顺手的方式是直接在官方 Gemini Extensions Gallery 安装 Nowledge Mem,重启 Gemini CLI,把底层的记忆操作交给 nmem。
如果你更喜欢手动安装
页面底部依然保留了 GitHub 和本地目录安装方式,但对大多数用户来说,上面的官方扩展路径已经是默认推荐。
在当前这一组 CLI 集成里,Gemini 是最完整的一条原生路径:Gemini 提供扩展入口,nmem 负责记忆执行、真实会话导入、交接摘要创建,以及本地与远程统一认证。
开始之前
- Nowledge Mem 已在本地运行(安装指南),或你已经有可访问的远程 Mem 服务
- 已安装 Gemini CLI
nmem在你的PATH中
如果你已经在同一台机器上运行 Nowledge Mem 桌面应用,最省事的方式是打开 Settings -> Preferences -> Developer Tools -> Install 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 CLI Extensions Gallery,搜索 Nowledge Mem。
安装扩展,然后重启 Gemini CLI。
先运行一次 nmem status。
对于同机默认配置,它应该指向 http://127.0.0.1:14242 (default)。
打开一个新的 Gemini CLI 会话。
扩展会自动加载 GEMINI.md、发现命令,并让技能在需要时可用。
远程 Mem
长期稳定的远程配置方式是 nmem 自己的配置文件:
{
"apiUrl": "https://mem.example.com",
"apiKey": "nmem_your_key"
}nmem t save --from gemini-cli 会在运行 Gemini 的那台机器上读取本地 Gemini 会话文件,再把规范化后的线程消息上传到 Mem。远程 Mem 服务器不需要直接访问 ~/.gemini。
你会得到什么
- Gemini 原生的上下文注入、生命周期钩子、命令和技能
- 通过
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会保存一个适合中断后继续的交接摘要
手动安装
如果你更喜欢从 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>(本地开发)。对大多数用户来说,上面的已上架官方扩展安装流程仍然是最简单的选择。