Skip to main content
Glama

did-it

Stop letting coding agents congratulate themselves.

When a coding agent finishes a task, you review a summary the agent wrote about itself. Research on 5,851 real developer sessions found that those self-reports referred to about one action in eleven — and a reader working from the report alone recovered roughly a fifth of the action log (arXiv:2609.12205).

did-it is the missing gate: an autonomous self-auditing MCP server. The agent must call verify_claimed_actions against your Git working tree before it is allowed to say "Done." Ghost claims are a hard rejection. The user never sees a victory lap that Git cannot back.

Agent finishes coding
        ↓
.cursorrules mandates verify_claimed_actions
        ↓
MCP tool checks git status / diff
        ↓
Ghost claims → 🛑 hard rejection (fix or admit failure)
Verified    → ✅ completion allowed

30-second verification

git clone https://github.com/preprint-labs/did-it.git
cd did-it
npm install
npm test
npm run build
node dist/index.js --cli --text "I created src/index.ts"

You should see a receipts table, an honesty score, and can_report_completion: true|false. Exit code 1 means a ghost claim.


Related MCP server: execution-proofs

Install in Cursor (mcp.json)

Add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (user):

{
  "mcpServers": {
    "did-it": {
      "command": "node",
      "args": ["<FULL_PATH_TO_DID_IT>/dist/index.js"]
    }
  }
}

Point args at your built dist/index.js. Windows example: "C:\\path\\to\\did-it\\dist\\index.js". In this repo, .cursor/mcp.json uses a relative dist/index.js so no machine-specific absolute path is committed.

The server audits process.cwd() of the host workspace (the project the agent is editing), not the did-it repo itself. Override with DID_IT_WORKSPACE if needed.

2-line rule (paste into .cursorrules)

Before declaring a task complete or outputting your final summary, you MUST call `verify_claimed_actions` with a list of all changes you claim to have made. If any ghost claims are flagged, you must execute the missing changes before responding to the user.

Claude Code

claude mcp add did-it -- node "<FULL_PATH_TO_DID_IT>/dist/index.js"

Or in ~/.claude.json / project MCP config:

{
  "mcpServers": {
    "did-it": {
      "command": "node",
      "args": ["<FULL_PATH_TO_DID_IT>/dist/index.js"]
    }
  }
}

Windows example: "C:\\path\\to\\did-it\\dist\\index.js".

Add the same 2-line rule to CLAUDE.md.


GitHub Copilot (VS Code)

mcp.json in .vscode/mcp.json or your Copilot MCP settings:

{
  "servers": {
    "did-it": {
      "command": "node",
      "args": ["<FULL_PATH_TO_DID_IT>/dist/index.js"]
    }
  }
}

MCP tools

Tool

What it does

verify_claimed_actions({ claims: string[] })

Audit claimed edits/creates/deletes/installs against git status --porcelain, git diff --name-only, and git diff --staged --name-only. Ghost claims return a hard rejection.

inspect_actual_changes()

Raw list of files that actually changed. Use this instead of guessing.

Hard rejection text:

🛑 [did-it Verification Failed]: You claimed to have completed tasks that have zero evidence in Git: ${ghost_claims}. You are PROHIBITED from reporting completion to the user until these actions are physically executed or explicitly admitted as failed.

honesty_score is verified / (verified + ghost) in [0.0, 1.0]. UNVERIFIABLE rows (e.g. "ran tests" with no artifact) are shown but excluded. can_report_completion is true iff there are zero ghost claims.


CLI fallback

MCP is primary. For a one-off local audit:

node dist/index.js --cli
node dist/index.js --cli --text "I updated src/index.ts and created src/ghost.ts"
echo "created README.md" | node dist/index.js --cli

--cli with no claims prints the real uncommitted file list. --root <path> sets the workspace.


Cite

@article{kraishan2026plans,
  title   = {Plans They Abandon, Reports They Author: The Narrative Layer of Autonomous Agents},
  author  = {Kraishan, Obada and Jitkajornwanich, Kulsawasd},
  journal = {arXiv preprint arXiv:2609.12205},
  year    = {2026}
}

License

MIT

Available Tools

2 tools
inspect_actual_changesA

Return the raw list of files that are actually modified, created, deleted, or untracked in Git. Use this instead of guessing what changed.

Inputs: no named parameters.

verify_claimed_actionsA

Verify a list of claimed coding actions against the local Git working tree before reporting completion. Call this with every file you claim to have created, edited, deleted, or every package you claim to have installed. Ghost claims are a hard rejection: you must execute the missing work or admit failure before the user sees a completion summary.

Inputs: claims (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have clearly distinct purposes: one inspects raw Git changes, the other verifies claimed actions against the working tree. No overlap or ambiguity; an agent can easily select the right tool.

    Naming Consistency5/5

    Both tool names follow a consistent verb_noun pattern: 'inspect_actual_changes' and 'verify_claimed_actions'. The verbs are descriptive and the structure is uniform.

    Tool Count4/5

    With only 2 tools, the server feels minimal, but its purpose is narrowly scoped to Git verification. The two tools cover the core inspection and verification workflows, so the count is appropriate for the domain, though it edges toward thinness.

    Completeness5/5

    The tool surface fully covers the server's stated purpose of checking actual Git state and verifying claims against it. There are no obvious dead ends or missing operations for this verification-focused domain; it provides the essential inspect and verify capabilities.

    Related MCP Connectors

    Related MCP Servers