CLI Reference

Initialize Delimit in your project. Detects OpenAPI specs, creates .delimit/ config, and sets default policies.

npx delimit-cli setup

Initialize a Delimit workspace with ledger and memory. Use this for cross-model continuity without API governance.

npx delimit-cli init

Zero-config PR safety gate: deterministic checks (breaking changes + leaked secrets) on staged or modified files. No init or setup required — run it on any repo. Use --record to write a content-pinned record of the check, the precursor to the signed, replayable Seal attestation.

npx delimit-cli check [--staged] [--base <ref>] [--fix] [--record [file]]

--base <ref>     Git ref to compare against (default HEAD)
--staged         Only check staged files
--fix            Show migration guidance for violations
--record [file]  Write a content-pinned record of this check (precursor to the signed Seal). Default .delimit/records/check-<ts>.json

Check an OpenAPI spec for breaking changes and policy violations. Compares against the last known version or a specified baseline.

npx delimit-cli lint <spec> [--policy <file>]

--policy <file>  Custom policy file
--strict         Treat all warnings as errors
--json           Output as JSON

Structural diff between two OpenAPI specs. Lists all additions, removals, and modifications with semver classification.

npx delimit-cli diff <old-spec> <new-spec>

--json           Output as JSON
--summary        One-line summary only

Enter governed thinking mode. Delimit loads your ledger, checks governance health, and helps you plan your next move.

delimit think

Enter governed build mode. Runs the full build loop: load context, execute tasks from the ledger, run tests, update state.

delimit build

Query Delimit about your project. Searches ledger, memory, and governance state to answer questions.

delimit ask "what's the status of auth?"

Diagnose your Delimit installation. Checks MCP server connectivity, ledger integrity, and policy configuration.

npx delimit-cli doctor

Try Delimit on a demo repository. Downloads a sample project with breaking changes and runs lint + diff to show the output.

npx delimit-cli try

Run an interactive demo of all Delimit capabilities. Walks through governance, ledger, and cross-model features.

npx delimit-cli demo

Gate any AI-assisted CLI with a signed attestation. Runs your wrapped command (claude -p, cursor, aider, codex, gemini, or any piped producer), snapshots the git diff before/after, runs lint + tests, HMAC-signs an att_xxx bundle, emits a replay URL. Advisory by default; --enforce blocks on policy violations; --max-time fires a kill switch and emits a liability_incident attestation with a cross-model handoff suggestion.

delimit wrap [--enforce] [--max-time <seconds>] [--no-attest] -- <command...>

--enforce              Block exit on policy violation (default: advisory)
--max-time <seconds>   Kill switch: SIGKILL after N seconds, emit liability_incident + handoff
--deliberate           Also run multi-model deliberation (advisory)
--no-attest            Skip attestation emission (dry run)
--json                 Output as JSON

Verify a Seal release receipt offline. Checks the receipt's Ed25519 signature, the signing constitution's own signature, and that the receipt is pinned to that published constitution. Prints which Layer-0 invariants were checked. Exit 0 = verified, 1 = verification failed, 2 = malformed input. No account, no network, no API key.

delimit seal-verify <receipt.json>

Render a directory of attestations into a public static trust page (HTML + JSON Feed 1.1). Single file, no framework, renders offline. Deploy the output anywhere. Shows signature-verify status per attestation.

delimit trust-page [-d <att-dir>] [-o <out-dir>] [-t <title>]

-d, --dir <path>       Attestation directory (default ~/.delimit/attestations)
-o, --out <path>       Output directory (default ./trust-page)
-t, --title <title>    Trust page title
--json                 Output result as JSON

Aggregate attestations into a CycloneDX 1.6 bill of materials with AI-specific fields. Captures detected model vendors, tool-call surface, and governance gate counts from the attestation ledger. Hand directly to enterprise procurement.

delimit ai-sbom [-d <att-dir>] [-o <file>] [-n <name>] [-v <ver>]

-d, --dir <path>       Attestation directory (default ~/.delimit/attestations)
-o, --out <path>       Output file (default ./ai-sbom.json)
-n, --name <name>      BOM subject name
-v, --package-version  BOM subject version
--json                 Print to stdout instead of writing to file