Delimit

</> Delimit

保留状态。更换模型。

Delimit 会将你的决策、任务和交接内容保存在本机，让下一次 AI 编码会话能从上次停止的地方继续，即使换用其他助手也一样。

Glama 目录评分：许可证 A · 质量 A · 维护 A。数据观测于 2026 年 9 月 15 日，针对这个公开仓库。查看目录页。

问题

• 你的 Agent 会忘记你上次会话的决定，然后再次询问，或悄悄做出不同决定。
• 它会重复已完成的工作，或者在没有任何成果交付时声称“完成了”。
• 它会执行你从未批准的操作。

快速开始

npx delimit-cli setup

setup 会将 Delimit 添加到它在本机找到的助手中。像往常一样打开你的助手，它就能读取和写入同一份已保存记录。你也可以在终端中保存和查找决策：

同一会话的文本形式：

$ npx delimit-cli remember "Auth uses session cookies, not JWT. Decided after the token-leak review."

  Remembered. (1 memory total)

$ npx delimit-cli recall auth

  Delimit Memories

    [mem-9586382bff96] just now [cli] ✓
    Auth uses session cookies, not JWT. Decided after the token-leak review.
    #jwt

  1 memory found (1 total)

支持： Claude Code、Codex、Cursor 和 Antigravity（由 setup 配置），以及通过 delimit chat 使用完整会话的 GitHub Copilot 和 Muse。请自行安装并登录每个客户端；参见Lead chat、Copilot CLI 和 Muse Code 会话。

npx delimit-cli chat --model copilot
npx delimit-cli chat --model muse

重大决策： npx delimit-cli deliberate "<question>" 会将问题提交给你配置的模型（Claude、通过 Codex 使用的 GPT、通过 Antigravity 使用的 Gemini、Grok、DeepSeek、Muse），并展示它们意见一致和不一致之处。

如果 Delimit 对你有帮助，点个 ⭐ 能让更多人发现它。

适用于代码仓库：合并门禁

Delimit 还可以在仓库中为 AI 辅助的变更设置门禁，并为每次运行保留本地签名证明。

$ delimit wrap -- claude "fix the flaky test in tests/api.spec.ts"

✓ repo_diagnose
✓ security_audit       0 critical · 0 secrets
✓ test_smoke           165/165
✓ changed_files        1
✓ attestation signed   att_a05050eb8e13277e
                       delimit.attestation.v1 · HMAC-SHA256
                       receipt → .delimit/attestations/att_a05050eb8e13277e.json

每次经包装器运行都会生成一个本地 delimit.attestation.v1 捆绑包，其中包含运行前后的仓库 HEAD、变更文件、门禁结果以及 HMAC-SHA256 签名。使用 delimit seal-verify 离线验证；目前尚不支持托管重放。默认仅提供建议；准备就绪后可切换为强制模式。

---

零配置 PR 检查：delimit check

零配置 PR 安全门禁。无需 init、无需设置、无需账号、无需密钥——在任意仓库中运行即可，它会对已暂存或已修改的文件执行确定性检查（破坏性 API 变更和泄露的密钥）。

npx delimit-cli check

$ delimit check

  Delimit Check

  Policy: default | Base: HEAD | Specs: 1

  + api/openapi.yaml — clean

  PASSED — no breaking changes, no leaked secrets

如果检查发现破坏性变更或泄露的密钥，它会打印有问题的文件和问题详情，并以非零状态退出——因此可以直接用于 pre-commit 钩子或 CI 步骤。

常用选项：

delimit check --staged          # only check staged files
delimit check --base main       # compare against a git ref (default HEAD)
delimit check --fix             # show migration guidance for violations
delimit check --record          # write a content-pinned record of this check

--record 会将检查的内容固定记录写入 .delimit/records/check-<ts>.json（或你指定的路径）。该记录是已签名、可重放的 Seal 证明的前身——证据格式相同，并固定到你检查的确切内容。

方法论 · cal.com v2 实例 · 工作流指南 · 网站

---

实例

针对公开 API 规范进行的真实、可复现合并门禁运行：

