Context Vault

context-vault

为 AI Agent 提供持久记忆：Agent 保存所学内容，并在下一次会话中再次找到它们。条目是你设备上的纯 Markdown 文件。

托管版：云同步、Web 控制面板和团队共享，访问 app.context-vault.com

快速开始：不到 5 分钟，在新会话中回忆一条记忆

在干净的 macOS 账户上使用 Claude Code 计时：命令大约需要一分钟，另加你输入的时间。

1. 安装二进制文件（macOS 和 Linux；无需 Node）：

curl -fsSL https://context-vault.com/install.sh | bash

它会将 context-vault 放到 ~/.local/bin。如果提示该目录不在 PATH 中，请运行它打印的那一行，然后打开一个新终端。

2. 连接你的 AI 工具：

context-vault setup

这会将 Context Vault 添加到 Claude Code 以及找到的所有其他客户端（Claude Desktop、Cursor、Windsurf、Cline、Roo Code）的 MCP 配置中。--client claude-code 可将范围限制为一个客户端；--dry-run 会显示它将写入的内容。

**3. 重启你的 AI 工具。**退出后重新启动（对于 Claude Code，在新终端中重新运行 claude）。首次启动时会下载搜索模型（约 90 MB），只需下载一次。

**4. 保存一些内容。**为知识库命名，否则 Claude Code 可能会将内容保存到它自己的内置记忆中：

保存到我的知识库：我们的暂存存储桶名为 aurora-gravel-17

**5. 在新会话中回忆它。**退出，启动一个新会话，然后询问：

搜索我的知识库：我们的暂存存储桶叫什么？

答案来自知识库，条目是 ~/.vault/ 下的 Markdown 文件，你可以打开并编辑。context-vault doctor 应输出 engine health: OK。

Windows：运行 irm https://context-vault.com/install.ps1 | iex，打开一个新终端，然后执行步骤 2 至 5。

功能

• 保存：洞见、决策、模式和参考资料。你的 Agent 会在工作过程中将它们写入知识库。
• 搜索：混合全文和语义搜索，支持自然语言。
• 掌控自己的数据：将 Markdown 文件保存在你控制的文件夹中，兼容 git，且可由人编辑。

MCP 工具

你的 Agent 会调用这些工具；你只需用日常语言与它对话。

工具	功能
save_context	保存条目，或按 ID 更新条目
get_context	搜索知识库（全文和语义搜索）
recall	根据原始信号提供轻量提示：提示词、错误、文件路径
list_context	按类别、标签或日期浏览条目
delete_context	按 ID 删除条目
ingest_url	获取网页并保存其中可读的文本
ingest_project	扫描本地项目并将其登记
create_snapshot	将某个主题的条目汇编成一份简报
session_end	保存会话摘要及其发现
context_status	知识库状态：路径、数量、问题
list_buckets	列出存储桶（bucket:<name> 标签用于限定条目范围）

类别（insight、decision、pattern、reference 或自定义类别）对应知识库中的文件夹。

命令行

命令	功能
context-vault setup	将 MCP 服务注册到你的 AI 工具
context-vault doctor	检查安装情况：路径和引擎运行状况
context-vault status	条目数量和解析后的路径
context-vault search <q>	从 Shell 中搜索
context-vault save	从 Shell 中保存条目
context-vault reindex	根据 Markdown 文件重建索引
context-vault --help	查看所有命令

配置

设置	默认值	覆盖方式
知识库	~/.vault/	CONTEXT_VAULT_VAULT_DIR
数据	~/.context-mcp/	CONTEXT_VAULT_DATA_DIR
数据库	~/.context-mcp/vault.db	CONTEXT_VAULT_DB_PATH

故障排除

• context-vault: command not found：安装目录不在你的 PATH 中。运行 ~/.local/bin/context-vault setup，或将安装程序输出的那行内容添加到你的 Shell 配置文件中。
• 你的 Agent 提示缺少知识库工具：完成设置后重启 AI 工具；在 Claude Code 中，/mcp 可以查看 context-vault 是否已连接。context-vault setup --print 会显示它写入的配置项。
• 你的 Agent 把内容保存到了其他位置：在请求中说“我的知识库”。
• 搜索结果过时：运行 context-vault reindex。

npm 软件包（npx context-vault）仍是较旧的 3.20 Node 构建版本；请使用上方的安装脚本。

托管选项

在 app.context-vault.com 提供云同步、Web 仪表板和团队共享。Claude Code、Cursor 和 GPT Actions 的设置说明：docs/distribution/connect-in-2-minutes.md

反馈

• 有问题或想法？ 讨论区
• 发现 Bug？ 提交问题

开发

git clone https://github.com/fellanH/context-vault.git
cd context-vault
cargo build --release -p context-vault-cli
./target/release/context-vault --help

许可证

MIT