Two code artifacts feed a comparison ring while an unverified claim is stopped and a proof receipt exits
Ground 0.4.3 · Free and open source

Give the agent evidence before it changes your codebase.

Ground computes evidence for TypeScript and JavaScript code claims. It also understands SvelteKit routes, aliases, component scripts, actions, stores, and entry points.

Choose your install
  • Languages TS + JS
  • Framework SvelteKit
  • Cost Free
Ground operating path

Verification belongs before the answer.

For developers: installation commands, how the checks work, and release evidence.

01 / 03 Connect

Put the check beside the agent.

Choose one client. These commands install the verified 0.4.3 release.

Claude CodeRegister Ground for the current user
claude mcp add --scope user --transport stdio ground -- npx --yes -p @createsomething/ground-mcp@0.4.3 ground-mcp
Cursor or WindsurfPaste into the client MCP configuration
{"mcpServers":{"ground":{"command":"npx","args":["--yes","-p","@createsomething/ground-mcp@0.4.3","ground-mcp"]}}}
Codex CLIRegister Ground as a local MCP server
codex mcp add ground -- npx --yes -p @createsomething/ground-mcp@0.4.3 ground-mcp
npmWorks with any MCP client
npm install -g @createsomething/ground-mcp@0.4.3

Persistent MCP sessions reuse parsed source and dependency graphs after checking current files and resolution settings. Restart your MCP server after upgrading. CLI commands stay uncached by default; use --cache to opt in or --no-cache to disable reuse.

Evidence
  • Four client-ready configurations
  • Commands remain visible without JavaScript
Receipts
FreeOpen sourceVersion 0.4.3
02 / 03 Verify

Check first. Then record. Ground blocks an unverified claim.

Ground requires a check before its claim tools can record a code finding.

  1. 01Check first

    Compare the files or count the uses.

  2. 02Then claim

    Attach the finding to what was checked.

  3. 03Blocked otherwise

    Stop an unsupported conclusion before it spreads.

# A claim without a prior comparison
ground claim duplicate utils.ts helpers.ts "same validation logic"
Claim blocked: compare these files first.

# Check first, then retry the claim
ground compare utils.ts helpers.ts

Ground gates its own claim tools; it cannot stop an agent from answering outside them. An unused export in the checked scope still needs review for public APIs, external consumers, and dynamic loading before removal.

Evidence
  • Check first
  • Then claim
  • Blocked otherwise
Receipts
Compared inputsEvidence-bound claim
03 / 03 Trust

Check the evidence before recording a finding.

Ground provides code checks for TypeScript, JavaScript, and SvelteKit projects.

Verify

  • ground_compareSee how similar two files actually are
  • ground_count_usesCount detected uses in the checked scope
  • ground_check_connectionsSee whether a module is connected
  • ground_check_environmentCatch runtime APIs in the wrong environment

Find problems

  • ground_find_duplicate_functionsFind copy-pasted code
  • ground_find_orphansFind files with no detected connection
  • ground_find_dead_exportsFind exports with no imports in the checked scope
  • ground_find_driftFind divergence from an owned pattern

Understand patterns

  • ground_adoption_ratioMeasure token or pattern adoption
  • ground_suggest_patternSuggest from the code already present
  • ground_mine_patternsDiscover repeated structures

Report findings

  • ground_claim_duplicateReport a verified duplicate
  • ground_claim_dead_codeReport verified dead code
  • ground_claim_orphanReport a verified orphan
Evidence
  • 21 MCP tools
  • Five verified platform installs
  • Public calibration policy
Receipts
Checksums + provenanceAdjudicated findings ledger
Read the Kickstand audit
Ground handoff

Put evidence before the next code claim.

Install Ground in one agent client, run a real verification, and preserve the checked inputs with the finding.

Install Ground from npm Inspect the source
Owner
Codebase operator
Authority
Verify-before-claiming policy
Proof
Checked inputs + finding
State
ready

Ground is part of the product family.