ContextCord MCP Server

ContextCord is a local-first continuity and decision layer for coding agents. It is not a chat-memory product: the repository remains the source of truth, old conclusions can be revalidated against current source, and the next session receives a bounded context packet instead of a transcript dump.

Quick start

git clone https://github.com/Yvniverse/contextcord.git
cd contextcord
python -m pip install -e .

contextcord init --profile generic
contextcord doctor
contextcord resume --assist

resume --assist starts with a read-only continuation preview. A new source-bound session is created only after confirmation.

Related MCP server: 3Notch

Six modules, one local truth layer

These are product modules, not six packages or databases. Internally, ContextCord uses one Capability Registry and one repository-local StateStore.

Use only what you need

contextcord feature profile minimal
contextcord feature profile continuity
contextcord feature profile decision
contextcord feature profile full

• minimal — core + evidence

• continuity — continuity, memory, handoff, MCP/hosts and closeout

• decision — deterministic decision, Adaptive Router and Model Intelligence

• full — all runtime capabilities, including Jev when installed/configured

• custom — explicit enable/disable combinations

Jev is intentionally separate from the default decision profile:

python -m pip install -e ".[jev]"
contextcord feature enable jev
contextcord provider jev status

Provider credentials stay local and are not written into public receipts.

How the pieces work together

Continuum ──→ Context Engine ──→ bounded continuation
   │               │
   └──────→ Veritas ───────────→ source-aware evidence
                   │
                   └────→ Decision Plane ──→ effective route
                                  │
                            optional Jev
                                  │
                                  ↓
                         MCP / Host Gateway
                                  │
                                  ↓
                         real host execution
                                  │
                                  ↓
                         verifier + local outcome

The modules are a responsibility view, not a rigid one-file/one-module partition. Shared capabilities may contribute to more than one product module without creating a second registry.

Host integrations

Built-in integration contracts are provided for Codex, Cursor, Qoder, OpenCode and WorkBuddy, with a versioned BYOH adapter path for other hosts. “Built-in” describes the shipped integration contract; live model qualification is recorded separately in the current Host Evidence Registry.

Adaptive Router

The Decision Plane can choose an eligible model × reasoning-effort × role route. Hard code-owned rules define what can execute; external Model Intelligence is advisory; Jev is called only when a bounded semantic choice is useful. Only real host execution plus verifier output can become Local Outcome evidence.

See Adaptive Router and Research boundaries.

Architecture

The Architecture Atlas includes six complementary interactive Archify views: system architecture, Adaptive Router, workflow, sequence, data flow and lifecycle. The site shows six categories for the active language while retaining both Chinese and English standalone viewers.

Security and local data

ContextCord is local-first. Project state, provider credentials, raw Model Intelligence payloads and private delivery evidence are not part of the public repository surface. Host permissions and the operating system remain authoritative for real execution.

See SECURITY.md.

Project status

ContextCord is Public Alpha. Continuity, evidence, capability and MCP contracts are the primary product surface. Adaptive routing, external Model Intelligence and outcome calibration remain experimental behind explicit capability boundaries.

Contributing

Issues, documentation, reproducible benchmark methodology and carefully scoped host integrations are welcome. Start with CONTRIBUTING.md and follow the Code of Conduct.

License & acknowledgements

ContextCord 0.6.2a1 Public Alpha is distributed under the MIT License. Third-party and generated assets remain subject to their own notices and licenses; see THIRD_PARTY_NOTICES.md and ACKNOWLEDGEMENTS.md. Architecture documentation uses Archify; optional Model Intelligence may consume attributed public observations from CodexRadar / DRadar as an advisory data source.