### Install DiffCI via npx

Source: https://github.com/diffci/diffci.com/blob/main/docs/cursor.md

Run this command to install DiffCI. The init command writes .cursor/rules/diffci.mdc.

```bash
npx @diffci.com/diffci@latest init

```

--------------------------------

### Example import chains through barrel files

Source: https://github.com/diffci/diffci.com/blob/main/docs/vue-selection-provenance.md

Shows three example chains of imports that all pass through a package's src/index.ts, illustrating how any change in a package reaches the same barrel and thus the same dependents.

```text
style.ts          -> runtime-dom/src/patchProp.ts -> runtime-dom/src/index.ts -> reactivity/__tests__/ref.spec.ts
componentEmits.ts -> runtime-core/src/index.ts -> runtime-test/src/index.ts -> reactivity/__tests__/computed.spec.ts
errors.ts         -> compiler-core/src/index.ts -> compiler-core/__tests__/codegen.spec.ts
looseEqual.ts     -> shared/src/index.ts -> compiler-core/__tests__/codegen.spec.ts
```

--------------------------------

### Initialize DiffCI agent instructions

Source: https://github.com/diffci/diffci.com/blob/main/docs/ai-agents.md

Installs agent instruction files from a repository root. Writes AGENTS.md, CLAUDE.md, .cursor/rules/diffci.mdc, .github/copilot-instructions.md, and diffci.config.json. Existing files are kept; pass --force only when you intentionally want to replace them.

```bash
npx @diffci.com/diffci@latest init
```

--------------------------------

### GitHub Action workflow for DiffCI

Source: https://github.com/diffci/diffci.com/blob/main/docs/distribution.md

Installs DiffCI as a continue-on-error job in a GitHub Actions workflow. The example pins release v0.1.4 to its full commit SHA. The job is dedicated, read-only, and not required by other jobs.

```yaml
jobs:
  diffci:
    runs-on: ubuntu-latest
    continue-on-error: true
    permissions:
      contents: read
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - uses: DiffCI/DiffCI.com@dee4f7b938a7720d077c1124ef2ea050aa2625d6
```

--------------------------------

### Non-executable install refusal message

Source: https://github.com/diffci/diffci.com/blob/main/docs/ci-inference-02-result.md

Shows the exact refusal message emitted when an install command lacks a pinned dependency basis. It explains that without a lockfile or packageManager field any install command is irreproducible.

```text
install is not executable: missing "a pinned dependency basis (lockfile or packageManager field)"
```

--------------------------------

### Apply the schema with npm run product:migrate

Source: https://github.com/diffci/diffci.com/blob/main/docs/deployment-runbook.md

Runs the database migration for the product. It applies nine files in a fixed order, all with IF NOT EXISTS, so re-running is safe. Verify the command exits 0 and names all nine files.

```bash
npm run product:migrate -- --remote
```

--------------------------------

### Initialize and check DiffCI for monorepo

Source: https://github.com/diffci/diffci.com/blob/main/examples/agent-monorepo/README.md

Use npx @diffci.com/diffci@latest init --workflow to set up the workflow, then npx @diffci.com/diffci@latest check to run the check. This is the minimal instruction pattern for a monorepo using coding agents.

```bash
npx @diffci.com/diffci@latest init --workflow
```

```bash
npx @diffci.com/diffci@latest check
```

--------------------------------

### Start validation run

Source: https://github.com/diffci/diffci.com/blob/main/ops/validation-env/README.md

Starts a validation run with the specified run ID, job, source key, source SHA256, and agent key.

```bash
npm run validation:start -- --run-id hono-linux-01 --job hono-reproduction --source-key <sourceKey> --source-sha256 <sourceSha256> --agent-key <agentKey>
```