English | Deutsch | Español | Français | 日本語 | 한국어 | Português | Русский | 中文
MemoV 是 AI 编程代理的记忆层,提供可追溯、Git 驱动的提示词、上下文和代码差异版本控制。它实现了 VibeGit - AI 编程会话的自动版本化,支持分支探索、回滚功能,且对标准 .git 仓库零污染。
| MemoV | Checkpoints |
|---|---|
| 分支探索 | 线性时间线 |
| 跨会话 | 绑定会话 |
| 回滚保留所有历史 | 回滚清除历史 |
| 跳转轨迹可追踪 | 无轨迹记录 |

.mem 时间线,零污染 .git
先安装 uv:
# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
# 安装 Git(如果未安装)
winget install --id Git.Git -e --source winget
在项目根目录运行:
claude mcp add mem-mcp --scope project -- uvx --from git+https://github.com/memovai/memov.git mem-mcp-launcher stdio $(pwd)
在项目根目录运行:
codex mcp add mem-mcp -- uvx --from git+https://github.com/memovai/memov.git mem-mcp-launcher stdio $(pwd)
在项目根目录创建 .vscode/mcp.json:
{
"servers": {
"mem-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"--from",
"git+https://github.com/memovai/memov.git",
"mem-mcp-launcher",
"stdio",
"${workspaceFolder}"
]
}
}
}
进入 Files > Preferences > Cursor Settings > MCP,添加:
{
"mcpServers": {
"mem-mcp": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/memovai/memov.git",
"mem-mcp-launcher",
"stdio",
"${workspaceFolder}"
]
}
}
}
注意: Antigravity 不支持 "${workspaceFolder}" 变量,请手动填写项目目录的绝对路径。
前往 Settings > MCP,然后添加:
{
"mcpServers": {
"mem-mcp": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/memovai/memov.git",
"mem-mcp-launcher",
"stdio",
"/absolute/path/to/your/project"
]
}
}
}
将 /absolute/path/to/your/project 替换为项目目录的实际绝对路径(例如 macOS/Linux 上 /Users/username/projects/my-project 或 Windows 上 C:\Users\username\projects\my-project)。
要启用语义搜索、验证和调试工具,使用 [rag] 扩展安装:
Claude Code:
claude mcp add mem-mcp --scope project -- uvx --from "git+https://github.com/memovai/memov.git[rag]" mem-mcp-launcher stdio $(pwd)
VS Code / Cursor: 将 --from 参数改为:
"git+https://github.com/memovai/memov.git[rag]"
添加规则 — 要在每次交互后自动保存快照,请在你的编程代理中添加规则:
CLAUDE.md示例规则:
After completing any interaction, always call `use mem snap` to save the snapshot.
在对话中说 "use mem ui" — 在 http://localhost:38888 打开,包含时间线视图、分支过滤、差异查看器和一键跳转到任意快照。
如果你想直接使用 mem 命令行工具(用于手动追踪、查看历史等):
curl -fsSL https://raw.githubusercontent.com/memovai/memov/main/install.sh | bash
或使用 wget:
wget -qO- https://raw.githubusercontent.com/memovai/memov/main/install.sh | bash
brew tap memovai/mem brew install memov
echo "deb [trusted=yes] https://memovai.github.io/memov/apt stable main" | sudo tee /etc/apt/sources.list.d/mem.list
sudo apt update
sudo apt install mem
sudo curl -o /etc/yum.repos.d/mem.repo https://memovai.github.io/memov/yum/mem.repo sudo dnf install mem
下载适合你平台的最新版本:
| 平台 | 下载 |
|---|---|
| Linux x86_64 | mem-linux-x86_64.tar.gz |
| macOS Intel | mem-macos-x86_64.tar.gz |
| macOS Apple Silicon | mem-macos-arm64.tar.gz |
| Windows x86_64 | mem-windows-x86_64.exe.zip |
需要 Python 3.10+ 和 uv:
git clone https://github.com/memovai/memov.git
cd memov
uv sync
uv pip install -e .
mem --help
请参阅 docs/installation_for_dev.md 获取详细安装说明。
MemoV 采用三层架构,以 MemovManager 为核心协调器,MCP Server 作为 AI 代理的适配层,以及可选的 RAG 系统用于语义搜索。

snap(user_prompt: str, original_response: str, agent_plan: list[str], files_changed: str)
mem_ui(port: int = 38888)
http://localhost:38888 启动 Web 界面,可视化浏览历史、查看差异和跳转到任意快照。mem_history(limit: int = 20, commit_hash: str = "")
mem_jump(commit_hash: str)
这些工具仅在使用 [rag] 扩展安装时可用。
mem_sync()
validate_commit(commit_hash: str, detailed: bool = True)
validate_recent(n: int = 5)
vibe_debug(query: str, error_message: str = "", stack_trace: str = "", user_logs: str = "", models: str = "", n_results: int = 5)
vibe_search(query: str, n_results: int = 5, content_type: str = "")
GET /health
MIT License。详见 LICENSE。