Package Exports
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (delimit-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
</> Delimit\n\nStop re-explaining your codebase every session. Memory, tasks, and governance that persist across Claude Code, Codex, Cursor, and Gemini CLI.\n\n
Think and Build
The universal command for the Delimit Swarm. When you say "Think and Build", your AI agents (Claude, Codex, Gemini, Cursor) automatically deploy a background autonomous build loop that monitors your ledger, deliberates on strategy, and implements code while you focus on the architecture.
- "Think": Trigger multi-model deliberation and strategic dispatch.
- "Build": Activate the background daemon to execute tasks and verify gates.
- "Vault": Manage local secrets and API keys (AES-256 encrypted).
Works across any configuration — from a single model on a budget to an enterprise swarm of 4+ models.
\n\n
\n
\n
\n
\n\n
\n
\n
bash\nnpx delimit-cli demo # See governance in action — no setup needed\nnpx delimit-cli init # Set up governance for your project\nnpx delimit-cli setup # Configure your AI assistants\n\n\nNo API keys. No account. No config files.\n\n### Pick your first win\n\nProtect my API — catch breaking changes before merge:\nbash\nnpx delimit-cli try\n# Creates a sample API, introduces breaking changes, shows what gets blocked.\n# Saves a governance report to delimit-report.md\n\n\nWatch for drift — detect spec changes without review:\nbash\nnpx delimit-cli init # Sets up governance + drift baseline\n# Weekly drift checks run automatically via GitHub Action\n\n\nRun PR copilot — governance gates on every pull request:\nyaml\n# .github/workflows/api-governance.yml\n- uses: delimit-ai/delimit-action@v1\n with:\n spec: api/openapi.yaml\n# Posts gate status, violations, and remediation in PR comments\n\n\n---\n\n## What's New in v4.1\n\n- TUI -- terminal-native Ventures panel, real delimit think and delimit build commands\n- Security hardening -- notify.py stubbed in npm, axios pinned against supply chain attacks\n- Free tier restructure -- deliberations use Gemini Flash + GPT-4o-mini (cost: <$20/mo)\n- Zero-config onboarding -- auto-detect framework, scan, and first evidence in one command\n- Auto-approve tools -- delimit setup configures permissions for Claude Code, Codex, and Gemini CLI\n\n### v4.0\n\n- Toolcard Delta Cache -- SHA256 schema hashing, delta-only transmission, saves tokens\n- Session Phoenix -- cross-model session resurrection with soul capture\n- Handoff Receipts -- structured acknowledgment protocol between agents\n- Cross-Model Audit -- 3 lenses (security, correctness, governance) with deterministic synthesis\n- 4-model deliberation -- Claude + Grok + Gemini + Codex debate until consensus\n- Universal Swarm Triggers -- "Think and Build", "Keep building", "Ask Delimit"
- 176 MCP tools -- governance, context, shipping, observability, orchestration, and swarm\n\n---\n\n## GitHub Action\n\nZero-config -- auto-detects your OpenAPI spec:\n\n
yaml\n- uses: delimit-ai/delimit-action@v1\n\n\nOr with full configuration:\n\nyaml\nname: API Contract Check\non: pull_request\n\njobs:\n delimit:\n runs-on: ubuntu-latest\n permissions:\n pull-requests: write\n steps:\n - uses: actions/checkout@v4\n with:\n fetch-depth: 0\n - uses: delimit-ai/delimit-action@v1\n with:\n spec: api/openapi.yaml\n\n\nThat's it. Delimit auto-fetches the base branch spec, diffs it, and posts a PR comment with breaking changes, semver classification, migration guides, and governance gate results.\n\nView on GitHub Marketplace | See a live demo (23 breaking changes)\n\n### Example PR comment\n\n> Breaking Changes Detected\n>\n> | Change | Path | Severity |\n> |--------|------|----------|\n> | endpoint_removed |DELETE /pets/{petId}| error |\n> | type_changed |/pets:GET:200[].id(string -> integer) | warning |\n> | enum_value_removed |/pets:GET:200[].status| warning |\n>\n> Semver: MAJOR (1.0.0 -> 2.0.0)\n>\n> Migration Guide: 3 steps to update your integration\n>\n> ### Governance Gates\n> | Gate | Status | Chain |\n> |------|--------|-------|\n> | API Lint | Pass/Fail | lint -> semver -> gov_evaluate |\n> | Policy Compliance | Pass/Fail | policy -> evidence_collect |\n> | Security Audit | Pass | security_audit -> evidence_collect |\n> | Deploy Readiness | Ready/Blocked | deploy_plan -> security_audit |\n\n---\n\n## CLI commands\n\nbash\nnpx delimit-cli quickstart # Clone demo project + guided walkthrough\nnpx delimit-cli try # Zero-risk demo — saves governance report\nnpx delimit-cli demo # Self-contained governance demo\nnpx delimit-cli init # Guided wizard with compliance templates\nnpx delimit-cli init --preset strict # Initialize with strict policy\nnpx delimit-cli setup # Install into all AI assistants\nnpx delimit-cli setup --dry-run # Preview changes first\nnpx delimit-cli lint api/openapi.yaml # Check for breaking changes\nnpx delimit-cli diff old.yaml new.yaml # Compare two specs\nnpx delimit-cli explain old.yaml new.yaml # Generate migration guide\nnpx delimit-cli doctor # Check setup health\nnpx delimit-cli uninstall --dry-run # Preview removal\n\n\n### What the MCP toolkit adds\n\nWhen installed into your AI coding assistant, Delimit provides tools across two tiers:\n\n#### Free (no account needed)\n\n- API governance -- lint, diff, policy enforcement, semver classification\n- Persistent ledger -- track tasks across sessions, shared between all AI assistants\n- Zero-spec extraction -- generate OpenAPI specs from FastAPI, Express, or NestJS source\n- Project scan -- auto-detect specs, frameworks, security issues, and tests\n- Quickstart -- guided first-run that proves value in 60 seconds\n\n#### Pro\n\n- Multi-model deliberation -- AI models debate until they agree (free: Gemini Flash + GPT-4o-mini; BYOK: any models)\n- Security audit -- dependency scanning, secret detection, SAST analysis\n- Test verification -- confirms tests ran, measures coverage, generates new tests\n- Memory & vault -- persistent context and encrypted secrets across sessions\n- Evidence collection -- governance audit trail for compliance\n- Deploy pipeline -- governed build, publish, and rollback\n- OS layer -- agent identity, execution plans, approval gates\n\n---\n\n## What It Detects\n\n27 change types (17 breaking, 10 non-breaking) -- deterministic rules, not AI inference. Same input always produces the same result.\n\n### Breaking Changes\n\n| # | Change Type | Example |\n|---|-------------|---------|\n| 1 |endpoint_removed|DELETE /users/{id}removed entirely |\n| 2 |method_removed|PATCH /ordersno longer exists |\n| 3 |required_param_added| New required header onGET /items|\n| 4 |param_removed|sortquery parameter removed |\n| 5 |response_removed|200 OKresponse dropped |\n| 6 |required_field_added| Request body now requirestenant_id|\n| 7 |field_removed|emaildropped from response object |\n| 8 |type_changed|idwent fromstringtointeger|\n| 9 |format_changed|date-timechanged todate|\n| 10 |enum_value_removed|status: "pending"no longer valid |\n| 11 |param_type_changed| Query paramlimitchanged fromintegertostring|\n| 12 |param_required_changed|filterparam became required |\n| 13 |response_type_changed| Responsedatachanged fromarraytoobject|\n| 14 |security_removed| OAuth2 security scheme removed |\n| 15 |security_scope_removed|write:petsscope removed from OAuth2 |\n| 16 |max_length_decreased|namemaxLength reduced from 255 to 100 |\n| 17 |min_length_increased|codeminLength increased from 1 to 5 |\n\n### Non-Breaking Changes\n\n| # | Change Type | Example |\n|---|-------------|---------|\n| 18 |endpoint_added| NewPOST /webhooksendpoint |\n| 19 |method_added|PATCH /users/{id}method added |\n| 20 |optional_param_added| Optionalformatquery param added |\n| 21 |response_added|201 Createdresponse added |\n| 22 |optional_field_added| Optionalnicknamefield added to response |\n| 23 |enum_value_added|status: "archived"value added |\n| 24 |description_changed| Updated description for/healthendpoint |\n| 25 |security_added| API key security scheme added |\n| 26 |deprecated_added|GET /v1/usersmarked as deprecated |\n| 27 |default_changed| Default value forpage_sizechanged from 10 to 20 |\n\n---\n\n## Policy presets\n\nbash\nnpx delimit-cli init --preset strict # All violations are errors\nnpx delimit-cli init --preset default # Balanced (default)\nnpx delimit-cli init --preset relaxed # All violations are warnings\n\n\nOr write custom rules in.delimit/policies.yml:\n\nyaml\nrules:\n - id: freeze_v1\n name: Freeze V1 API\n change_types: [endpoint_removed, method_removed, field_removed]\n severity: error\n action: forbid\n conditions:\n path_pattern: "^/v1/.*"\n message: "V1 API is frozen. Changes must be made in V2."\n\n\n---\n\n## Supported formats\n\n- OpenAPI 3.0 and 3.1\n- Swagger 2.0\n- YAML and JSON\n\n---\n\n## Links\n\n- delimit.ai -- homepage\n- Dashboard -- governance console\n- Docs -- full documentation\n- GitHub Action -- Marketplace listing\n- Quickstart -- try it in 2 minutes\n- npm -- CLI package\n- Pricing -- free tier + Pro\n\nMIT License