Architecture
MemoV is a Git-powered version control layer designed specifically for AI-assisted development. It captures three bound elements of each interaction: user prompts, agent plans, and code changes, storing them together in a shadow .mem/memov.git repository separate from standard Git.
Three-Layer Design
- Interface Layer - CLI, Web UI, MCP clients
- Core Management -
MemovManager(central orchestrator),GitManager(subprocess-based Git operations) - Storage - Bare Git repository with JSON metadata
Six Core Features
| Feature | Description |
|---|---|
| Context-Bound Memory | Automatically captures prompts, plans, and code changes as atomic units via the snap tool |
| Context-Aware Debugging | Isolates faulty interactions and enables testing with different LLM providers |
| Team Context Sharing | The .mem/memov.git bare repository can be pushed/pulled like standard Git |
| Change Reuse | Query past commits by description to reapply proven solutions without regeneration |
| Loop Guard | Detects infinite agent loops through pattern analysis of recent commits |
| History-Driven Optimization | Uses past interactions as training corpus to improve future generation quality |
MCP Integration
The MemMCPTools class translates Model Context Protocol invocations into MemovManager method calls, enabling transparent integration with Claude, VS Code, and Cursor.
File Classification
MemoV distinguishes between three types of file changes:
| Type | Description | Attribution |
|---|---|---|
| Untracked files | New files not yet tracked | Require track() |
| Manual edits | Modified but not in declared files_changed | by_user=True |
| AI modifications | Modified and in files_changed | by_user=False |
This enables accurate attribution and prevents misclassification of code provenance.
Separation from Git
MemoV maintains complete independence from standard Git:
- No
.git/modification or pollution - Manual commits control production history
- MemoV tracks conversational context at per-interaction granularity
- Both timelines coexist without interference
Technology Stack
Core Dependencies
| Package | Purpose |
|---|---|
| FastMCP | Model Context Protocol |
| FastAPI | Web framework |
| Typer | CLI framework |
| Git CLI | Subprocess-based operations |
Optional RAG Features
| Package | Purpose |
|---|---|
| ChromaDB | Vector storage |
| sentence-transformers | Embeddings |
| LiteLLM | Multi-model LLM support |
Supported Python Versions: 3.11 - 3.13