devcontract

Evidence-backed Team Engineering Contract + guided AI workflows (Understand, Build), served over MCP stdio so Grok, Claude Code, Codex, Kiro, and Cursor share the same tools.

npx -y devcontract

Requires Node.js 22+ and git on PATH. Build plans need XAI_API_KEY (xAI / SpaceXAI). Understand is deterministic and works without a key.

Status

v0.1.0. Working now:

• npx -y devcontract — MCP stdio with dev.understand
• devcontract contract compile — Team Engineering Contract from git artifacts
• devcontract understand <path-or-ticket> — cited git history (no API key)

Still stubbed: init, build, approve, run.

Product overview: docs/PRODUCT.md
Design: docs/DESIGN.md

MCP clients

Claude Code / Cursor — .mcp.json or .cursor/mcp.json:

{
  "mcpServers": {
    "devcontract": {
      "command": "npx",
      "args": ["-y", "devcontract"]
    }
  }
}

Codex / Grok — project MCP config, command = "npx", args = ["-y", "devcontract"], startup_timeout_sec = 60.

Kiro — best-effort .kiro/settings/mcp.json (same JSON shape).

Put XAI_API_KEY in the host environment. Do not commit it.

CLI

npx -y devcontract              # MCP stdio (default)
npx -y devcontract --help
npx -y devcontract init
npx -y devcontract contract compile
npx -y devcontract understand <path-or-ticket>
npx -y devcontract build <ticket>
npx -y devcontract approve <runId>    # TTY only; not an MCP tool
npx -y devcontract run <runId> [--resume]

Develop

npm install
npm test
npm run build

License: Apache-2.0