Skip to main content
Glama
delimit-ai

delimit

Official
by delimit-ai
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

</> Delimit

Unify Claude Code, Codex, Cursor, and Gemini CLI with persistent context, governance, and multi-model debate.

npm GitHub Action License: MIT Glama API Governance

Persistent ledger, API governance, security orchestration, and multi-model deliberation — all shared across Claude Code, Codex, Cursor, and Gemini CLI.

GitHub Action

Zero-config — auto-detects your OpenAPI spec:

- uses: delimit-ai/delimit-action@v1

Or with full configuration:

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 (23 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 (all free)

npx delimit-cli setup                            # Install into all AI assistants
npx delimit-cli setup --dry-run                  # Preview changes first
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
npx delimit-cli uninstall --dry-run              # Preview removal

What the MCP toolkit adds

When installed into your AI coding assistant, Delimit provides tools across two tiers:

Free (no account needed)

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

  • Persistent ledger -- track tasks across sessions, shared between all AI assistants

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

  • Project scan -- auto-detect specs, frameworks, security issues, and tests

  • Quickstart -- guided first-run that proves value in 60 seconds

Pro

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

  • Security audit -- dependency scanning, secret detection, SAST analysis

  • Test verification -- confirms tests ran, measures coverage, generates new tests

  • Memory & vault -- persistent context and encrypted secrets across sessions

  • Evidence collection -- governance audit trail for compliance

  • Deploy pipeline -- governed build, publish, and rollback

  • OS layer -- agent identity, execution plans, approval gates

What It Detects

27 change types (17 breaking, 10 non-breaking) -- deterministic rules, not AI inference. Same input always produces the same result.

Breaking Changes

#

Change Type

Example

1

endpoint_removed

DELETE /users/{id} removed entirely

2

method_removed

PATCH /orders no longer exists

3

required_param_added

New required header on GET /items

4

param_removed

sort query parameter removed

5

response_removed

200 OK response dropped

6

required_field_added

Request body now requires tenant_id

7

field_removed

email dropped from response object

8

type_changed

id went from string to integer

9

format_changed

date-time changed to date

10

enum_value_removed

status: "pending" no longer valid

11

param_type_changed

Query param limit changed from integer to string

12

param_required_changed

filter param became required

13

response_type_changed

Response data changed from array to object

14

security_removed

OAuth2 security scheme removed

15

security_scope_removed

write:pets scope removed from OAuth2

16

max_length_decreased

name maxLength reduced from 255 to 100

17

min_length_increased

code minLength increased from 1 to 5

Non-Breaking Changes

#

Change Type

Example

18

endpoint_added

New POST /webhooks endpoint

19

method_added

PATCH /users/{id} method added

20

optional_param_added

Optional format query param added

21

response_added

201 Created response added

22

optional_field_added

Optional nickname field added to response

23

enum_value_added

status: "archived" value added

24

description_changed

Updated description for /health endpoint

25

security_added

API key security scheme added

26

deprecated_added

GET /v1/users marked as deprecated

27

default_changed

Default value for page_size changed from 10 to 20

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

MIT License

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

Resources

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/delimit-ai/delimit'

If you have feedback or need assistance with the MCP directory API, please join our Discord server