Ground

Grounded claims for code. You can't claim something until you've checked it.

---

The Problem

AI agents are confident. Too confident.

They'll tell you two files are "95% similar" without ever comparing them. They'll declare code "dead" without checking who uses it.

The Solution

Ground requires you to check before you claim:

# First, compare the files
ground compare utils.ts helpers.ts

# Then, make a claim (only works if you've compared)
ground claim duplicate utils.ts helpers.ts "same validation logic"

If you try to claim without checking first, Ground blocks you.

---

Install

# From source
git clone https://github.com/createsomethingtoday/create-something-monorepo.git
cd create-something-monorepo/packages/ground
cargo build --release

Source

Ground is developed in the CREATE SOMETHING monorepo.

Commands

Command	What it does
ground compare <a> <b>	Compare two files for similarity
ground count uses <symbol>	Count how many times something is used
ground check connections <module>	Check if a module is connected
ground find duplicates [path]	Find duplicate code
ground claim duplicate <a> <b>	Claim files are duplicates
ground claim dead-code <symbol>	Claim code is dead
ground claim orphan <module>	Claim module is orphaned

MCP Integration

Ground exposes tools via the Model Context Protocol for AI coding assistants:

• ground_compare — Compare two files
• ground_count_uses — Count symbol uses
• ground_check_connections — Check module connections
• ground_claim_duplicate — Claim files are duplicates
• ground_claim_dead_code — Claim code is dead
• ground_claim_orphan — Claim module is orphaned

Philosophy

Based on Heidegger's concept of Grund (ground, foundation): nothing exists without reason.

Applied to code analysis: no claim without evidence.

License

MIT