• OpenAI OpenAPI：在跨厂商合并门禁下见证一年的 AI 前沿演进 — OpenAI (openai/openai-openapi)
• Stripe v1 OpenAPI：在合并门禁下运行 57 天 — Stripe (stripe/openapi)
• Anthropic API：在跨厂商合并门禁下运行 76 天 — Anthropic (anthropics/anthropic-sdk-python)
• Twilio v2010 OpenAPI：在合并门禁下运行 55 天 — Twilio (twilio/twilio-oai)
• Docusign eSignature v2.1 OpenAPI：在合并门禁下运行 46 天 — Docusign (docusign/OpenAPI-Specifications)
• Supabase Auth OpenAPI：在合并门禁下运行 57 天 — Supabase Auth (supabase/auth)
• cal.com v2 OpenAPI：在合并门禁下运行 60 天 — cal.com (calcom/cal.com)
• EU TED v3 采购 API：合并门禁下的 $ref'd 组件架构漂移 — European Commission (TED v3 Public API)
• 跨 Agent 交接：一个制品，四个 CLI — 跨 CLI 会话交接（实例）
• delimit-mcp-server（自我验证）：相同的合并门禁，第三种制品类别 — delimit-mcp-server（自我验证）

查看完整索引，请访问 delimit.ai/reports。有关每份报告背后的架构和签名方法，请参阅 delimit.ai/methodology/mcp-attestation。

---

黄金路径——你的前 10 分钟

端到端完成 API 检查：检查规范，准确查看问题所在，对版本升级分类，使用你配置的模型提供方解决棘手问题，并保留一份本地签名的运行凭证。随后保留可跨会话和模型延续的上下文。

1. 安装

npx delimit-cli scan          # discovery: finds your OpenAPI specs, frameworks, security issues, tests
npx delimit-cli init          # wire up the merge-gate config (--preset strict | default | relaxed)

scan (delimit_scan) 会报告 Delimit 能为此代码库做什么。init (delimit_init) 会添加策略预设和合并门禁配置。无需账户或密钥。

2. 端到端运行合并门禁

检查规范变更（门禁）。 对照基线与提议版本，并应用策略——一次检查即可得出通过或失败的判定。

npx delimit-cli lint old.yaml new.yaml       # tool: delimit_lint

准确查看问题所在。 纯结构差异——新增、删除或修改的端点、架构、参数，不应用策略。

npx delimit-cli diff old.yaml new.yaml       # tool: delimit_diff

对版本升级分类。 确定性的 MAJOR/MINOR/PATCH/NONE——相同输入，每次都得到相同结果。

delimit_semver       → MAJOR/MINOR/PATCH/NONE + next version string
delimit_impact       → blast radius: scans your dependency manifest for downstream callers (informational)

解决棘手问题。 当门禁判定需要权衡时，交由多个模型讨论并达成共识。

npx delimit-cli deliberate "Is dropping the deprecated v1 /users field a safe MINOR?"
#   tool: delimit_deliberate — uses your configured model CLIs or API keys

delimit setup 会为 Codex MCP 服务设置 30 分钟的工具超时时间， 使多轮讨论能够返回完整记录，而不会在模型仍在响应时被客户端分离。

记录已签名、可重放的证明。 在门禁事件（部署 / 安全 / 测试 / 审计）之后，记录证据包，并可随时验证。

delimit_evidence_collect   → signed evidence bundle for the audit trail        (Pro)
delimit_evidence_verify    → confirm a bundle hasn't been tampered with         (Pro)
delimit_seal_verify        → check a Delimit Seal receipt against its bundled   (Free)
                             Layer-0 constitution — offline-verifiable

每份凭证都可通过 npx delimit-cli seal-verify <receipt.json> 离线验证。目前尚不支持托管凭证重放。

3. 跨会话和模型保留上下文

决策、约束和任务会跨会话保留。使用保存的记录，在 Claude Code、Codex、Cursor、Antigravity、GitHub Copilot 或 Muse 中继续工作。

记忆 — 持久保存并回忆 原因，而不只是差异。

npx delimit-cli remember "v1 /users field is frozen until Q3 — downstream billing depends on it"
#   tool: delimit_memory_store
npx delimit-cli recall billing               # local recall over your saved memories (Free)

