Wisegit
WiseGit is a local MCP server that reconstructs the "why" behind code decisions from git history — so AI agents respect what was intentional, not just what compiles.
The problem: LLMs treat all code equally. A manually-tested race condition fix (sleep(350)) and a broken stub look identical — both are just text. When Claude Code sees "find bugs," it removes the sleep. Production incident. The proof of intention exists in git history, but nobody extracts it.
What wisegit does:
-
Indexes your git history — walks every commit, parses diffs at the AST level using Tree-sitter (C#, TypeScript, JavaScript, Python, Go, Rust), classifies commits (STRUCTURED/DESCRIPTIVE/NOISE), and extracts decision intent.
-
Computes freeze scores — each function gets a 0–1 score derived from 7 signal categories: git history (reverts, age, contributor count), issue enrichment (Won't Fix/By Design from GitHub/GitLab), code structure (magic numbers, defensive patterns), test signals, structural importance (PageRank from call graph), Naur theory signals (institutional knowledge loss), and Aranda signals (timeline gaps, forgotten patterns).
-
Serves decision manifests via MCP — before any file edit, the AI agent calls
get_file_decisionsand sees which functions are FROZEN (don't touch without override), STABLE (proceed with caution), or OPEN (safe to modify). Theory holders show who on the team understands each function. -
Enables seamless overrides — when the AI needs to modify frozen code, it calls
create_overridewith a reason. The user approves with one click in Claude Code. The override is recorded in an append-only audit trail shared with the team via git.
8 MCP tools:
get_file_decisions— decision manifest with freeze scores, theory holders, override statusget_freeze_score— detailed score breakdown for a functionget_function_history— full chronological decision timelineget_theory_gaps— functions with no active theory holders (Naur death)get_branch_context— branch merge history and migration contextsearch_decisions— keyword search across all past decisionscreate_override— override frozen functions (user approves in UI)extract_intent— extract intent for NOISE commits using host LLM via MCP sampling
Key features:
- Zero config —
npx @sandip124/wisegit setupin any repo, that's it - SQLite database (no Docker, no PostgreSQL, no external services)
- Team support via
.wisegit/directory tracked by git (JSONL files merge cleanly) - AI-era commit origin detection (HUMAN / AI_REVIEWED / AI_UNREVIEWED)
- Theory holder tracking per function (healthy / fragile / critical risk levels)
- HTML codebase health report (
wisegit report) - Grounded in 12 published software engineering papers
Academic foundation: Naur (1985) theory building, Aranda & Venolia (2009) bug repository analysis, Kim et al. (2007) fault prediction from cached history, Ying et al. (2004) co-change mining, Giger et al. (2011) AST-level change analysis, Aryani et al. (2014) domain-based coupling, and 6 more.
Server Config
{
"mcpServers": {
"wisegit": {
"command": "npx",
"args": [
"-y",
"@sandip124/wisegit",
"serve"
]
}
}
}