Skip to content

ctxlake documentation

Zero-compute coordination for fleets of coding agents. Object storage is the only shared substrate — no server, no database, no broker.

New here? Start with getting-started.md. Debugging something? architecture.md is an operator's map of every component.

User guides

DocWhat it covers
getting-started.mdInstall, init, doctor, wire up a runtime, first briefing
adopting.md"I already use Claude Code, Cursor and Hermes — can I just start?"
import.mdBackfilling the history already on your disk, and its per-runtime fidelity
concepts.mdThe three planes and the one-write-pattern-per-plane rule
coordination.mdRoster, intents, leases — and what advisory leases do not promise
summarization.mdThe three tiers; why the default needs no LLM key; configuring one if you want it
memory.mdClaims, the four promotion gates, scopes, attribution, shadow mode
cli.mdCommand reference
config.mdctxlake.toml reference
mcp.mdThe MCP tool surface

Runtimes

DocWhat it covers
runtimes/claude-code.mdHook mapping, injection, blocking, coexistence
runtimes/cursor.mdhooks.json v1, event mapping, import fidelity
runtimes/hermes.mdThe Python plugin, event mapping, known gaps

Deployment and operations

DocWhat it covers
storage.mdS3, GCS, MinIO, R2, local — and the CAS capability matrix
layout.mdBucket layout reference
scaling.mdWhere this does not scale, with the cost arithmetic
security.mdRedaction, quarantine, prompt injection, IAM policy, threat model
troubleshooting.mdSymptom → what to check → why

Contributor internals

DocWhat it covers
architecture.mdComponent inventory, data flow, failure modes, what this does not guarantee
../AGENTS.mdWorking agreement and the invariants

AGPL-3.0-or-later, with commercial licenses available. Pre-alpha.