Install CVC, meet Sofia (your AI agent), and give your AI a time machine. Two commands. That's it.
From zero to time machine
curl -fsSL https://jaimeena.com/cvc/install.sh | bashInstalls Python 3.11+ via pyenv if needed, then installs CVC. Works on macOS 12+ and Ubuntu 20.04+.
cvcThe setup wizard guides you through provider selection and API key configuration. Takes about 30 seconds.
cvc gateway startThe Gateway is the most powerful way to use CVC — a unified web dashboard where you can chat with the agent, manage all subsystems (Proxy, MCP, Hive Mind, Swarm), browse your timeline, configure models, and monitor everything in real time. One command opens it all.
User: Help me build an Express API with auth
Sofia: [designs and builds the API]
/commit "API with auth complete" ← Save the AI's brain
/branch "risky-refactor" ← Try something new
/restore abc1234 ← Go back if it fails
/log ← See full historyYour AI agent with a time machine
Creates step-by-step plans for complex tasks before writing code
Records corrections in lessons.md — never makes the same mistake twice
Runs tests and checks before declaring a task complete
7 sub-agents for Security, UI, Data, AI, and more
Configure your LLM provider
export ANTHROPIC_API_KEY=your-key-hereFour interfaces, one brain, one database
cvcFull AI coding assistant in your terminal. Sofia + 17 tools + 31 slash commands.
cvc gateway startThe interactive web dashboard — manage every CVC subsystem from one unified UI.
cvc launch claudeTransparent API proxy wrapping your existing tools. Claude Code, Aider, Codex.
cvc mcpModel Context Protocol server for VS Code + Copilot, Cursor, Windsurf.
Everything CVC offers — in one unified interface
The Gateway dashboard organizes every CVC feature into a clean sidebar. Chat with the agent, manage operations, browse your timeline, switch models, and configure settings — all without leaving the browser.
Browser-based agent chat with full versioning. Never forgets what you told it.
Visual Commit, Branch, Merge, Restore, Recall, and Diff — no terminal needed.
Visual catalog of 20+ models. Click to switch. Paste API keys directly.
Create agents from prompts, manage squads, 36+ templates. The singularity.
Full context window viewer — every message, tool call, and blob, color-coded.
Autopilot mode, trust mode, agent behavior, hooks, plugins, Git, audit logs.
Multi-agent singularity and programmatic access
All agents share one memory — no inter-agent conversation. Create agents from a prompt, manually, or from 36+ templates. Organize into squads. Scale to millions.
Use CVC directly in your Python code. Import HiveMind and Agent, register agents, commit, recall, and share to the hive — all programmatically.
from cvc.sdk import HiveMind, AgentYour quick reference for CVC
/commitSave a cognitive checkpoint/branchCreate an exploration branch/restoreRewind to any previous state/mergeCombine branch insights into main/logView full commit history/diffCompare two cognitive states/searchSemantic search across all sessions/recallFind what the AI decided before/compactIntelligently compress context/costShow token usage and $ spent/exportExport session as markdown/toolsList available agent tools/agentsList specialized sub-agents/providerSwitch LLM provider/modelSwitch model/helpQuick reference for all commands/doctorDiagnose system health/auditView compliance audit trail/statsSession and workspace statsCommon patterns for CVC power users
Never lose a stable state. Every risky idea gets its own isolated branch.
/commit "stable state"/branch risky-experiment...try risky approach.../restore <stable-commit> (if failed)/merge risky-experiment (if succeeded)Build a searchable knowledge base across all your AI sessions.
Work on feature → AI learns context/commit "feature complete"Next day: cvc → auto-restores session/search "auth pattern" → finds past solutionCut API costs by 90% with prompt caching and intelligent model switching.
/cost → check spending/compact → reduce context, save tokens/provider ollama → switch to free local model/model haiku → use cheaper model for simple tasksSame AI brain across CLI, VS Code, Cursor, Aider — zero context loss.
9 AM: cvc (CLI agent) → design architecture10 AM: cvc launch cursor → implement in IDE2 PM: cvc launch aider → refactor codeOne continuous conversation across all tools