V3.1 · three peer adapters

Install & use

IDE, MCP, and CLI are peer Runtime Adapters over the same .contora/ directory — any adapter can bootstrap alone; combined use merges via source.mode: merged.

Documentation

Getting started

Per adapter

Quick start

# Build (repo root)
npm install && npm run compile

# IDE: npm run vsix → Install from VSIX

# MCP: set CONTORIUM_WORKSPACE, enable in host

# CLI (project root)
npx contorium init .
npx contorium sync .
npx contorium handoff .
npx contorium graph-snapshot .
npx contorium export .

Command matrix (V3.1)

Capability IDE MCP CLI
Bootstrap .contora/ Open folder Bootstrap on start contorium init
Refresh git / paths Auto scan 5s + events/git watch contorium sync
AI execution entry Copy includes handoff get_project_handoff contorium handoff
Cognitive summary # COGNITIVE SNAPSHOT get_project_graph_snapshot contorium graph-snapshot
Knowledge graph AI Cortex sidebar get_project_knowledge_graph contorium knowledge
Canonical export Copy AI-ready context — contorium export
Agent memory — store_memory —

Install links

IDE extension

MCP / CLI

Standalone vs combined

  • IDE only — sidebar, events, Copy AI-ready context (V3.1 canonical export)
  • MCP only — bootstrap + 18 tools; call get_project_handoff for execution entry
  • CLI only — init / sync / handoff / graph-snapshot / export for terminal and CI
  • Combined — merged mode; source.lastWriter tracks last writer; task/notes are not overwritten

Build from source

git clone https://github.com/ContoriumLabs/contorium.git
cd contorium
npm install
npm run compile

F5 for Extension Development Host. Package VSIX with npm run vsix. MCP build: npm run build:mcp.

Verify

  • .contora/state.json after init or opening a folder
  • IDE: set focus → AI Cortex shows Knowledge Graph / Hotspots
  • MCP: get_project_handoff or get_project_graph_snapshot
  • CLI: npx contorium status . shows mode and source metadata
  • init with created: false is normal when state already exists

On-disk layout (V3.1)

.contora/
├── state.json               # + source { mode, lastWriter, lastUpdated }
├── state-builder/           # L4 snapshot
├── graph/                   # V3.1 cognitive graph
│   ├── knowledge.json
│   ├── snapshot.json
│   └── hotspots.json
├── events/                  # IDE events
└── mcp/                     # store_memory (optional)

Shared workspace memory for every tool

Install Full guide (Markdown)