MemoV as VibeGit = Prompt + Agent Plan + CodeDiff, all under version control. VibeGit: A shadow .mem timeline alongside git — every interaction (prompt, plan, diff) captured before you commit.

• 💬 Join our Discord and dive into smarter context engineering
• 🌐 Visit memov.ai to visualize your coding memory and supercharge existing GitHub repos

• 📒 ContextGit memory: Automatically track code diffs, prompts, and agent plans — independent of .git.
• ⏪ Fine-grained rollback: Built on git, revert to a specific agent plan within a single commit
• 🤝 Team context sharing: Real-time alignment with zero friction
• ♻️ Change reuse: Reapply past code edits by description to save tokens when iterating on a feature

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"

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)

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

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

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

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

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

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.

These are available to MCP clients through the server:

• 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 intelligently.

These tools are only available when installed with [rag] extras.

• mem_sync()

  • Sync all pending operations to VectorDB for semantic search capabilities.

• validate_commit(commit_hash: str, detailed: bool = True)

  • Validate a specific commit by comparing prompt/response with actual code changes. Detects context drift and alignment issues.

• validate_recent(n: int = 5)

  • Validate the N most recent commits for alignment patterns. Useful for session reviews and quality assurance.

• vibe_debug(query: str, error_message: str = "", stack_trace: str = "", user_logs: str = "", models: str = "", n_results: int = 5)

  • Debug issues using RAG search + multi-model LLM comparison. Searches code history for relevant context and queries multiple AI models (GPT-4, Claude, Gemini) in parallel for diverse debugging insights.

• vibe_search(query: str, n_results: int = 5, content_type: str = "")

  • Fast semantic search through code history (prompts, responses, agent plans, code changes) without LLM analysis. Perfect for quick context lookup.

• GET /health
  • Returns "OK". Useful for IDE/agent readiness checks.

MIT License. See LICENSE.