Contorium Runtime MCP
Capa de continuidad de ejecución MCP para agentes de codificación de IA, que proporciona estado persistente del espacio de trabajo y contexto de sesión entre herramientas y ejecuciones.
Documentación
Contorium
Capa de Inteligencia de Proyecto para el desarrollo asistido por IA.
La IA puede leer tu código.
Pero no siempre sabe por qué tu proyecto se convirtió en lo que es.
Contorium brinda a las herramientas de codificación con IA una capa persistente de inteligencia de proyecto: preservando decisiones, razonamientos, restricciones, estructura, historial y el estado evolutivo del proyecto a través de sesiones, herramientas y modelos.
No es historial de chat. No son indicaciones. Es inteligencia de proyecto.
Sitio web · Documentación · Descripción general · Evolución de Decisiones y Recuperación
Git recuerda qué cambió.
Contorium recuerda por qué.
¿Por qué Contorium?
Los agentes de codificación con IA son cada vez mejores escribiendo y modificando código.
Pero los proyectos de larga duración tienen otro problema:
El código contiene lo que el proyecto es, pero no siempre por qué se convirtió en eso.
El conocimiento importante se pierde entre:
- sesiones de IA
- diferentes herramientas de codificación
- cambios de modelo
- experimentos y enfoques fallidos
- decisiones arquitectónicas
- ciclos de desarrollo largos
Con el tiempo, los desarrolladores terminan explicando el mismo proyecto a la IA una y otra vez.
Deberías estar construyendo el proyecto, no explicándolo repetidamente.
¿Qué es la Inteligencia de Proyecto?
Un proyecto es más que sus archivos.
Tiene:
Intent
↓
Decisions
↓
Reasoning
↓
Implementation
↓
Outcomes
↓
Evolution
↓
Current State
Contorium preserva y conecta esta información para que las herramientas de IA puedan trabajar a partir del conocimiento acumulado del proyecto en lugar de reconstruirlo desde cero en cada sesión.
La Inteligencia de Proyecto incluye
Decisiones
¿Qué se eligió, se rechazó o se cambió?
Razonamiento
¿Por qué se adoptó un enfoque particular?
Restricciones
¿Qué debe seguir siendo cierto, y por qué?
Estructura
¿Cómo están conectados los módulos, archivos y funciones del proyecto?
Historial
¿Cómo evolucionó el proyecto?
Estado Actual
¿Qué importa ahora y qué debería suceder después?
Un Proyecto. Una Capa de Inteligencia. Cada Herramienta de IA.
Tus herramientas de IA pueden cambiar.
El conocimiento acumulado de tu proyecto no debería tener que hacerlo.
Your Project
│
▼
┌──────────────────────┐
│ Contorium │
│ │
│ Project Intelligence │
│ Layer │
└──────────┬───────────┘
│
┌──────────┼──────────┐
▼ ▼ ▼
Cursor Claude Codex
│ Code │
│ │ │
└──────────┼──────────┘
▼
Shared Understanding
Usa las herramientas que prefieras sin obligar a cada una a reconstruir el proyecto desde cero.
Contorium actualmente se integra con:
- Cursor
- Claude Code
- Gemini CLI
- Codex
- VS Code
- herramientas de IA compatibles con MCP
Qué Hace Realmente Contorium
1. Comprensión Persistente del Proyecto
Mantén la inteligencia del proyecto a través de:
- sesiones
- herramientas
- cambios de modelo
- ciclos de desarrollo largos
El objetivo no es recordarlo todo.
El objetivo es preservar lo que importa.
2. Grafo de Conocimiento del Proyecto
Contorium construye relaciones estructuradas a lo largo del proyecto:
Intent
↓
Module
↓
File
↓
Function
↓
Dependency
En lugar de tratar un repositorio como una colección de archivos desconectados, Contorium construye una representación consultable de cómo encaja el proyecto.
3. Historial del Proyecto
Comprende cómo evolucionó el proyecto.
Rastrea los cambios que importan y conéctalos con el estado general del proyecto.
4. Decisiones y Razonamiento
Preserva el conocimiento que normalmente se pierde cuando termina una conversación:
- qué se decidió
- qué alternativas se consideraron
- por qué se eligió un enfoque
- qué sucedió después
Esto ayuda a las futuras sesiones de IA a comprender no solo qué existe, sino por qué.
5. Validez de las Decisiones
Los proyectos evolucionan. El conocimiento se vuelve obsoleto.
Contorium rastrea si las decisiones siguen siendo válidas:
Change → Assumption → Impact → Decision Validity
Los estados del ciclo de vida incluyen:
VALID → WARNING → DECAYING → SUSPECTED_INVALID → NEEDS_REVALIDATION → INVALIDATED
Pregunta:
contorium ask "What decisions need review?"
6. Estado del Proyecto Listo para IA
Genera una representación compacta del estado actual del proyecto para la transferencia a IA.
En lugar de:
New session
↓
Read everything again
↓
Reconstruct context
↓
Start working
Contorium permite:
New session
↓
Read project intelligence
↓
Understand current state
↓
Continue working
Pregúntale a Tu Proyecto
Contorium hace que la inteligencia del proyecto sea accesible tanto para desarrolladores como para agentes de IA.
contorium ask "Why was MCP added?"
contorium ask "What changed recently?"
contorium ask "What do we know about authentication?"
contorium ask "Is this decision still valid?"
El objetivo no es simplemente recuperar texto.
Es conectar las piezas relevantes del conocimiento del proyecto.
Cómo Funciona
Workspace Activity
↓
Collection
↓
Parsing
↓
Project Structure
↓
Knowledge Graph
↓
Intent & State
↓
Project Intelligence
↓
AI-ready Context / Handoff
↓
Any AI Tool
Contorium almacena la inteligencia del proyecto localmente dentro de:
.contora/
El proyecto lleva su propio conocimiento acumulado en lugar de vincularlo a un proveedor de IA o sesión en particular.
Arquitectura
Contorium separa la inteligencia del proyecto de la herramienta de IA mediante una arquitectura local y estructurada.
AI Tools (Cursor · Claude · Codex · …)
│
▼
IDE · MCP · CLI (adapters)
│
▼
CIL — Cognitive Interaction Layer
│
▼
PIL — Project Intelligence Layer
│
▼
.contora/
CIL — Capa de Interacción Cognitiva
CIL es la capa de interacción entre agentes de IA, desarrolladores e inteligencia del proyecto.
Proporciona los mecanismos necesarios para consultar, capturar y transferir el conocimiento del proyecto.
Es arquitectura, no la marca del producto.
PIL — Capa de Inteligencia de Proyecto
El almacén local determinista de inteligencia de proyecto estructurada:
STATE · INTENT · DECISION · WHY
TIMELINE · IMPACT · PROVENANCE · CONFIDENCE
PIL no razona. Preserva.
.contora/
La inteligencia permanece con el proyecto.
Local primero. Centrado en el proyecto. Portátil.
Guías más detalladas: docs/OVERVIEW.md · docs/PIL_RUNTIME.md · docs/CIL.md
Tres Operaciones Unificadas
| Operación | Significado |
|---|---|
| Capturar | Registrar enfoque, notas, decisiones |
| Inspeccionar | Explorar estado, decisiones, cronología, salud |
| Transferir | Exportar contexto compacto a una nueva sesión de IA |
contorium capture decision
contorium inspect state
contorium transfer context
contorium ask "What is this project becoming?"
No Es Otro Sistema de Memoria de IA
Contorium está relacionado con la memoria de IA, pero no pretende ser solo otro sistema de memoria de chat o recuperación.
| Sistema | Preserva principalmente |
|---|---|
| Memoria de Chat | Conversaciones |
| RAG | Información recuperada |
| Git | Historial de código y archivos |
| Archivos de Contexto | Instrucciones explícitas |
| Contorium | Inteligencia de proyecto |
El objetivo es conectar:
What changed
↓
Why it changed
↓
What happened
↓
What remains true
↓
What comes next
La memoria es una capacidad. La Inteligencia de Proyecto es el objetivo.
Qué No Es Contorium
Contorium no es:
- un agente de codificación autónomo
- un reemplazo de tu herramienta de codificación con IA
- un generador de tareas
- un sistema que decide qué deberías construir
- un reemplazo de Git
El desarrollador sigue teniendo el control.
Contorium preserva la comprensión del proyecto para que humanos e IA puedan trabajar desde el mismo estado evolutivo.
Inicio Rápido
Requisitos
- Node.js 18+
- npm
- VS Code / Cursor para la extensión de IDE
- Una herramienta de IA compatible con MCP para la integración MCP
Clonar y compilar
git clone https://github.com/ContoriumLabs/contorium.git
cd contorium
npm install
npm run compile
VS Code / Cursor
npm run vsix
Luego:
- Abre Extensiones
- Selecciona Instalar desde VSIX
- Elige el
.vsixgenerado - Recarga la ventana
- Abre tu proyecto
- Establece el enfoque actual
- Transfiere el contexto del proyecto listo para IA cuando sea necesario
Guía completa: docs/IDE_EXTENSION.md · docs/INSTALL.md
MCP
Expón la inteligencia del proyecto a herramientas de IA compatibles con MCP:
npm install -g @contorium/mcp
claude mcp add --scope project contorium -- npx @contorium/mcp
codex mcp add contorium -- npx @contorium/mcp
Establece el espacio de trabajo cuando sea necesario:
CONTORIUM_WORKSPACE=/path/to/project
Las operaciones preferidas del agente incluyen:
ask_project
transfer_project
inspect_state · inspect_intent · inspect_decision
capture_focus · capture_note · capture_decision
inspect_pending_decisions · commit_decision
prepare_execution_context · get_project_context · explain_context
get_knowledge_health · get_review_queue
Guía completa: docs/MCP.md · packages/mcp/README.md
CLI
npx contorium init .
npx contorium sync .
npx contorium ask "What is this project?"
npx contorium decisions detect
npx contorium context build --task "…"
npx contorium inspect
npx contorium explain database
npx contorium transfer context
npx contorium lifecycle
npx contorium review
npx contorium status .
Guía completa: docs/CLI.md
Limpiar la Inteligencia del Proyecto
Para eliminar el almacén local de inteligencia del proyecto:
macOS / Linux
rm -rf .contora
Windows PowerShell
Remove-Item -Recurse -Force .contora
Principios de Diseño
Centrado en el proyecto
El proyecto es la fuente de verdad.
Persistente
La comprensión del proyecto debería sobrevivir a sesiones, herramientas y cambios de modelo.
Estructurado
Las relaciones entre decisiones, código, intención e historial importan más que el texto aislado.
Liderado por humanos
La IA puede comprender el proyecto. Los humanos deciden en qué se convierte el proyecto.
Local primero
La inteligencia del proyecto debería permanecer cerca del proyecto y seguir siendo portátil.
Capa de IA Opcional
Contorium funciona sin LLMs.
La IA opcional mejora la explicación, la narrativa, la esencia y las preguntas sugeridas.
La IA es un intérprete, no la fuente de verdad.
Consulta docs/AI_LAYER.md.
Visión
La codificación con IA está avanzando más allá de la generación de código de un solo uso hacia el desarrollo de múltiples agentes de larga duración.
A medida que los agentes se vuelven más capaces, otra capa se vuelve cada vez más importante:
la inteligencia propia del proyecto.
El futuro del desarrollo asistido por IA puede no ser:
Human → AI → Code
sino:
Project Intelligence
↙ ↓ ↘
Agent A Agent B Agent C
↘ ↓ ↙
Project
Diferentes modelos y herramientas pueden cambiar.
El conocimiento acumulado del proyecto no debería tener que hacerlo.
La IA puede escribir el código.
Contorium le ayuda a comprender el proyecto.
Enlaces
Documentación: docs/README.md · Instalación · Descripción general · Evolución de Decisiones y Recuperación
Sitio web: https://www.contorium.dev
GitHub: https://github.com/ContoriumLabs/contorium
Licencia: MIT