Queryable repository meaning with receipts.
git-mind is a Git-native semantic intelligence layer for software repositories.
It exists to establish, infer, review, and surface semantic relationships between project artifacts such as:
- code
- docs
- ADRs
- tasks
- reviews
- issues
- commits
It keeps that knowledge in Git/WARP so it can be replayed, diffed, reviewed, and queried over time.
git-mind is not a personal thought-capture tool.
That thesis now lives in think.
git-mind is for the moment when you need to answer questions like:
- what implements this spec?
- what ADR explains this module?
- what issues and reviews shaped this area?
- what changed semantically between these two points in time?
- what does this repository actually mean, beyond its files?
Its job is to make repository meaning more explicit and less dependent on tribal knowledge, grep archaeology, and memory.
Today, git-mind already provides a substantial graph substrate:
- repo-native graph storage on top of Git/WARP
- typed relationships and node metadata
- views and lenses over the graph
- import/export paths
- time-travel and semantic diff
- AI-assisted suggestion and review workflows
- content-on-node
- extension support
The next hill is not "more graph features."
The next hill is:
- point
git-mindat a repository and get an immediately useful semantic map with provenance-backed answers, with as little manual input as possible
That is the make-or-break product test from here.
# Install
npm install -g git-mind
# Initialize in a Git repository
cd /path/to/your/repo
git mind init
# Seed relationships from existing markdown docs where possible
git mind import --from-markdown "docs/**/*.md"
# Inspect the semantic graph
git mind nodes
git mind view architecture
git mind status
# Surface candidate relationships for review
git mind suggest
git mind review
# Compare repository meaning over time
git mind diff HEAD~10..HEADManual edge creation remains supported, but it should increasingly be treated as refinement or override rather than the only path to value:
git mind link file:src/auth.js spec:auth --type implements
git mind link adr:0007 task:auth-rollout --type blocks- Low-input semantic bootstrap matters.
- Inference should precede heavy manual curation.
- Provenance must back meaningful assertions.
- Review should refine the map, not create it from scratch.
- The graph is the substrate, not the user's main mental model.
- Queryable value matters more than graph elegance.
git-mind is not:
- a personal capture product
- a reflective journal
- a manually maintained project wiki
- a generic PKM system
- a graph toy with no clear engineering question behind it
git-mind is built on @git-stunts/git-warp, which gives it:
- causal history
- deterministic replay
- conflict-free graph merging
- branch and merge semantics for knowledge state
- Git-native persistence without an external database
Those are not the product by themselves. They are what make provenance-backed repository intelligence possible.
Current package version: 5.0.0.
The repository is in a stabilize-and-clarify phase:
- the inward-facing cognition thesis has moved to
think git-mindis being narrowed around semantic repository intelligence- existing graph capabilities remain real and useful
- future work should be judged against the low-input semantic bootstrap hill
Canonical docs: