tm-ai 1.8.4

Time Machine for AI Agents — Cognitive Version Control for LLM context

🧠 CVC — Cognitive Version Control

Time Machine for AI Agents

Git for code. CVC for context.
Save. Branch. Rewind. Merge. — Your AI agent just got an undo button.

# 🎧 macOS / Linux / WSL
curl -fsSL https://jaimeena.com/cvc/install.sh | bash

# 🪟 Windows PowerShell
irm https://jaimeena.com/cvc/install.ps1 | iex

🔒 PRIVATE REPOSITORY — This project is proprietary and confidential.
Do not share, distribute, or publicize any code, documentation, or assets without explicit authorization.

Why CVC?	Features	Quick Start	Docs	Architecture
Integrations	Community	Development	Roadmap	FAQ
🔒 Private Repository — Internal Use Only

---

💥 The Problem

Your AI coding agent is brilliant — for about 20 minutes.

Then it forgets what it already fixed, contradicts its own plan,
and loops on the same error for eternity.

Sound familiar?

😵‍💫 Context Rot After 60% context fill, quality falls off a cliff

🔁 Error Loops Same mistake, different turn

🧠 No Memory Can't remember what it just did

💸 Token Waste Re-processing the same context

Bigger context windows don't fix this.

They just give the problem more room to spread.

✨ The Solution: CVC

Give AI agents what they've never had: memory that actually works.

---

🎯 Why CVC?

CVC is Git for the AI's brain.
Instead of versioning source code, it versions the agent's entire cognitive state — every thought, every decision, every conversation turn — as an immutable, cryptographic Merkle DAG.

💾 Save	🌿 Branch	⏪ Rewind	🔀 Merge	🔍 Search
Checkpoint the agent's brain at any stable moment	Explore risky ideas in isolation without polluting main context	Stuck in a loop? Time-travel back instantly	Merge learnings back — semantic, not syntactic	Find when the agent solved similar problems before

📊 Research-Backed Results

58.1% Context reduction via branching ContextBranch paper →

3.5× Success rate improvement with rollback GCC paper →

~90% Cost reduction through prompt caching Caching study →

~85% Latency reduction on restores Anthropic docs →

---

🚀 Features

🤖 Built-in Agent	🔌 Universal Proxy	⏱️ Time Machine
Just type cvc for a powerful AI coding assistant with 17 built-in tools and 5-provider support	Run any AI tool through CVC's time machine via API proxy or MCP server Zero configuration required	Auto-checkpoint every N turns Never lose context Crash recovery built-in Time-travel to any point --no-think for faster responses

🆚 How CVC Compares

FEATURE	CLAUDE CODE / CODEX	ANTIGRAVITY / CURSOR / VS CODE	🔥 CVC AGENT
Context Memory	Linear (Lost on restart)	Session-based / Linear	✅ Time-Travel (Project Isolated)
Branching	No branching / rollback	Not supported	✅ Full Branch Support
Undo Capability	Single step (maybe)	Single step / Ctrl+Z	✅ Instant Rewind (Any State)
Search History	Current session only	Current session only	✅ Global Semantic Search
Providers	Single provider (usually)	Vendor locked often	✅ Agnostic (5+ Providers)
Cost	Full Re-prompting	Full Re-prompting	✅ ~90% Cheaper (Cached)
Local / Offline	Cloud Dependent	Cloud Dependent	✅ 100% Local / Offline Capable
Context Merging	Not available	Not available	✅ Semantic Merge
Image Analysis	Limited	Limited	✅ Built-in Vision
Auto-checkpoint	Not available	Not available	✅ Configurable
Crash Recovery	Session lost	Session lost	✅ Full Restoration

---

⚡ Quick Start

Installation

🎯 Recommended: One-Line Installer (Installs Python if needed)

# 🎧 macOS / Linux / WSL
curl -fsSL https://jaimeena.com/cvc/install.sh | bash

# 🪟 Windows PowerShell
irm https://jaimeena.com/cvc/install.ps1 | iex

📦 Alternative: pip / uv

# pip (all providers)
pip install "tm-ai[all]"

# uv (faster, recommended)
uv tool install "tm-ai[all]"

# Specific provider only
pip install "tm-ai[anthropic]"   # Claude
pip install "tm-ai[openai]"      # GPT
pip install "tm-ai[google]"      # Gemini

Usage

# 🤖 Agent Mode - Just type 'cvc'
cvc

