<p align="center"> <a href="https://github.com/memovai/memov"> <img src="docs/images/memov-banner.png" width="800px" alt="MemoV - The Memory Layer for AI Coding Agents"> </a> </p> <p align="center"> <b>English</b> | <a href="docs/readme/README_DE.md">Deutsch</a> | <a href="docs/readme/README_ES.md">Español</a> | <a href="docs/readme/README_FR.md">Français</a> | <a href="docs/readme/README_JA.md">日本語</a> | <a href="docs/readme/README_KO.md">한국어</a> | <a href="docs/readme/README_PT.md">Português</a> | <a href="docs/readme/README_RU.md">Русский</a> | <a href="docs/readme/README_CN.md">中文</a> </p> <h4 align="center">VibeGit🤌: Auto-trace your prompts, context & code diffs.</h4> <div align="center">

</div>

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 |

</div>

MemoV Time

💬 Join our Discord and dive into smarter vibe engineering

Features

One-click MCP: Works with any AI coding agent
VibeGit for Agents: Auto-trace prompts, context, and code diffs before git commits
Version Control: Branch, rollback, replay any interaction
Keep Git Clean: Shadow .mem timeline, files as context, zero pollution on .git
Visual UI: Say "mem ui" in chat, and view at http://localhost:38888
Private-first — Local, no database, no overhead. Use .memignore to exclude

MemoV Time

Quick Start (MCP Installation)

Prerequisites

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

Claude Code

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)

Codex

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}"
      ]
    }
  }
}

</details> <details> <summary><b>Cursor</b></summary>

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}"
      ]
    }
  }
}

</details> <details> <summary><b>Antigravity</b></summary>

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).

</details> <details> <summary><b>With VectorDB (RAG mode)</b> 🚧 WIP</summary>

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]"

</details>

Important Tips

Add a Rule — To automatically save snapshots after each interaction, add a rule to your coding agents:

Cursor: Cursor Settings > Rules
Claude Code: CLAUDE.md
Or the equivalent in your MCP client

Example rule:

After completing any interaction, always call `use mem snap` to save the snapshot.

Web UI, Just Say Use mem ui🤌

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.

CLI Installation (Optional)

If you want to use the mem CLI tool directly (for manual tracking, history viewing, etc.):

One-Line Install

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

Package Managers

<details> <summary><b>Homebrew (macOS/Linux)</b></summary>

brew tap memovai/mem
brew install memov

</details> <details> <summary><b>APT (Debian/Ubuntu)</b></summary>

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

</details> <details> <summary><b>YUM/DNF (Fedora/RHEL/CentOS)</b></summary>

sudo curl -o /etc/yum.repos.d/mem.repo https://memovai.github.io/memov/yum/mem.repo
sudo dnf install mem

</details> <details> <summary><b>Direct Download</b></summary>

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

</details> <details> <summary><b>From Source</b></summary>

Requires Python 3.10+ and uv:

git clone https://github.com/memovai/memov.git
cd memov
uv sync
uv pip install -e .
mem --help

</details>

Installation for Contributors

Please see docs/installation_for_dev.md for detailed installation instructions.

Architecture

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.

MemoV Architecture

<details> <summary><b>MCP Tools</b></summary>

Core Operations

snap(user_prompt: str, original_response: str, agent_plan: list[str], files_changed: str)
- Record every user interaction with automatic file tracking. Handles untracked vs modified files intelli

Memov

Install / Use

README