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

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

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