ContextCord

Engineering continuity and trustworthy context for Coding Agents.

中文 · Website · Quick start · Architecture · Host integration

ContextCord is a local-first continuity and trustworthy-context layer for Coding Agents. It persists engineering state outside individual chats, binds recovered context to repository and source identity, revalidates state when dependencies change, and exposes capability-scoped tools to agent hosts.

Get started

Install from a source checkout with Python 3.11+:

python -m pip install -e .

Run in your Git project, with at least one commit and an AGENTS.md policy file:

contextcord init --profile generic
contextcord doctor
contextcord feature profile continuity
contextcord handoff --assist

Handoff starts with a read-only preview. After closing the preceding session, confirm with contextcord handoff --assist --task-id <id> --yes to create one local session and archive its context packet. See the task walkthrough.

Related MCP server: tashevos

Six modules

One repository-local StateStore connects the modules. The code-derived surface has 12 runtime capabilities, 16 MCP tools and 10 typed decision categories. Generated inventory.

Handoff collects local candidates, ranks them with BM25, checks source freshness and authority, and reduces the eligible pool to at most 24 candidates. The default path selects up to three records locally. When explicitly enabled, Jev can rank an ambiguous pool; unavailable or invalid advice uses a recorded BM25 fallback. The resulting packet links source identity, archive references and its decision receipt. Stale records remain marked for revalidation.

Deterministic code owns permissions, integrity, execution controls, tests, destructive approval and release gates. Host permissions and OS isolation govern real execution. Security model.

Evaluation

The continuity replay measures exact state recovery and packet size across 60 task-spec-derived fixtures. The synthetic typed evaluation measures the typed decision contract. All table values can be recomputed from the included rows:

python evaluation/continuity/recompute.py --check
python evaluation/typed_decisions/recompute.py --check --replay

Evaluation method and artifacts.

Host integration and profiles

Ships adapter/config contracts for Codex, Cursor, Qoder, OpenCode and WorkBuddy; host qualification is tracked separately from integration support.

Use contextcord feature profile minimal, continuity, decision or full to select a capability set. MCP mutations require the explicit --allow-mutations server option. Jev is optional: install .[jev], enable the capability and configure credentials locally. Profiles and host setup.

Optional model routing and external Model Intelligence provide advisory route planning. Decision Plane.

Development and license

ContextCord 0.6.2a1 is an alpha release candidate. See CONTRIBUTING.md for verification commands. Distributed under Apache-2.0, with retained third-party notices and acknowledgements.