# 🔌 Proxy Mode - Zero-config launch
cvc launch claude          # Claude Code CLI
cvc launch aider           # Aider
cvc launch cursor          # Cursor IDE

# Or manual setup
cvc up                     # Setup + init + serve

Set API Keys

# Environment variables
export ANTHROPIC_API_KEY="sk-ant-..."
export OPENAI_API_KEY="sk-..."
export GOOGLE_API_KEY="AIza..."

# Or interactive setup
cvc setup

That''s it! 🎉

---

📖 Documentation

🤖 Agent CLI Guide Complete guide to the built-in agent	⌨️ Slash Commands All slash commands reference	🔧 Tools Reference 17 built-in tools documentation	🔌 MCP Integration Model Context Protocol setup
🗺️ Cross-Mode Guide Agent + Proxy + MCP workflows	📁 Multi-Workspace Multiple project management	📚 Full Docs Complete documentation	📝 Changelog Version history
🌐 Official Website Full docs, installation guides, examples & more at jaimeena.com/cvc

---

🔌 Integrations

Run ANY AI tool through CVC''s Time Machine

Tool	How to Connect	Command
💎 Claude Code CLI	export ANTHROPIC_BASE_URL=http://127.0.0.1:8000	cvc launch claude
🛠️ Aider	Standard OpenAI-compatible endpoint	cvc launch aider
⌨️ Codex CLI	model_provider = "cvc" in config	cvc launch codex
🖱️ Cursor	Settings → Override Base URL	cvc launch cursor
💎 VS Code + Copilot	BYOK or MCP integration	cvc launch code
🏄 Windsurf	MCP integration	cvc launch windsurf
🚀 Antigravity	MCP integration	cvc mcp
🔄 Continue.dev	Base URL → http://127.0.0.1:8000/v1	cvc serve
🤖 Cline	Base URL → http://127.0.0.1:8000/v1	cvc serve
🦜 LangChain	Use CVC''s function-calling tools	cvc serve
👥 CrewAI	Use CVC''s function-calling tools	cvc serve
🤝 AutoGen	Use CVC''s function-calling tools	cvc serve
🌐 Open WebUI	Standard OpenAI-compatible endpoint	cvc serve

🔑 Auth pass-through: External tools can send their own API keys — CVC forwards them to the upstream provider.

Run cvc connect for interactive setup instructions.

---

🗝️ Architecture

Three-Tiered Local Storage

🗄️ SQLite Commit graph Branch pointers Metadata Fast traversal, zero-config

📦 CAS Blobs Context snapshots Zstandard compression Content-addressable Deduplicated, efficient

🔍 Chroma Semantic embeddings Vector search Optional "Have I solved this before?"

✨ Everything stays in .cvc/ inside your project
🔒 No cloud • No telemetry • Your agent''s thoughts are yours

📦 Project Structure

cvc/
├── agent/          # Built-in AI coding agent
│   ├── chat.py     # REPL loop, slash commands
│   ├── llm.py      # Unified LLM client (4 providers)
│   ├── tools.py    # 17 tool definitions
│   └── executor.py # Tool execution engine
├── adapters/       # Provider-specific formatting
│   ├── anthropic.py # Prompt caching support
│   ├── openai.py
│   ├── google.py
│   └── ollama.py
├── core/           # Data layer
│   ├── models.py   # Merkle DAG, Pydantic schemas
│   └── database.py # SQLite + CAS + Chroma
├── operations/     # CVC engine
│   ├── engine.py   # Commit, branch, merge, restore
│   └── state_machine.py # LangGraph routing
└── vcs/            # Git bridge
    └── bridge.py   # Shadow branches, Git notes, hooks

---

🤖 Supported Providers

Provider	Default Model	Alternatives	Notes
🟣 Anthropic	claude-opus-4-6	claude-opus-4-5, claude-sonnet-4-5, claude-haiku-4-5	Prompt caching
🟢 OpenAI	gpt-5.2	gpt-5.2-codex, gpt-5-mini, gpt-4.1	Auto prefix caching
🔵 Google	gemini-3.1-pro-preview	gemini-3-pro-preview, gemini-3-flash-preview	Multimodal + reasoning
⚪ Ollama	qwen2.5-coder:7b	qwen3-coder:30b, devstral:24b, deepseek-r1:8b	100% local, no API key
🟤 LM Studio	qwen2.5-coder-32b-instruct	devstral-small-2505, deepseek-r1-distill-qwen-32b, gemma-3-27b-it	100% local, OpenAI-compat

