Setup

Connect your repository

Add Decision Receipt to your GitHub repository in three steps. Every PR will be automatically evaluated and receive an admissibility verdict.

Step 1 — Get your API key

If you haven't already, sign up to get an API key.

Step 2 — Add GitHub Webhook

Add a webhook to your repository. You can do this via the GitHub UI or CLI:

Option A: GitHub CLI
gh webhook create --repo YOUR_ORG/YOUR_REPO \
  --events pull_request \
  --url https://decrec.summitcognitive.ai/v1/webhook/github
Option B: GitHub UI
  1. Go to your repo Settings > Webhooks > Add webhook
  2. Payload URL: https://decrec.summitcognitive.ai/v1/webhook/github
  3. Content type: application/json
  4. Events: select "Pull requests"
  5. Click "Add webhook"
Test it

Open a PR on your repo. Within seconds, check the ledger — you should see a new receipt.

Step 3 — Add the badge to your README

Show your admissibility status:

[![decrec](https://decrec.summitcognitive.ai/badge/repo/YOUR_ORG/YOUR_REPO.svg)](https://decrec.summitcognitive.ai)
Optional — GitHub Action (enforcement mode)

Block merges when admissibility fails:

name: Decision Receipt
on:
  pull_request:

jobs:
  admissibility:
    runs-on: ubuntu-latest
    steps:
      - uses: summitcognitive/decision-receipt/github-action@v1
        with:
          api-url: https://decrec.summitcognitive.ai
          fail-on-block: "true"
Optional — SDK integration
import { DecRec } from "@summit-dr/sdk";

const dr = new DecRec({ apiKey: "sk_decrec_..." });

const result = await dr.evaluatePR({
  repository: "your-org/your-repo",
  pr: 42,
  commit: "abc123",
  branch: "feat/thing",
  agent: "devin",
  ciPassed: true,
  reviewApproved: true,
});

if (result.receipt.admissibility.status !== "ACCEPTED") {
  throw new Error("Merge blocked: " + result.policy.reason);
}

Need help? brian@summitcognitive.ai | Full guide | API docs