Contorium Runtime MCP

Camada de continuidade de runtime MCP para agentes de codificação de IA, fornecendo estado persistente do workspace e contexto de sessão entre ferramentas e execuções.

GitHub

Experimente este MCPPatrocinado

Documentação

Contorium

Camada de Inteligência de Projeto para desenvolvimento assistido por IA.

A IA consegue ler seu código.

Mas nem sempre sabe por que seu projeto se tornou o que é.

O Contorium dá às ferramentas de codificação com IA uma camada persistente de inteligência de projeto — preservando decisões, raciocínios, restrições, estrutura, histórico e o estado evolutivo do projeto entre sessões, ferramentas e modelos.

Não é histórico de chat. Não são prompts. É inteligência de projeto.

Website · Documentação · Visão Geral · Evolução e Recuperação de Decisões

O Git lembra o que mudou.
O Contorium lembra por quê.

Por que Contorium?

Agentes de codificação com IA estão cada vez melhores em escrever e modificar código.

Mas projetos de longa duração têm outro problema:

O código contém o que o projeto é — mas nem sempre por que se tornou assim.

Conhecimento importante se perde entre:

sessões de IA
diferentes ferramentas de codificação
trocas de modelos
experimentos e abordagens que falharam
decisões arquiteturais
ciclos longos de desenvolvimento

Eventualmente, desenvolvedores acabam explicando o mesmo projeto para a IA repetidamente.

Você deveria estar construindo o projeto — não explicando-o repetidamente.

O que é Inteligência de Projeto?

Um projeto é mais do que seus arquivos.

Ele tem:

Intent
  ↓
Decisions
  ↓
Reasoning
  ↓
Implementation
  ↓
Outcomes
  ↓
Evolution
  ↓
Current State

O Contorium preserva e conecta essas informações para que ferramentas de IA possam trabalhar a partir do entendimento acumulado do projeto, em vez de reconstruí-lo do zero a cada sessão.

A Inteligência de Projeto inclui

Decisões
O que foi escolhido, rejeitado ou alterado?

Raciocínio
Por que uma abordagem específica foi adotada?

Restrições
O que deve permanecer verdadeiro, e por quê?

Estrutura
Como os módulos, arquivos e funções do projeto estão conectados?

Histórico
Como o projeto evoluiu?

Estado Atual
O que importa agora, e o que deve acontecer em seguida?

Um Projeto. Uma Camada de Inteligência. Todas as Ferramentas de IA.

Suas ferramentas de IA podem mudar.

O entendimento acumulado do seu projeto não deveria precisar mudar.

                 Your Project
                      │
                      ▼
          ┌──────────────────────┐
          │      Contorium       │
          │                      │
          │ Project Intelligence │
          │        Layer         │
          └──────────┬───────────┘
                     │
          ┌──────────┼──────────┐
          ▼          ▼          ▼
       Cursor     Claude      Codex
          │        Code         │
          │          │          │
          └──────────┼──────────┘
                     ▼
             Shared Understanding

Use as ferramentas que preferir sem forçar cada uma a reconstruir o projeto do zero.

O Contorium atualmente integra-se com:

Cursor
Claude Code
Gemini CLI
Codex
VS Code
Ferramentas de IA compatíveis com MCP

O que o Contorium Realmente Faz

1. Entendimento Persistente do Projeto

Mantenha a inteligência do projeto entre:

sessões
ferramentas
trocas de modelos
ciclos longos de desenvolvimento

O objetivo não é lembrar de tudo.

O objetivo é preservar o que importa.

2. Grafo de Conhecimento do Projeto

O Contorium constrói relações estruturadas em todo o projeto:

Intent
  ↓
Module
  ↓
File
  ↓
Function
  ↓
Dependency

Em vez de tratar um repositório como uma coleção de arquivos desconectados, o Contorium constrói uma representação consultável de como o projeto se encaixa.

3. Histórico do Projeto

Entenda como o projeto evoluiu.

Acompanhe as mudanças que importam e conecte-as ao estado mais amplo do projeto.

4. Decisão e Raciocínio

Preserve o conhecimento que normalmente se perde após uma conversa terminar:

o que foi decidido
quais alternativas foram consideradas
por que uma abordagem foi escolhida
o que aconteceu depois

Isso ajuda futuras sessões de IA a entender não apenas o que existe, mas por quê.

5. Validade das Decisões

Projetos evoluem. Conhecimento fica desatualizado.

O Contorium rastreia se as decisões ainda são válidas:

Change → Assumption → Impact → Decision Validity

Os estados do ciclo de vida incluem:

VALID → WARNING → DECAYING → SUSPECTED_INVALID → NEEDS_REVALIDATION → INVALIDATED

Pergunte:

contorium ask "What decisions need review?"

6. Estado do Projeto Pronto para IA

Gere uma representação compacta do estado atual do projeto para transferência à IA.

Em vez de:

New session
    ↓
Read everything again
    ↓
Reconstruct context
    ↓
Start working

O Contorium permite:

New session
    ↓
Read project intelligence
    ↓
Understand current state
    ↓
Continue working

Pergunte ao Seu Projeto

O Contorium torna a inteligência do projeto acessível tanto para desenvolvedores quanto 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?"

O objetivo não é simplesmente recuperar texto.

É conectar as peças relevantes do conhecimento do projeto.

Como Funciona

Workspace Activity
        ↓
    Collection
        ↓
     Parsing
        ↓
 Project Structure
        ↓
 Knowledge Graph
        ↓
 Intent & State
        ↓
 Project Intelligence
        ↓
 AI-ready Context / Handoff
        ↓
 Any AI Tool

