English | Deutsch | Español | Français | 日本語 | 한국어 | Português | Русский | 中文
MemoV is a memory layer for AI coding agents that provides traceable, Git-powered version control for prompts, context, and code diffs. It enables VibeGit - automatic versioning of AI coding sessions with branch exploration, rollback capabilities, and zero pollution to the standard .git repository.
| MemoV | Checkpoints |
|---|---|
| Branch exploration | Linear timeline |
| Cross-session | Session-bound |
| Rollback preserves all | Rollback erases history |
| Every jump tracked | No trajectory |

.mem timeline, files as context, zero pollution on .git
Install uv first:
# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
# Install Git (if not installed)
winget install --id Git.Git -e --source winget
Run in your project root directory:
claude mcp add mem-mcp --scope project -- uvx --from git+https://github.com/memovai/memov.git mem-mcp-launcher stdio $(pwd)
Run in your project root directory:
codex mcp add mem-mcp -- uvx --from git+https://github.com/memovai/memov.git mem-mcp-launcher stdio $(pwd)
Create .vscode/mcp.json in your project root:
{
"servers": {
"mem-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"--from",
"git+https://github.com/memovai/memov.git",
"mem-mcp-launcher",
"stdio",
"${workspaceFolder}"
]
}
}
}
Go to Files > Preferences > Cursor Settings > MCP, then add:
{
"mcpServers": {
"mem-mcp": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/memovai/memov.git",
"mem-mcp-launcher",
"stdio",
"${workspaceFolder}"
]
}
}
}
Note: Antigravity does not support
"${workspaceFolder}"variable. Please manually enter the absolute path to your project directory.
Go to Settings > MCP, then add:
{
"mcpServers": {
"mem-mcp": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/memovai/memov.git",
"mem-mcp-launcher",
"stdio",
"/absolute/path/to/your/project"
]
}
}
}
Replace /absolute/path/to/your/project with the actual absolute path to your project directory (e.g., /Users/username/projects/my-project on macOS/Linux or C:\\Users\\username\\projects\\my-project on Windows).
To enable semantic search, validation, and debugging tools, install with [rag] extras:
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: Change the --from argument to:
"git+https://github.com/memovai/memov.git[rag]"
Add a Rule — To automatically save snapshots after each interaction, add a rule to your coding agents:
CLAUDE.mdExample rule:
After completing any interaction, always call `use mem snap` to save the snapshot.
Just say "use mem ui" in the chat — opens at http://localhost:38888 with timeline view, branch filtering, diff viewer, and jump to any snapshot.
If you want to use the mem CLI tool directly (for manual tracking, history viewing, etc.):
curl -fsSL https://raw.githubusercontent.com/memovai/memov/main/install.sh | bash
Or with 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
Download the latest release for your platform:
| Platform | Download |
|---|---|
| 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 |
Linux / macOS:
curl -LO https://github.com/memovai/memov/releases/latest/download/mem-linux-x86_64.tar.gz
tar -xzf mem-linux-x86_64.tar.gz
sudo mv mem-linux-x86_64 /usr/local/bin/mem
mem --help
Windows (PowerShell):
Invoke-WebRequest -Uri "https://github.com/memovai/memov/releases/latest/download/mem-windows-x86_64.exe.zip" -OutFile "mem.zip" Expand-Archive -Path "mem.zip" -DestinationPath "." New-Item -ItemType Directory -Force -Path "$env:ProgramFiles\mem" Move-Item -Path "mem-windows-x86_64.exe" -Destination "$env:ProgramFiles\mem\mem.exe" [Environment]::SetEnvironmentVariable("Path", $env:Path + ";$env:ProgramFiles\mem", "Machine") mem --help
Requires Python 3.10+ and uv:
git clone https://github.com/memovai/memov.git
cd memov
uv sync
uv pip install -e .
mem --help
Please see docs/installation_for_dev.md for detailed installation instructions.
MemoV follows a three-tier architecture with MemovManager as the central orchestrator, the MCP Server as an adapter layer for AI agents, and an optional RAG system for semantic search.

snap(user_prompt: str, original_response: str, agent_plan: list[str], files_changed: str)
mem_ui(port: int = 38888)
http://localhost:38888 to visually browse history, view diffs, and jump to any snapshot.mem_history(limit: int = 20, commit_hash: str = "")
mem_jump(commit_hash: str)
These tools are only available when installed with [rag] extras.
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. See LICENSE.