Installation

MemoV offers multiple installation methods depending on your use case.

Prerequisites

Install 
code
uv
first:
bash
# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

MCP Integration (Recommended)

The fastest approach for AI agent integration - automatic updates on agent restart.

Claude Code

Run in your project root directory:
bash
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:
bash
codex mcp add mem-mcp -- uvx --from git+https://github.com/memovai/memov.git mem-mcp-launcher stdio $(pwd)

VS Code

Create 
code
.vscode/mcp.json
in your project root:
json
{
  "servers": {
    "mem-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/memovai/memov.git",
        "mem-mcp-launcher",
        "stdio",
        "${workspaceFolder}"
      ]
    }
  }
}

Cursor

Go to Files > Preferences > Cursor Settings > MCP, then add:
json
{
  "mcpServers": {
    "mem-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/memovai/memov.git",
        "mem-mcp-launcher",
        "stdio",
        "${workspaceFolder}"
      ]
    }
  }
}

Claude Desktop

Create or edit 
code
~/.config/claude/claude_desktop_config.json
(on Windows: 
code
%APPDATA%\Claude\claude_desktop_config.json
):
json
{
  "mcpServers": {
    "memov": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/memovai/memov.git",
        "mem-mcp-launcher",
        "stdio",
        "."
      ]
    }
  }
}

RAG Mode Installation

To enable semantic search capabilities with VectorDB:

Claude Code with RAG

bash
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 with RAG

Change the 
code
--from
argument to:
code
"git+https://github.com/memovai/memov.git[rag]"

CLI Installation

If you want to use the 
code
mem
CLI tool directly:

One-Line Install

bash
curl -fsSL https://raw.githubusercontent.com/memovai/memov/main/install.sh | bash

Homebrew (macOS/Linux)

bash
brew tap memovai/mem
brew install memov

APT (Debian/Ubuntu)

bash
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

From Source

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

Quick Start

Step 1: Verify Installation

bash
mem --version
mem --help

Step 2: Initialize Your Project

bash
cd your-project
mem init
This creates the 
code
.mem/
shadow timeline directory with:
  • code
    .mem/memov.git/
    - bare Git repository
  • code
    .mem/branches.json
    - branch metadata
  • code
    .mem/jump.json
    - jump history

Step 3: Track Files

bash
mem track src/main.py src/utils.py

Step 4: Create Snapshots

bash
mem snap --prompt "Added error handling" --response "Implemented try-catch blocks"

Step 5: View History

bash
mem history
mem history --limit 10

Step 6: Launch Web UI

bash
mem ui
Opens at 
code
http://localhost:38888

Troubleshooting

code
uvx: command not found

Install the 
code
uv
package manager:
bash
curl -LsSf https://astral.sh/uv/install.sh | sh

code
mem: command not found

Verify installation location and add to PATH:
bash
which mem
echo $PATH

MCP Server Not Starting

  1. Verify 
    code
    uv
    is installed
  2. Test manual launch: 
    code
    mem-mcp-launcher stdio .
  3. Check IDE logs for error messages

RAG Mode Tools Unavailable

Reinstall with RAG extras:
bash
uvx --from "git+https://github.com/memovai/memov.git[rag]" mem-mcp-launcher

Development Setup

For contributors:
bash
git clone https://github.com/memovai/memov.git
cd memov
uv sync
uv run pytest
pre-commit install
Edit this page on GitHub →