Skip to main content
Glama

</> Delimit

Stop re-explaining your codebase every session. Memory, tasks, and governance that persist across Claude Code, Codex, Cursor, and Gemini CLI.

npm GitHub Action License: MIT Glama API Governance


Try it in 2 minutes

npx delimit-cli demo     # See governance in action — no setup needed
npx delimit-cli init     # Set up governance for your project
npx delimit-cli setup    # Configure your AI assistants

No API keys. No account. No config files.

Pick your first win

Protect my API — catch breaking changes before merge:

npx delimit-cli try
# Creates a sample API, introduces breaking changes, shows what gets blocked.
# Saves a governance report to delimit-report.md

Watch for drift — detect spec changes without review:

npx delimit-cli init        # Sets up governance + drift baseline
# Weekly drift checks run automatically via GitHub Action

Run PR copilot — governance gates on every pull request:

# .github/workflows/api-governance.yml
- uses: delimit-ai/delimit-action@v1
  with:
    spec: api/openapi.yaml
# Posts gate status, violations, and remediation in PR comments

What's New in v3.15

  • Agent Swarm -- 20 AI agents across 4 ventures with namespace isolation and tiered approvals

  • Prompt Playbook -- versioned, reusable prompts with {{variable}} syntax

  • Multi-model code review -- consolidated feedback from 3+ AI models

  • PII/secret redaction -- auto-scan and redact before sending to external LLMs

  • Collision detection -- prevent two AI models from editing the same file

  • 4-model deliberation -- Claude + Grok + Gemini + Codex debate until consensus

  • Change management -- docs freshness check enforced before deploy

  • 171 MCP tools -- governance, context, shipping, observability, orchestration, and swarm


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, semver classification, migration guides, and governance gate results.

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

Governance Gates

Gate

Status

Chain

API Lint

Pass/Fail

lint -> semver -> gov_evaluate

Policy Compliance

Pass/Fail

policy -> evidence_collect

Security Audit

Pass

security_audit -> evidence_collect

Deploy Readiness

Ready/Blocked

deploy_plan -> security_audit


CLI commands

npx delimit-cli quickstart                       # Clone demo project + guided walkthrough
npx delimit-cli try                              # Zero-risk demo — saves governance report
npx delimit-cli demo                             # Self-contained governance demo
npx delimit-cli init                             # Guided wizard with compliance templates
npx delimit-cli init --preset strict             # Initialize with strict policy
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 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


MIT License

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