Graphmem

Graphmem

面向编码 Agent 的共享本地记忆。使用 SQLite 存储、本地语义搜索和关联实体，在不同会话和工具间保留项目决策。 Claude Code、Codex、OpenCode、pi 和其他 MCP 客户端可以共享同一存储。

可选的代码工具可查找定义、概述文件、列出导入项，并比较不同 Git 修订版本之间的符号。

安装

npm install --global @sonic182/graphmem
gmem-install
gmem version

npm 包包含启动器。gmem-install 会显式下载并验证匹配的 CPU 二进制文件，或复用 PATH 上可正常工作的本机 gmem。安装软件包本身不会下载二进制文件。升级软件包后，请再次运行 gmem-install；单独安装的二进制文件不会被替换。

通过 npx 启动服务的 MCP 客户端可以运行 npx -y @sonic182/graphmem mcp。 graphmem 命令会在首次运行时下载并验证二进制文件；gmem 本身不会下载任何内容。

或者，从 GitHub Releases 下载适用于你平台的归档文件，根据 SHA256SUMS 验证，然后将解压后的可执行文件放到 PATH 上。 Linux 版本需要 glibc 2.39 和 OpenSSL 3。对于其他系统或 CUDA，请从源代码构建。

与编码 Agent 搭配使用

插件包含 MCP 注册、技能，以及用于在开始工作前回想上下文、并在完成后保存持久决策的指导。

Agent	安装
Claude Code	claude plugin marketplace add sonic182/graphmem，然后运行 claude plugin install graphmem@graphmem
Codex	codex plugin marketplace add sonic182/graphmem，然后运行 codex plugin add graphmem@graphmem
OpenCode	opencode plugin @sonic182/graphmem --global
pi	pi install npm:@sonic182/graphmem

Claude Code 和 Codex 需要 PATH 上有 gmem 和 Node.js。在 Codex 中，信任 /hooks 中的 Graphmem hooks，然后开启一个新对话。pi 会在首次启动时提供二进制文件设置；如果需要，OpenCode 会打印安装命令。

请参阅插件设置与故障排查。

对于其他 MCP 客户端，请将其配置为启动已安装的二进制文件：

{
  "mcpServers": {
    "graphmem": {
      "command": "/absolute/path/to/gmem",
      "args": ["mcp"]
    }
  }
}

CLI

gmem remember "Use nextest for integration tests" \
  --type convention --scope repo:/absolute/path/to/project
gmem search "integration tests"
gmem tokens --over-limit   # memories the embedding model truncates
gmem tui
gmem mcp

记忆默认对应当前 Git 仓库；git 必须位于 PATH 上。在仓库外，默认范围为 global。读取始终包含全局记忆；使用 --scope（CLI）或 scopes（MCP）显式选择其他项目。写入仅限当前仓库和 global，包括更新和删除。MCP list_scopes 工具会发现范围及其写入权限；list 会分页列出所选范围的记忆。 数据存储在 ~/.graphmem；设置 GRAPHMEM_HOME 可使用其他目录。

CLI 参考 · MCP 工具参考

代码导航（可选）

发布版二进制文件包含这些工具；从源代码构建时需要 --features code。

MCP 工具	用途
find_symbol	查找定义及其源代码范围
code_outline	列出文件中的定义及其嵌套关系
code_imports	列出声明的导入项
code_diff	比较不同 Git 修订版本之间的符号

gmem code find CodeService
gmem code outline src/application/code.rs
gmem code imports src/application/code.rs
gmem code diff origin/master

这些工具可用于 Git 工作区，无需嵌入模型。它们会索引定义，而非调用点或引用；查找这些内容请使用 ast-grep。 设置 GRAPHMEM_CODE=off 可禁用代码工具。

选项和支持的语言 · 基准测试结果和局限性

配置

无需配置文件。若要自定义嵌入、检索或代码索引，请创建 ~/.graphmem/config.toml。请参阅配置参考。

构建

请参阅从源代码构建和 CUDA 设置。

开发

just verify

运行格式检查、编译、Clippy 和测试。 设计 · 模式演进

要预览文档站点，请运行 hugo server --source site。 请参阅站点设置。

许可证

MIT。