---

💬 Internal Communication

For authorized team members only

🛠 Issues Report bugs via private repo issues

💡 Internal Discussions Use private repo discussions or team channels

---

🛠️ Development

This is a private repository. Access is restricted to authorized team members.

All contributions must go through internal code review.

Branch → Commit → Push → Internal PR

🛠️ Dev Setup

# Clone via authenticated access only
cd CVC
uv sync --extra dev

---

🗺️ Roadmap

Feature	Status
🤖 Built-in Agent CLI	✅ Shipped v1.6.2 — 17 tools, 5 providers, --no-think
☁️ All 5 Provider Adapters	✅ Shipped — Anthropic, OpenAI, Google, Ollama, LM Studio
🔌 MCP Server	✅ Shipped — stdio + SSE transports
🚀 Zero-config Launch	✅ Shipped — cvc launch for all tools
🔗 Git Bridge	✅ Shipped — Shadow branches, hooks, notes
🎨 VS Code Extension	📜 Q2 2026 — Visual commit graph, time-travel
🌐 Web UI	📜 Q2 2026 — Browser visualization & management
👥 Multi-agent support	📜 Q3 2026 — Shared DB with conflict resolution
☁️ Cloud sync	📜 Q3 2026 — S3/MinIO for teams
📊 Metrics dashboard	📜 Q4 2026 — Cache hits, context utilization, analytics

---

❓ FAQ

What is CVC?

CVC (Cognitive Version Control) is Git for AI agent context. It versions the agent''s entire cognitive state as an immutable Merkle DAG, enabling time-travel, branching, and merging for AI conversations.

How is CVC different from Claude Code or Cursor?

CVC adds: ⏪ Time-travel • 🌿 Branching • 🔍 Semantic search • 🔀 Context merging • 💾 Auto-checkpoint • 🔄 Crash recovery • 🤖 Multi-provider support (5 vs 1)

Does CVC work with my existing AI tools?

Yes! CVC works in two modes:

1. Agent mode — built-in AI assistant
2. Proxy mode — transparent proxy for Claude Code, Aider, Cursor, VS Code, Windsurf, Continue, Cline, LangChain, CrewAI, AutoGen, and more

Is my data sent to the cloud?

No. Everything stays local in .cvc/. CVC has:
🔒 No telemetry • 🔒 No cloud sync • 🔒 No data collection
Your agent''s thoughts are yours.

How much does it cost?

CVC is proprietary software. You only pay for LLM API calls (Anthropic/OpenAI/Google), and CVC makes them ~90% cheaper via prompt caching and 58.1% less context via branching.

Can I use CVC offline?

Yes! Use Ollama with local models like qwen2.5-coder:7b, deepseek-r1:8b, etc. 100% local, no API key needed.

What providers are supported?

• 🟣 Anthropic (Claude Opus 4.6, Sonnet 4.5, Haiku 4.5)
• 🟢 OpenAI (GPT-5.2, GPT-5.2-Codex, GPT-5-mini)
• 🔵 Google (Gemini 3 Pro/Flash Preview, Gemini 2.5 Pro/Flash — with thinking level control)
• ⚪ Ollama (Qwen, DeepSeek, Devstral, etc.)
• 🟤 LM Studio (any locally loaded model — OpenAI-compatible)

Is there a GUI?

Not yet! But coming soon:
🎨 VS Code extension (Q2 2026)
🌐 Web UI (Q2 2026)

For now, use the beautiful terminal UI with Rich formatting.

Can I use CVC in production?

Yes! CVC is production-ready (v1.6.2) with crash-resistant local storage, used by solo developers, teams, and enterprises.

---

📚 Research

CVC is grounded in published research

Paper	Key Finding
ContextBranch	58.1% context reduction via branching
GCC	11.7% → 40.7% success with rollback (3.5× improvement)
Merkle-CRDTs	Structural deduplication for content-addressable DAGs
Prompt Caching	Anthropic/OpenAI/Google token reuse patterns

---

📜 License

Proprietary — All rights reserved.

This project is private and confidential. Unauthorized distribution is prohibited.

---

✨ Because AI agents deserve an undo button ✨

Made with ❤️ by developers who got tired of AI agents forgetting what they just did.

---

🔒 Private & Confidential

---

_{Built with Python 🐍 • FastAPI ⚡ • SQLite 🗄️ • LangGraph 🦜 • Rich 🎨}