basemind-git-history — git intelligence over the index
basemind indexes git history and resolves blame and diffs at symbol resolution, backed by a
gix history index. History queries return commits, authors, paths, and line/symbol attributions —
structured and capped — for a fraction of the cost of parsing git log / git blame output.
basemind first, naked git fallback. Prefer these tools over shelling out to git log,
git blame, or git diff. Drop to raw git only when no tool covers the question (e.g. staging,
rebasing, anything that mutates history).
Tool routing
| Question |
MCP tool |
CLI |
| "What changed recently?" |
git { mode: "recent" } |
basemind git recent [--limit N] |
| "Which commits touched path P?" |
git { mode: "touching", path: P } |
basemind git touching P |
| "Path-filtered commit log?" |
git { mode: "by_path", pattern: P } |
basemind git by-path P |
| "When did symbol X last change?" |
git { mode: "symbol_history", path: F, name: X } |
basemind git symbol-history F X |
| "Who wrote this line?" |
git { mode: "blame", path: F } |
basemind git blame F |
| "Who wrote this symbol / when did its body change?" |
git { mode: "blame_symbol", path: F, name: X } |
basemind git blame-symbol F X |
| "Diff a file between revs?" |
git { mode: "diff", path: F, rev_old, rev_new } |
basemind git diff F old new |
| "What symbols did a branch add/remove?" |
git { mode: "diff_outline", path: F, rev } |
basemind git diff-outline F [--rev] |
| "Where's the churn?" |
git { mode: "churn" } |
basemind git churn [--top-k N] |
| "What's dirty in the working tree?" |
git { mode: "status" } |
basemind git status |
| "What's HEAD / branch / origin?" |
admin { mode: "repo" } |
basemind admin repo |
| "Full-text search commit messages + authors?" |
git { mode: "search", pattern: "…" } |
basemind git search "…" |
Examples
git { mode: "recent", limit: 5 }
→ 612df7e chore(release): v0.15.0
1779b99 fix(git-history,serve): address code-review findings
...
git { mode: "blame_symbol", path: "src/scanner.rs", name: "process_file" }
→ last touched by <author> in <commit> — body hash changed at HEAD~7
git { mode: "diff_outline", path: "src/mcp/tools.rs", rev: "HEAD~5" }
→ + search_history (function) - old_helper (function)
Notes
- Git tools require
basemind serve to be running inside a git repository. Outside a git repo
they return a clear error.
- History queries are indexed:
git mode touching and friends resolve in tens of microseconds vs a
live walk. The index auto-builds on first use and is a fraction of the size of .git.
- All paths are repository-relative with forward-slash separators. Lists are capped
(
limit, default 100, max 1000).
For code structure see basemind-code-search; for document RAG and semantic search see
basemind-documents; for agent coordination see basemind-comms.
1---2name: basemind-git-history3description: Explore git history without shelling out to git — recent commits, commits touching a path, per-line and per-symbol blame, structural diffs across revisions, churn ranking, and a symbol's history over time. Reach for it whenever the user asks "what changed recently", "who last touched this", "when did this symbol change", "what's the diff between these revs", or "where's the churn".4---56# basemind-git-history — git intelligence over the index78basemind indexes git history and resolves blame and diffs at **symbol** resolution, backed by a9`gix` history index. History queries return commits, authors, paths, and line/symbol attributions —10structured and capped — for a fraction of the cost of parsing `git log` / `git blame` output.1112**basemind first, naked git fallback.** Prefer these tools over shelling out to `git log`,13`git blame`, or `git diff`. Drop to raw git only when no tool covers the question (e.g. staging,14rebasing, anything that mutates history).1516## Tool routing1718| Question | MCP tool | CLI |19|---|---|---|20| "What changed recently?" | `git { mode: "recent" }` | `basemind git recent [--limit N]` |21| "Which commits touched path P?" | `git { mode: "touching", path: P }` | `basemind git touching P` |22| "Path-filtered commit log?" | `git { mode: "by_path", pattern: P }` | `basemind git by-path P` |23| "When did symbol X last change?" | `git { mode: "symbol_history", path: F, name: X }` | `basemind git symbol-history F X` |24| "Who wrote this line?" | `git { mode: "blame", path: F }` | `basemind git blame F` |25| "Who wrote this symbol / when did its body change?" | `git { mode: "blame_symbol", path: F, name: X }` | `basemind git blame-symbol F X` |26| "Diff a file between revs?" | `git { mode: "diff", path: F, rev_old, rev_new }` | `basemind git diff F old new` |27| "What symbols did a branch add/remove?" | `git { mode: "diff_outline", path: F, rev }` | `basemind git diff-outline F [--rev]` |28| "Where's the churn?" | `git { mode: "churn" }` | `basemind git churn [--top-k N]` |29| "What's dirty in the working tree?" | `git { mode: "status" }` | `basemind git status` |30| "What's HEAD / branch / origin?" | `admin { mode: "repo" }` | `basemind admin repo` |31| "Full-text search commit messages + authors?" | `git { mode: "search", pattern: "…" }` | `basemind git search "…"` |3233## Examples3435```text36git { mode: "recent", limit: 5 }37→ 612df7e chore(release): v0.15.038 1779b99 fix(git-history,serve): address code-review findings39 ...4041git { mode: "blame_symbol", path: "src/scanner.rs", name: "process_file" }42→ last touched by <author> in <commit> — body hash changed at HEAD~74344git { mode: "diff_outline", path: "src/mcp/tools.rs", rev: "HEAD~5" }45→ + search_history (function) - old_helper (function)46```4748## Notes4950- Git tools require `basemind serve` to be running **inside a git repository**. Outside a git repo51 they return a clear error.52- History queries are indexed: `git` mode `touching` and friends resolve in tens of microseconds vs a53 live walk. The index auto-builds on first use and is a fraction of the size of `.git`.54- All paths are repository-relative with forward-slash separators. Lists are capped55 (`limit`, default 100, max 1000).5657For code structure see `basemind-code-search`; for document RAG and semantic search see58`basemind-documents`; for agent coordination see `basemind-comms`.
goldziher