要跨会话按含义进行语义检索，助手会直接调用 delimit_memory_search（Pro）。

台账 — 一份任务清单，在所有助手和会话之间共享。

delimit_ledger_add        → record a task/bug/feature/strategic item
delimit_ledger_context    → session-start: top open items by priority (what's queued)
delimit_ledger_done       → close with a note (auto-captures a PR URL as ship proof)

这就是工作循环：守住变更关卡、签署证明、保留上下文。在真实规格上运行一次，就能完整体验整个合并关卡。

Lead chat、Copilot CLI 和 Muse Code 会话

请单独安装并验证官方客户端，并使用运行 Delimit 的同一 OS 用户。Delimit 不会安装这些客户端、购买方案、为你登录，也不会验证你的订阅额度。交互式 lead 顺序为 Claude → Codex → Antigravity → Muse → Copilot，具体取决于现有配置、可用性和原生客户端检查。这只会更改 lead chat，不会影响审查面板或后台路由。现有付费 API 回退仍为选择加入。

npx delimit-cli chat
npx delimit-cli chat --model muse
npx delimit-cli chat --model copilot
npx delimit-cli chat --project /path/to/repository --model muse

你可以从主目录启动，而无需切换目录。这是一个未指定范围的所有者工作区：Delimit 会加载工作区指令，但不会推断某个 venture，也不会恢复最新的不相关交接记录。不会选择过时的 active-venture 指针。使用 --project 绑定现有 Git 仓库；项目路径缺失或无效时，会在启动模型前报错。根目录/工作区退出不会声明已捕获项目绑定信息。请通过现有 Delimit 工具，根据实际任务范围恢复或保存上下文。

Muse 和 Copilot 是原生交互式 harness，不是新增的模型投票，也不是自动构建循环后端。明确指定 --model muse 或 --model copilot 后，将保持该选择，不会探测或静默切换提供方。在默认 lead 链中，原生启动失败时可以转到下一个 lead；主动中断则会退出。不会根据失败或不可用的捕获操作推断已成功交接。原生权限审批仍然有效。本次会话中，Copilot 启动时会禁用自动更新和远程/导出功能。

**Muse 准备：**首先确认你的账户允许通过预期的计费路径使用 Standard muse-spark-1.3。备份原生 $XDG_CONFIG_HOME/muse/settings.json（如果未设置 XDG_CONFIG_HOME，则为 ~/.config/muse/settings.json），并将以下字段合并到现有 JSON 对象中；保留无关设置和身份验证信息：

{
  "model": "muse-spark-1.3",
  "context": {
    "foreign_personal_rules": false,
    "foreign_personal_skills": false
  }
}

明确启动 Muse 需要选择该模型，并排除其他个人规则/技能；Delimit 不会为你更改原生设置。已配置的提供方必须为 meta，已配置的端点必须为 https://api.meta.ai/v1。如果存在 META_API_KEY 或 MODEL_API_KEY 环境变量覆盖项，则必须先解决预期的计费路径，才能启动。不要仅为绕过此检查而切换凭据或模型。选择 Standard 并不能证明零保留、按订阅计费或已获准处理私有数据。

当前的二进制文件发现机制支持位于 ~/.local/bin、/usr/local/bin 或 /usr/bin 的 Copilot，以及 Muse 的版本化 ~/.local/bin/muse-bin-<version>-R<revision> 发行版。Muse 会直接使用该可执行文件，而不是其更新器启动器。不会自动发现其他安装布局。原生 Muse 上下文设置已在 Muse Code 1.2.1 中验证；升级客户端时，请重新检查兼容性。 Delimit 提供紧凑的、绑定项目的启动指令，不会自动导入你的账本、记忆或完整对话。可选的本地指导内容可保存在 $DELIMIT_HOME/harness-bootstrap.md 中（默认为 ~/.delimit/harness-bootstrap.md）；合并后的启动文本必须控制在 16 KiB 以内。项目中大小达到或超过 64 KiB 的 AGENTS.md/CLAUDE.md 文件会被拒绝，而不会静默截断。请通过可用的 Delimit 工具恢复并保存限定范围的交接内容。这些启动器不会自动注册原生 MCP 连接，也不能证明跨框架的连续性。

当项目中同时存在这两个指导文件时，启动数据包会列出两个文件及其大小和哈希，并告知框架完整读取它们，包括原生文件优先级规则隐藏的指导内容。它不会将文件内容复制到启动数据包中，不会静默合并文件，也不会覆盖现有的指导层级。用户全局指导仍需通过本地引导文件选择启用；默认情况下，Delimit 绝不会复制其他客户端的私有规则。 此清单是加载指令，并不能证明模型已执行所有读取操作。如果必要的指导内容无法访问或存在冲突，请先解决这一问题，再允许编辑。超出大小限制的原生项目文件仍会导致安全拒绝，且原文件不会被改写。

可通过 delimit setup --harness-shims 安装可选命令垫片。常规设置只会刷新已由工具管理的 Muse/Copilot 垫片，不会新添垫片来遮蔽原生命令。自定义垫片会保留。选择启用此选项后，如遇到冲突的自定义文件，安装过程会停止，不安装这两个额外垫片。

对于现有的、由启动器管理的连续性，正常退出时只会完成已绑定的交接内容。如果无法完成，Delimit 会报告具体原因，并在其 sessions/ 目录下写入私有的本地诊断回执。该回执不是对话备份。现有交接内容不会被空内容替换；请恢复准确的原生会话，并明确保存绑定项目的交接内容。

---

思考与构建

delimit think 使用可用的已配置提供商运行多模型研讨。delimit build 会启动一个分离运行的规划工作进程，用于检查代码库并撰写简报；它不会执行账本任务。delimit vault 会将机密以明文 JSON 格式存储在仅所有者可访问（0600）的文件中。

适用于各种配置，从预算有限的单模型到完整模型组。

---

2 分钟快速上手

npx delimit-cli doctor            # Checks your local setup and suggests fixes
npx delimit-cli status            # Visual dashboard of your entire governance setup
npx delimit-cli simulate          # Dry-run: see what would be blocked before you commit
npx delimit-cli scan              # Instant health grade for your API spec
npx delimit-cli try owner/repo    # Try governance on any GitHub repo

无需 API 密钥。无需账户。无需配置文件。

选择你的第一个目标

保护我的 API —— 在合并前发现破坏性变更：

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

监控偏差 —— 无需审查即可检测规范变更：

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

运行 PR 副驾驶 —— 在每个拉取请求上执行治理检查：

# .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

---

最新动态

为每次 AI 辅助调用设置门禁。交付验证回执。

• delimit wrap —— 通过签名治理门禁运行 claude -p、cursor、aider、codex 或任何 AI 辅助命令行工具。它会对比操作前后的 git 差异，运行 lint 和测试，为 att_* 证明签署 HMAC，并在本地写入回执以供离线验证。默认仅提供建议；--enforce 会在违反策略时阻止 CI；--max-time <s> 是一个终止开关，会将证明标记为 liability_incident，并打印跨模型交接命令。
• delimit trust-page —— 将证明目录渲染为静态 HTML 信任页面和 JSON Feed 1.1 源。单文件、无需框架、可离线渲染。可部署到任何地方。
• delimit ai-sbom —— 将证明汇总为 CycloneDX 1.6 物料清单，其中包含 AI 专属字段（按供应商检测到的模型、工具调用范围、策略门禁计数）。可直接交给采购部门。
• 按设计支持跨模型 —— wrap 对受支持的命令行调用方使用相同的本地证明架构。Delimit 会在 Claude Code、Codex、Cursor、Antigravity、GitHub Copilot 和 Muse 之间保留会话上下文。

# Gate any AI-assisted CLI
delimit wrap -- claude -p "add tests for payments"
#   → att_7d556843c84fb881 signed, receipt written locally

# Kill switch + handoff after 60s wall-clock
delimit wrap --max-time 60 -- cursor edit "refactor auth middleware"
#   → if killed: kind=liability_incident
#   → suggested: delimit wrap -- claude -p "refactor auth middleware"

# Render accumulated attestations as a public trust page
delimit trust-page -o ./trust
#   → ./trust/index.html (+ feed.json)

# Build a CycloneDX-AI bill of materials
delimit ai-sbom -o ./ai-sbom.json
#   → components: 4 models detected, 187 gates run

早期版本

AI 治理的最高水平——早期功能仍在持续运行。

• delimit doctor——检查本地设置并建议修复方案。支持在流水线中使用 --ci，以及对受支持的问题使用 --fix 修复。
• delimit simulate——策略试运行。在提交之前查看哪些内容会被拦截。相当于 API 治理的 terraform plan。
• delimit status——可视化终端仪表板。涵盖策略、规范、钩子、CI、MCP、模型、记忆、账本、证据和 Git 分支。使用 --watch 实时刷新。
• delimit report——治理报告。支持 --since 7d --format md|html|json。输出适合审计，可用于 PR 和合规工作。
• 记忆加固——每次 remember 都会记录 SHA-256 完整性哈希和来源模型标签。支持跨模型信任，并在每次 recall 时进行验证。
• 基于标签发布——自动同步网关，避免源代码与 npm 包之间的版本不一致。

多模型研讨

同时将问题交由 4 个 AI 模型处理。它们相互辩论，直到达成一致。

delimit deliberate "Should we build rate limiting in-house or use a managed service?"

  Round 1 (independent):
    Claude:  Build in-house. Redis sliding window is 50 lines.
    Gemini:  Build. You already have Redis.
    Codex:   Agree — but add circuit breaker for Redis failures.
    Grok:    Build. Managed service costs $200/mo for 50 lines of code.

  Round 2 (deliberation):
    All models: AGREE

  UNANIMOUS CONSENSUS (2 rounds, confidence 94/100)
  Build rate limiting in-house with Redis + circuit breaker.

研讨会使用你配置的模型 CLI 或 API 密钥。提供商是否可用取决于你的设置。

v4.18

• 每次发布都会发布 MCP Registry 记录——官方注册表条目现在会自动跟踪 npm 版本。发布者已固定并通过校验和验证；标签门禁会确认两个 server.json 版本字段都与包版本一致。
• 工具描述——根据签名补充了此前未记录的 16 个参数；26 个受 Pro 限制的工具说明了前置条件和未授权调用时的响应。
• 发布防护——包分类防护不再因 SIGPIPE 而偶发失败。

v4.17

• 新安装时的跨模型连续性——delimit_soul_capture / delimit_revive 无需任何内部模块即可通过公开的 session_continuity 模块运行；捕获的灵魂带有确定性来源信息（项目、转录内容标识、捕获密钥），可在切换模型后可靠恢复。现有灵魂文件无需更改即可加载。
• 安全审计——减少了对测试样例和文档示例的误报；被抑制的发现会被报告，不会被悄然丢弃。

v4.16

• 默认拒绝的包白名单——npm 包仅包含经过明确审核的网关文件；两项 CI 防护会阻止任何未分类或不在白名单中的文件进入压缩包。
• 会话结束时自动捕获——安装时采用 Claude Code 预期的设置格式，因此会触发会话结束交接，而不是被悄然丢弃。
• 始终运行的提交作者审计工作流会捕捉仓库中的身份漂移。

v4.1

• TUI——原生终端 Ventures 面板，提供真正的 delimit think 和 delimit build 命令
• 安全加固——npm 中的 notify.py 替换为存根，并固定 axios 版本以防供应链攻击
• 研讨提供商——研讨会使用你配置的模型 CLI 或 API 密钥运行（delimit models）；不包含托管运行
• 零配置入门——通过一条命令自动检测框架、扫描并生成首份证据
• 助手权限——delimit setup 为 Claude Code、Codex、Cursor 和 Antigravity 配置 MCP 访问权限，并为部分客户端设置默认审批选项；请根据你的环境检查这些设置

v4.0

• Toolcard Delta Cache——使用 SHA256 对架构进行哈希，仅传输增量内容，节省令牌
• Session Phoenix——通过灵魂捕获实现跨模型会话复活
• Handoff Receipts——Agent 之间的结构化确认协议
• Cross-Model Audit——提供 3 个视角（安全、正确性、治理），并进行确定性综合
• 4 模型研讨——Claude + Grok + Gemini + Codex 辩论直至达成共识
• Universal Swarm Triggers——“Think and Build”、“Keep building”、“Ask Delimit”
• 完整治理工具包——将 lint、diff、策略、证据、漂移、证明和蜂群编排作为 MCP 工具及 CLI 子命令提供

GitHub Action

零配置——自动检测你的 OpenAPI 规范：

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

或使用完整配置：

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

就这么简单。Delimit 会自动获取基础分支的规范、进行差异比较，并发布 PR 评论，其中包含破坏性变更、semver 分类、迁移指南和治理门禁结果。

在 GitHub Marketplace 上查看 | 查看实时演示（23 项破坏性变更）

PR 评论示例

检测到破坏性变更

变更	路径	严重性
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）

迁移指南：通过 3 个步骤更新你的集成

治理门禁

门禁	状态	链
API Lint	通过/失败	lint -> semver -> gov_evaluate
策略合规性	通过/失败	policy -> evidence_collect
安全审计	通过	security_audit -> evidence_collect
部署就绪度	就绪/阻止	deploy_plan -> security_audit

---

以最小权限采用

你不必一开始就信任大量工具。安全的入门方式如下：

阶段 1——只读治理（免费，无需账户）。 从只读取你的仓库并编写报告的工具开始：delimit_lint、delimit_diff、delimit_semver、delimit_policy、delimit_explain、delimit_scan 和 delimit_seal_verify。如果你的 MCP 客户端支持按工具设置允许列表，只授予这些工具。此集合中的工具不会执行操作、部署或向任何地方发布内容。

阶段 2——有意选择是否启用副作用。 会写入证据包、发布 PR 评论或执行部署的工具（delimit_security_audit、delimit_deploy_*、Agent 编排）受等级限制；等阶段 1 在 CI 中证明有用后，再启用它们。

将 Action 固定到提交 SHA。 @v1 是一个浮动标签。对于供应链敏感的流水线，请固定到确切的提交，并在审核后更新：

- uses: delimit-ai/delimit-action@<commit-sha>   # gh api repos/delimit-ai/delimit-action/git/refs/tags/v1

不要将 BYOK 密钥存放在仓库或 dotfile 配置中。 如果你在研讨过程中使用自己的模型密钥，请通过 delimit_secret_store 存储（本地保存在仅所有者可访问的 0600 文件中，采用 base64 编码，未加密；访问记录通过 delimit_secret_access_log 追踪），而不是存放在 dotfile 中。

我们自己的版本发布也遵循同样的规范：每个版本都附带经过签名、可重放的 Seal 收据（参见最新的 版本资源——使用 npx delimit-cli seal-verify <receipt.json> 验证），并在 npm 上提供 SLSA 来源证明。

---

CLI 命令

npx delimit-cli scan                             # Instant spec health grade + recommendations
npx delimit-cli pr owner/repo#123                # Review any GitHub PR for breaking changes
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 check                            # Pre-commit governance check
npx delimit-cli check --staged --fix             # Check staged files + show guidance
npx delimit-cli hooks install                    # Install git pre-commit hook
npx delimit-cli hooks install --pre-push         # Also add pre-push hook
npx delimit-cli ci                               # Generate GitHub Action workflow
npx delimit-cli ci --strict --dry-run            # Preview strict workflow
npx delimit-cli remember "Redis uses JWT 15min"   # Save a persistent memory
npx delimit-cli recall redis                     # Search memories
npx delimit-cli recall                           # Show recent memories
npx delimit-cli recall --tag deploy --all        # Filter by tag, show all
npx delimit-cli recall --export                  # Export as markdown
npx delimit-cli forget abc123                    # Delete a memory by ID
npx delimit-cli models                            # Configure deliberation API keys (BYOK wizard)
npx delimit-cli models --status                   # Show current model config
npx delimit-cli status                           # Compact dashboard of your Delimit setup
npx delimit-cli doctor                           # Check setup health
npx delimit-cli uninstall --dry-run              # Preview removal
npx delimit-cli wrap -- claude -p "..."          # Gate any AI-assisted CLI + signed attestation
npx delimit-cli wrap --max-time 60 -- codex "..."# With kill switch + handoff on timeout
npx delimit-cli trust-page -o ./trust            # Render attestations into a static trust page
npx delimit-cli ai-sbom -o ./ai-sbom.json        # Build a CycloneDX-AI bill of materials

MCP 工具包的新增功能

安装到你的 AI 编码助手后，Delimit 会提供两个层级的工具：

免费（无需账户）

• API 治理——lint、差异比较、策略执行、semver 分类
• 持久化账本——跨会话追踪任务，并在所有 AI 助手之间共享
• 零规范提取——从 FastAPI、Express 或 NestJS 源代码生成 OpenAPI 规范
• 项目扫描——自动检测规范、框架、安全问题和测试
• 快速入门——引导完成首次运行，在 60 秒内展现价值

Pro

• 多模型研讨——你配置的模型会持续辩论，直到达成一致；具体可用的提供商取决于你的设置
• 安全审计——依赖项扫描、密钥检测、SAST 分析
• 测试验证——确认测试已运行、测量覆盖率并生成新测试
• 记忆与保险库——跨会话持久化上下文和本地明文密钥文件
• 证据收集——用于合规性的治理审计跟踪
• 部署流水线——受治理的构建、发布和回滚
• OS 层——Agent 身份、执行计划、审批门禁

---

它检测什么

Delimit 使用确定性规则检查 OpenAPI 和 JSON Schema 变更，覆盖各自支持的情况。示例包括已移除的端点、新增的必需参数，以及已变更的响应字段。请结合你的契约查看检测结果；CLI 和 GitHub Action 的规则覆盖范围有所不同。

---

策略预设

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

也可以在 .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."

---

支持的格式

• OpenAPI 3.0 和 3.1
• Swagger 2.0
• YAML 和 JSON

---

常见问题

这与 Obsidian Mind 有何不同？

Obsidian Mind 是一款出色的 Obsidian 知识库模板，适用于希望通过 Markdown 文件实现持久记忆的 Claude Code 用户。Delimit 采用不同的方式：它在 Claude Code、Codex、Cursor、Antigravity、GitHub Copilot 和 Muse 之间保留共享记录。切换模型时，你的记忆、账本和治理信息也会随之迁移。Delimit 还提供 API 治理（检测 OpenAPI 规范中的破坏性变更）、CI 门禁、Git 钩子和策略执行，这些都不在 Obsidian Mind 的覆盖范围内。如果你只使用 Claude + Obsidian，请使用 Obsidian Mind。如果你会在不同模型之间切换，或需要治理功能，请使用 Delimit。

不使用 Claude Code 也能用吗？

可以。Delimit 支持 Claude Code、Codex、Cursor、Antigravity、GitHub Copilot 和 Muse。remember/recall 命令可以独立使用。MCP 服务可与支持 Model Context Protocol 的客户端集成。

这是免费的吗？

Delimit 提供 Free、Pro 和 Enterprise 套餐。多模型协商使用你配置的模型 CLI 或 API 密钥。请参阅当前套餐详情。

---

本地数据和网络请求

Delimit 会将其账本、记录和本地证明存储在你的计算机上。某些设置和会话流程默认会发起网络请求：

• 设置过程会检查是否有更新的 CLI 版本，并可下载 Pro 模块 tarball。
• Claude Code SessionStart 钩子和已安装的 shim 可能会检查并安装更新。
• 许可证激活会联系许可证提供方，并将你的客户邮箱、许可证 ID 和机器哈希发送至 delimit.ai。
• 多模型协商会通过你配置的 CLI 登录凭据或 API 密钥，将你的提示词和相关上下文发送给模型提供方。

此软件包不包含 gateway/ai/supabase_sync.py。只有配置了 DELIMIT_WEBHOOK_URL 时，才会发送 Webhook 通知。

---

链接

• delimit.ai -- 主页
• Dashboard -- 治理控制台
• Docs -- 完整文档
• GitHub Action -- Marketplace 列表
• Quickstart -- 2 分钟上手
• npm -- CLI 软件包
• Pricing -- 免费套餐 + Pro

MIT 许可证