memov

memov copied to clipboard

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

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:

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

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

• mem_ui(port: int = 38888)

  • Launch the Web UI at http://localhost:38888 to visually browse history, view diffs, and jump to any snapshot.

• mem_history(limit: int = 20, commit_hash: str = "")

  • View memov history with prompts, responses, and file changes.

• mem_jump(commit_hash: str)

  • Jump to a specific snapshot, restoring all tracked files and creating a new branch.

RAG Tools (requires [rag] extras)

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.

Health Check

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