context-kit

Token-economics-aware context management. Everything a stateless session reads costs tokens, and a session that reads whole files to answer a narrow question burns its budget before it starts work. context-kit makes reading cheap and deliberate.

It ships index-first reading tools that surface a file’s shape before its body, a session-start hook that assembles a compact orienting brief, an always-loaded meter with a committed baseline, a gate over the density of the densest always-loaded section, and a memory-off gate pair that keeps the harness’s ungoverned per-session memory surface disabled — the doctrine and both gates are defined in the kit’s SPEC.md.

Install

The steps are the kit README’s Install section. checkwright init does them for you — see the install page.

Quick start

Run these arms as the kit README spells them, PowerShell included:

gates="${GATE_SDK_NATIVE_BIN:-./scripts/checkwright-gates}"
"$gates" --emit md-index <file.md>   # outline before body
gates="${GATE_SDK_NATIVE_BIN:-./scripts/checkwright-gates}"
"$gates" --emit pub-index <component>/src/   # public API surface

Contracts

The reading-tool contracts and the always-loaded budget are defined in the kit’s SPEC.md, including the consumer footprint it holds — what the kits ask your always-loaded surface to carry, worth reading before you vendor. Its README.md lists the mechanism. Back to the kit map.