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

code
.mem/memov.git

repository separate from standard Git.

Three-Layer Design

Diagram Preview
Click anywhere on the diagram to open interactive canvas

Interface Layer - CLI, Web UI, MCP clients
Core Management -
```
code
MemovManager
```
(central orchestrator),
```
code
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 code `snap` tool
Context-Aware Debugging	Isolates faulty interactions and enables testing with different LLM providers
Team Context Sharing	The code `.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

code
MemMCPTools

class translates Model Context Protocol invocations into

code
MemovManager

method calls, enabling transparent integration with Claude, VS Code, and Cursor.

Diagram Preview
Click anywhere on the diagram to open interactive canvas

File Classification

MemoV distinguishes between three types of file changes:

Type	Description	Attribution
Untracked files	New files not yet tracked	Require code `track()`
Manual edits	Modified but not in declared code `files_changed`	code `by_user=True`
AI modifications	Modified and in code `files_changed`	code `by_user=False`

This enables accurate attribution and prevents misclassification of code provenance.

Separation from Git

MemoV maintains complete independence from standard Git:

No
```
code
.git/
```
modification or pollution
Manual commits control production history
MemoV tracks conversational context at per-interaction granularity
Both timelines coexist without interference

Diagram Preview
Click anywhere on the diagram to open interactive canvas

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