Skip to content
Back to search

memov

Give git-like & traceable memory to OpenClaw and any coding agents. By https://memov.ai/ aka Entire CLI for every coding agents by MCP. Self-evolution for skills.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/memovai--memov/badge.svg)](/listings/memovai--memov)

HTML

<a href="/listings/memovai--memov"><img src="/api/listings/memovai--memov/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

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)

<details> <summary><b>VS Code</b></summary>

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.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 360 lines · 2 findings marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <a href="https://github.com/memovai/memov">
  3. <img src="docs/images/memov-banner.png" width="800px" alt="MemoV - The Memory Layer for AI Coding Agents">
  4. </a>
  5. </p>
  6. <p align="center">
  7. <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>
  8. </p>
  9. <h4 align="center">VibeGit🤌: Auto-trace your prompts, context & code diffs.</h4>
  10. <div align="center">
  11. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  12. [![Discord](https://img.shields.io/badge/Discord-Join%20Server-7289da?logo=discord&logoColor=white)](https://discord.gg/un54aD7Hug)
  13. [![DeepWiki](https://img.shields.io/badge/DeepWiki-memovai%2Fmemov-blue.svg?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld0JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiBzdHJva2U9IiNmZmZmZmYiIHN0cm9rZS13aWR0aD0iMiIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIiBzdHJva2UtbGluZWpvaW49InJvdW5kIj48cGF0aCBkPSJNNCAxOWguNmMuNC0uMi44LS41IDEuMi0uOCAyLjItMS42IDMuNy0zLjggNC4yLTYuMyIvPjxwYXRoIGQ9Ik0xNC42IDEyLjFjLjYtLjkgMS4zLTEuOCAyLjEtMi42IDEuMS0xLjEgMi40LTEuOCAzLjgtMi4yIDEuMS0uMyAyLjItLjQgMy4zLS4zIi8+PHBhdGggZD0iTTE5LjQgNS4yYy0uOC4xLTEuNi4zLTIuMy41LS41LjItLjkuNC0xLjQuNy0uNC4zLS44LjYtMS4xIDEiLz48cGF0aCBkPSJNNiAxOGMtMS44IDAtMy0xLjUtMy0zIDAtMi4yIDEuOS0zLjUgMi44LTUgLjUtLjggMS45LTIuNyAyLjMtMy43LjYtMS4yIDEuMi0yLjQgMS42LTMuNi4xLS40LjUtLjkuOS0uOS43IDAgLjggMS4yLjggMS4zIDAgMS40LS4zIDIuOC0uNyA0LjEtLjQgMS41LTEuMSAyLjktMS44IDQuMyIvPjwvc3ZnPg==)](https://deepwiki.com/memovai/memov)
  14. [![Twitter Follow](https://img.shields.io/twitter/follow/ssslvky?style=social)](https://x.com/ssslvky)
  15. </div>
  16. 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.
  17. <div align="center">
  18. | MemoV | Checkpoints |
  19. |-------|-------------|
  20. | Branch exploration | Linear timeline |
  21. | Cross-session | Session-bound |
  22. | Rollback preserves all | Rollback erases history |
  23. | Every jump tracked | No trajectory |
  24. </div>
  25. <!-- <p align="center">
  26. <img src="docs/images/readme.gif" alt="MemoV Demo" width="800px">
  27. </p> -->
  28. ![MemoV Time](docs/images/ALL.png)
  29. - 💬 [Join our Discord](https://discord.gg/un54aD7Hug) and dive into smarter vibe engineering
  30. <!-- <div align="center">
  31. [![Add to VS Code](https://img.shields.io/badge/Add%20to%20VS%20Code-007ACC?style=for-the-badge&logo=visual-studio-code&logoColor=white)](https://memov.ai/set-mcp)
  32. [![Add to Cursor](https://img.shields.io/badge/Add%20to%20CURSOR-000000?style=for-the-badge&logo=visual-studio-code&logoColor=white)](https://memov.ai/set-mcp)
  33. </div> -->
  34. ## Features
  35. - **One-click MCP**: Works with any AI coding agent
  36. - **VibeGit for Agents**: Auto-trace prompts, context, and code diffs before git commits
  37. - **Version Control**: Branch, rollback, replay any interaction
  38. - **Keep Git Clean**: Shadow `.mem` timeline, files as context, zero pollution on `.git`
  39. - **Visual UI**: Say "mem ui" in chat, and view at http://localhost:38888
  40. - **Private-first** — Local, no database, no overhead. Use .memignore to exclude
  41. ![MemoV Time](docs/images/one.png)
  42. ## Quick Start (MCP Installation)
  43. ### Prerequisites
  44. Install `uv` first:
  45. ```bash
  46. # macOS / Linux
  47. curl -LsSf https://astral.sh/uv/install.sh | sh
  48. # Windows
  49. powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  50. # Install Git (if not installed)
  51. winget install --id Git.Git -e --source winget
  52. ```
  53. ### Claude Code
  54. Run in your project root directory:
  55. ```bash
  56. claude mcp add mem-mcp --scope project -- uvx --from git+https://github.com/memovai/memov.git mem-mcp-launcher stdio $(pwd)
  57. ```
  58. ### Codex
  59. Run in your project root directory:
  60. ```bash
  61. codex mcp add mem-mcp -- uvx --from git+https://github.com/memovai/memov.git mem-mcp-launcher stdio $(pwd)
  62. ```
  63. <details>
  64. <summary><b>VS Code</b></summary>
  65. Create `.vscode/mcp.json` in your project root:
  66. ```json
  67. {
  68. "servers": {
  69. "mem-mcp": {
  70. "type": "stdio",
  71. "command": "uvx",
  72. "args": [
  73. "--from",
  74. "git+https://github.com/memovai/memov.git",
  75. "mem-mcp-launcher",
  76. "stdio",
  77. "${workspaceFolder}"
  78. ]
  79. }
  80. }
  81. }
  82. ```
  83. </details>
  84. <details>
  85. <summary><b>Cursor</b></summary>
  86. Go to **Files > Preferences > Cursor Settings > MCP**, then add:
  87. ```json
  88. {
  89. "mcpServers": {
  90. "mem-mcp": {
  91. "command": "uvx",
  92. "args": [
  93. "--from",
  94. "git+https://github.com/memovai/memov.git",
  95. "mem-mcp-launcher",
  96. "stdio",
  97. "${workspaceFolder}"
  98. ]
  99. }
  100. }
  101. }
  102. ```
  103. </details>
  104. <details>
  105. <summary><b>Antigravity</b></summary>
  106. > **Note:** Antigravity does not support `"${workspaceFolder}"` variable. Please manually enter the absolute path to your project directory.
  107. Go to **Settings > MCP**, then add:
  108. ```json
  109. {
  110. "mcpServers": {
  111. "mem-mcp": {
  112. "command": "uvx",
  113. "args": [
  114. "--from",
  115. "git+https://github.com/memovai/memov.git",
  116. "mem-mcp-launcher",
  117. "stdio",
  118. "/absolute/path/to/your/project"
  119. ]
  120. }
  121. }
  122. }
  123. ```
  124. 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).
  125. </details>
  126. <details>
  127. <summary><b>With VectorDB (RAG mode)</b> 🚧 WIP</summary>
  128. To enable semantic search, validation, and debugging tools, install with `[rag]` extras:
  129. **Claude Code:**
  130. ```bash
  131. claude mcp add mem-mcp --scope project -- uvx --from "git+https://github.com/memovai/memov.git[rag]" mem-mcp-launcher stdio $(pwd)
  132. ```
  133. **VS Code / Cursor:** Change the `--from` argument to:
  134. ```
  135. "git+https://github.com/memovai/memov.git[rag]"
  136. ```
  137. </details>
  138. ### Important Tips
  139. **Add a Rule** — To automatically save snapshots after each interaction, add a rule to your coding agents:
  140. - **Cursor**: Cursor Settings > Rules
  141. - **Claude Code**: `CLAUDE.md`
  142. - Or the equivalent in your MCP client
  143. Example rule:
  144. ```
  145. After completing any interaction, always call `use mem snap` to save the snapshot.
  146. ```
  147. ## Web UI, Just Say Use mem ui🤌
  148. 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.
  149. ## CLI Installation (Optional)
  150. If you want to use the `mem` CLI tool directly (for manual tracking, history viewing, etc.):
  151. ### One-Line Install
  152. ```bash
  153. curl -fsSL https://raw.githubusercontent.com/memovai/memov/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 213 on GitHub
  154. ```
  155. Or with wget:
  156. ```bash
  157. wget -qO- https://raw.githubusercontent.com/memovai/memov/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 219 on GitHub
  158. ```
  159. ### Package Managers
  160. <details>
  161. <summary><b>Homebrew (macOS/Linux)</b></summary>
  162. ```bash
  163. brew tap memovai/mem
  164. brew install memov
  165. ```
  166. </details>
  167. <details>
  168. <summary><b>APT (Debian/Ubuntu)</b></summary>
  169. ```bash
  170. echo "deb [trusted=yes] https://memovai.github.io/memov/apt stable main" | sudo tee /etc/apt/sources.list.d/mem.list
  171. sudo apt update
  172. sudo apt install mem
  173. ```
  174. </details>
  175. <details>
  176. <summary><b>YUM/DNF (Fedora/RHEL/CentOS)</b></summary>
  177. ```bash
  178. sudo curl -o /etc/yum.repos.d/mem.repo https://memovai.github.io/memov/yum/mem.repo
  179. sudo dnf install mem
  180. ```
  181. </details>
  182. <details>
  183. <summary><b>Direct Download</b></summary>
  184. Download the latest release for your platform:
  185. | Platform | Download |
  186. |----------|----------|
  187. | Linux x86_64 | [mem-linux-x86_64.tar.gz](https://github.com/memovai/memov/releases/latest/download/mem-linux-x86_64.tar.gz) |
  188. | macOS Intel | [mem-macos-x86_64.tar.gz](https://github.com/memovai/memov/releases/latest/download/mem-macos-x86_64.tar.gz) |
  189. | macOS Apple Silicon | [mem-macos-arm64.tar.gz](https://github.com/memovai/memov/releases/latest/download/mem-macos-arm64.tar.gz) |
  190. | Windows x86_64 | [mem-windows-x86_64.exe.zip](https://github.com/memovai/memov/releases/latest/download/mem-windows-x86_64.exe.zip) |
  191. **Linux / macOS:**
  192. ```bash
  193. curl -LO https://github.com/memovai/memov/releases/latest/download/mem-linux-x86_64.tar.gz
  194. tar -xzf mem-linux-x86_64.tar.gz
  195. sudo mv mem-linux-x86_64 /usr/local/bin/mem
  196. mem --help
  197. ```
  198. **Windows (PowerShell):**
  199. ```powershell
  200. Invoke-WebRequest -Uri "https://github.com/memovai/memov/releases/latest/download/mem-windows-x86_64.exe.zip" -OutFile "mem.zip"
  201. Expand-Archive -Path "mem.zip" -DestinationPath "."
  202. New-Item -ItemType Directory -Force -Path "$env:ProgramFiles\mem"
  203. Move-Item -Path "mem-windows-x86_64.exe" -Destination "$env:ProgramFiles\mem\mem.exe"
  204. [Environment]::SetEnvironmentVariable("Path", $env:Path + ";$env:ProgramFiles\mem", "Machine")
  205. mem --help
  206. ```
  207. </details>
  208. <details>
  209. <summary><b>From Source</b></summary>
  210. Requires Python 3.10+ and [uv](https://github.com/astral-sh/uv):
  211. ```bash
  212. git clone https://github.com/memovai/memov.git
  213. cd memov
  214. uv sync
  215. uv pip install -e .
  216. mem --help
  217. ```
  218. </details>
  219. ## Installation for Contributors
  220. Please see [docs/installation_for_dev.md](docs/installation_for_dev.md) for detailed installation instructions.
  221. ## Architecture
  222. 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.
  223. ![MemoV Architecture](docs/images/Arc.png)
  224. <details>
  225. <summary><b>MCP Tools</b></summary>
  226. ### Core Operations
  227. - `snap(user_prompt: str, original_response: str, agent_plan: list[str], files_changed: str)`
  228. - Record every user interaction with automatic file tracking. Handles untracked vs modified files intelligently.
  229. - `mem_ui(port: int = 38888)`
  230. - Launch the Web UI at `http://localhost:38888` to visually browse history, view diffs, and jump to any snapshot.
  231. - `mem_history(limit: int = 20, commit_hash: str = "")`
  232. - View memov history with prompts, responses, and file changes.
  233. - `mem_jump(commit_hash: str)`
  234. - Jump to a specific snapshot, restoring all tracked files and creating a new branch.
  235. ### RAG Tools (requires `[rag]` extras)
  236. These tools are only available when installed with `[rag]` extras.
  237. - `mem_sync()`
  238. - Sync all pending operations to VectorDB for semantic search capabilities.
  239. - `validate_commit(commit_hash: str, detailed: bool = True)`
  240. - Validate a specific commit by comparing prompt/response with actual code changes. Detects context drift and alignment issues.
  241. - `validate_recent(n: int = 5)`
  242. - Validate the N most recent commits for alignment patterns. Useful for session reviews and quality assurance.
  243. - `vibe_debug(query: str, error_message: str = "", stack_trace: str = "", user_logs: str = "", models: str = "", n_results: int = 5)`
  244. - 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.
  245. - `vibe_search(query: str, n_results: int = 5, content_type: str = "")`
  246. - Fast semantic search through code history (prompts, responses, agent plans, code changes) without LLM analysis. Perfect for quick context lookup.
  247. ### Health Check
  248. - `GET /health`
  249. - Returns "OK". Useful for IDE/agent readiness checks.
  250. </details>
  251. ## License
  252. MIT License. See `LICENSE`.
skills/vibegit/install.sh · Bundled script · 17 lines · 1 finding marked
  1. #!/bin/bash
  2. # Install memov CLI
  3. # Delegates to the official installation script
  4. set -e
  5. echo "Installing memov..."
  6. # Check if already installed
  7. if command -v mem &> /dev/null; then
  8. echo "memov is already installed!"
  9. mem 2>/dev/null || true
  10. exit 0
  11. fi
  12. # Use official install script
  13. curl -fsSL https://raw.githubusercontent.com/memovai/memov/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 17 on GitHub
skills/vibegit/scripts/_check_deps.sh · Bundled script · 17 lines · 1 finding marked
  1. #!/bin/bash
  2. # Shared dependency check for VibeGit scripts
  3. check_memov() {
  4. if ! command -v mem &> /dev/null; then
  5. echo "Error: memov CLI not found"
  6. echo ""
  7. echo "Install with:"
  8. echo " curl -fsSL https://raw.githubusercontent.com/memovai/memov/main/install.sh | bash"
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 9 on GitHub
  9. echo ""
  10. echo "Or alternatives:"
  11. echo " uvx memov # Run without install"
  12. echo " pip install memov # Global install"
  13. echo " pipx install memov # Isolated install"
  14. exit 1
  15. fi
  16. }

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.