Documentation
Documentation
New here? Choose your path first: dctx is an advanced tool with several ways to use it. Evaluating dctx, or an AI doing so? Read the facts and how to verify them.
Every document is rendered from the repository at build time, with a Markdown twin next to it (index.md), and all of them are in llms-full.txt. The CLI reference is generated from the binary: /cli/.
Start
| Document | What it covers | Words | Updated | Source |
|---|---|---|---|---|
| Why dctx | Why dctx exists, its philosophy, and why byte-identical output keeps the prompt cache hitting. | 1,724 | docs/WHY-DCTX.md | |
| README | Installation, quick start, map mode, language tiers and the CLI reference. | 2,628 | README.md | |
| What dctx is | The claim and its limits, the advanced-user notice, choose your path, the safe path in ten minutes, responsibilities and the two scopes. | 1,655 | docs/START.md |
Modalities
| Document | What it covers | Words | Updated | Source |
|---|---|---|---|---|
| Choosing how to use dctx | Clipboard, grep plus reads, long sessions, huge trees, CLI usage and CI. | 1,735 | docs/MODALITIES.md | |
| Map mode guide | Every map verb with examples, budgets, ids and precision labels. | 2,694 | docs/guides/MAP-MODE.md | |
| Agent snippet | The AGENTS.md section that tells coding agents to ask dctx first. | 196 | docs/guides/AGENTS-SNIPPET.md | |
| Plugins guide | The plugin boundary, capabilities, consent and current limits. | 980 | docs/guides/PLUGINS.md |
Engine
| Document | What it covers | Words | Updated | Source |
|---|---|---|---|---|
| Specification | The core belief, the five constraints, the ten RAG defect classes, policy and roadmap. | 9,224 | docs/SPEC.md | |
| Privacy guarantees | Ignore semantics and the full sensitive-file deny list. | 2,817 | docs/ADR-014-Privacy-Guarantees-and-Ignore-Semantics.md | |
| Language coverage (ADR-018) | The three tiers and how a language enters one. | 516 | docs/ADR-018-Language-Coverage.md | |
| Template contract (DTS v2) | DTS source v2 and the compiled plan IR v1. | 648 | docs/design/contracts/DTS-v2.md | |
| Templating engine (ADR-003) | Markers, ahead-of-time compilation, the two rendering passes and the data variables. | 508 | docs/ADR-003-Templating-Engine.md | |
| Crate map | How the Rust workspace is organised. | 1,899 | docs/CRATE-MAP.md |
Reference
| Document | What it covers | Words | Updated | Source |
|---|---|---|---|---|
| CLI exit codes | The exit-code contract for map, pack and languages. | 929 | docs/CLI-EXIT-CODES.md |
Trust
| Document | What it covers | Words | Updated | Source |
|---|---|---|---|---|
| Measurement evidence | Grep plus file reads first; whole-session scope and secondary historical protocols. | 4,180 | docs/BENCHMARK-20261030.md | |
| Byte-stability report | Protocol, raw answers and limits of the 33/33 measurement. | 1,063 | docs/research/stability-20261105/REPORT.md | |
| Earlier two-way study | October 2026, before call edges: the benchmark that set the roadmap. | 7,229 | docs/research/trail-code-2026-10/REPORT.md | |
| Releasing | How a release is cut and checked. | 158 | RELEASING.md | |
| Contributing | How to propose changes, with a DCO sign-off. | 546 | CONTRIBUTING.md |
Policies
| Document | What it covers | Source | ||
|---|---|---|---|---|
| Security policy | How to report a vulnerability privately. | SECURITY.md | ||
| Trademark policy | Use of the dctx name and logo. | TRADEMARK.md | ||
| Maintenance | What a maintenance agreement covers. | MAINTENANCE.md |
Crawlers, including AI crawlers, may read this site: see robots.txt and llms.txt.