</> Delimit

One workspace for every AI coding assistant. Switch models, not context.

Your tasks, memory, and governance carry between Claude Code, Codex, and Gemini CLI. Persistent ledger, API breaking change detection, security audit, multi-model deliberation — all shared across assistants.

GitHub Action

Add to any repo with an OpenAPI spec:

name: API Contract Check
on: pull_request

jobs:
  delimit:
    runs-on: ubuntu-latest
    permissions:
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - uses: delimit-ai/delimit-action@v1
        with:
          spec: api/openapi.yaml

That's it. Delimit auto-fetches the base branch spec, diffs it, and posts a PR comment with:

• Breaking changes with severity badges

• Semver classification (major/minor/patch)

• Step-by-step migration guide

• Policy violations

View on GitHub Marketplace → · See a live demo (6 breaking changes) →

Example PR comment

Breaking Changes Detected

Change	Path	Severity
endpoint_removed	DELETE /pets/{petId}	error
type_changed	/pets:GET:200[].id (string → integer)	warning
enum_value_removed	/pets:GET:200[].status	warning

Semver: MAJOR (1.0.0 → 2.0.0)

Migration Guide: 3 steps to update your integration

CLI + MCP Toolkit

Governance tools for AI coding assistants (Claude Code, Codex, Cursor, Gemini CLI):

npx delimit-cli setup

No API keys. No account. Installs in 10 seconds.

CLI commands

npx delimit-cli lint api/openapi.yaml           # Check for breaking changes
npx delimit-cli diff old.yaml new.yaml           # Compare two specs
npx delimit-cli explain old.yaml new.yaml        # Generate migration guide
npx delimit-cli init --preset strict             # Initialize policies
npx delimit-cli doctor                           # Check setup health

What the MCP toolkit adds

When installed into your AI coding assistant, Delimit provides:

• API governance -- lint, diff, policy enforcement, semver classification

• Test verification -- confirms tests actually ran, measures coverage

• Security audit -- scans dependencies, detects secrets and anti-patterns

• Persistent ledger -- tracks tasks across sessions, auto-creates items from governance

• Multi-model consensus -- Grok, Gemini, and Codex debate until they agree

• Zero-spec extraction -- generate OpenAPI specs from FastAPI, Express, or NestJS source

What it catches

10 categories of breaking changes:

Detection is deterministic — rules, not AI inference. Same input always produces the same result.

Policy presets

npx delimit-cli init --preset strict    # All violations are errors
npx delimit-cli init --preset default   # Balanced (default)
npx delimit-cli init --preset relaxed   # All violations are warnings

Or write custom rules in .delimit/policies.yml:

rules:
  - id: freeze_v1
    name: Freeze V1 API
    change_types: [endpoint_removed, method_removed, field_removed]
    severity: error
    action: forbid
    conditions:
      path_pattern: "^/v1/.*"
    message: "V1 API is frozen. Changes must be made in V2."

Supported formats

• OpenAPI 3.0 and 3.1

• Swagger 2.0

• YAML and JSON

Links

• delimit.ai -- homepage

• Docs -- full documentation

• GitHub Action -- Marketplace listing

• Quickstart -- try it in 2 minutes

• npm -- CLI package

• Pricing -- free tier + Pro

MIT License