O Contorium armazena a inteligência do projeto localmente dentro de:

.contora/

O projeto carrega seu próprio entendimento acumulado, em vez de vinculá-lo a um provedor de IA ou sessão específica.

Arquitetura

O Contorium separa a inteligência do projeto da ferramenta de IA usando uma arquitetura local e estruturada.

AI Tools (Cursor · Claude · Codex · …)
    │
    ▼
IDE · MCP · CLI  (adapters)
    │
    ▼
CIL — Cognitive Interaction Layer
    │
    ▼
PIL — Project Intelligence Layer
    │
    ▼
.contora/

CIL — Camada de Interação Cognitiva

A CIL é a camada de interação entre agentes de IA, desenvolvedores e a inteligência do projeto.

Ela fornece os mecanismos necessários para consultar, capturar e transferir conhecimento do projeto.

É arquitetura — não a marca do produto.

PIL — Camada de Inteligência do Projeto

O armazenamento local determinístico da inteligência estruturada do projeto:

STATE · INTENT · DECISION · WHY
TIMELINE · IMPACT · PROVENANCE · CONFIDENCE

A PIL não raciocina. Ela preserva.

`.contora/`

A inteligência permanece com o projeto.

Local-first. Centrada no projeto. Portátil.

Guias mais detalhados: docs/OVERVIEW.md · docs/PIL_RUNTIME.md · docs/CIL.md

Três Operações Unificadas

Operação	Significado
Capturar	Registrar foco, notas, decisões
Inspecionar	Explorar estado, decisões, linha do tempo, saúde
Transferir	Exportar contexto compacto para uma nova sessão de IA

contorium capture decision
contorium inspect state
contorium transfer context
contorium ask "What is this project becoming?"

Não é Outro Sistema de Memória de IA

O Contorium está relacionado à memória de IA — mas não se destina a ser apenas mais um sistema de memória de chat ou recuperação.

Sistema	Preserva principalmente
Memória de Chat	Conversas
RAG	Informações recuperadas
Git	Código e histórico de arquivos
Arquivos de Contexto	Instruções explícitas
Contorium	Inteligência de projeto

O objetivo é conectar:

What changed
     ↓
Why it changed
     ↓
What happened
     ↓
What remains true
     ↓
What comes next

Memória é uma capacidade. Inteligência de Projeto é o objetivo.

O que o Contorium Não É

O Contorium não é:

um agente de codificação autônomo
um substituto para sua ferramenta de codificação com IA
um gerador de tarefas
um sistema que decide o que você deve construir
um substituto para o Git

O desenvolvedor permanece no controle.

O Contorium preserva o entendimento do projeto para que humanos e IA possam trabalhar a partir do mesmo estado em evolução.

Início Rápido

Requisitos

Node.js 18+
npm
VS Code / Cursor para a extensão do IDE
Uma ferramenta de IA compatível com MCP para integração MCP

Clonar e compilar

git clone https://github.com/ContoriumLabs/contorium.git
cd contorium

npm install
npm run compile

VS Code / Cursor

npm run vsix

Em seguida:

Abra Extensões
Selecione Instalar a partir do VSIX
Escolha o .vsix gerado
Recarregue a janela
Abra seu projeto
Defina o foco atual
Transfira o contexto do projeto pronto para IA quando necessário

Guia completo: docs/IDE_EXTENSION.md · docs/INSTALL.md

MCP

Exponha a inteligência do projeto a ferramentas de IA compatíveis com MCP:

npm install -g @contorium/mcp

claude mcp add --scope project contorium -- npx @contorium/mcp

codex mcp add contorium -- npx @contorium/mcp

Defina o workspace quando necessário:

CONTORIUM_WORKSPACE=/path/to/project

As operações preferidas dos agentes incluem:

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

Guia completo: 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 .

Guia completo: docs/CLI.md

Limpar Inteligência do Projeto

Para remover o armazenamento local de inteligência do projeto:

macOS / Linux

rm -rf .contora

Windows PowerShell

Remove-Item -Recurse -Force .contora

Princípios de Design

Centrado no projeto

O projeto é a fonte da verdade.

Persistente

O entendimento do projeto deve sobreviver a sessões, ferramentas e mudanças de modelo.

Estruturado

Relações entre decisões, código, intenção e histórico importam mais do que texto isolado.

Liderado por humanos

A IA pode entender o projeto. Humanos decidem o que o projeto se torna.

Local-first

A inteligência do projeto deve permanecer próxima ao projeto e continuar portátil.

Camada de IA Opcional

O Contorium funciona sem LLMs.

A IA opcional melhora explicação, narrativa, essência e perguntas sugeridas.

A IA é uma intérprete — não a fonte da verdade.

Veja docs/AI_LAYER.md.

Visão

A codificação com IA está indo além da geração de código de uso único em direção ao desenvolvimento multiagente de longa duração.

À medida que os agentes se tornam mais capazes, outra camada se torna cada vez mais importante:

a inteligência do próprio projeto.

O futuro do desenvolvimento assistido por IA pode não ser:

Human → AI → Code

mas sim:

                    Project Intelligence
                   ↙        ↓        ↘
               Agent A    Agent B    Agent C
                   ↘        ↓        ↙
                     Project

Modelos e ferramentas diferentes podem mudar.

O entendimento acumulado do projeto não deveria precisar mudar.

A IA pode escrever o código.
O Contorium ajuda a entender o projeto.

Links

Documentação: docs/README.md · Instalação · Visão Geral · Evolução e Recuperação de Decisões

Website: https://www.contorium.dev

GitHub: https://github.com/ContoriumLabs/contorium

Licença: MIT