A 3D visualization that replays your codebase's git history — commit by commit.
Holy Graph turns a git repository into a 3D scene: every source file is a glowing point, co-changing files link up, modules cluster, and hot files float above the plane. Not a git-log viewer — a semantic view of how your architecture grew.
# in any git repository
npx @cdli/holy-graphOpens the visualization in your browser at http://localhost:5173. To export a shareable single-file HTML:
npx @cdli/holy-graph --out viz.htmlPre-rendered animations of well-known codebases live at holygraph.cdli.ai.
- Points — source files. Colour = module (e.g.
apps/atlas), size = recent activity (decays over time), height = how hot the file is right now. - Dim lines — files in the same module that change together.
- Bright lines — cross-module co-change. These are the architectural bridges worth watching.
- Rings — bright: file was just born. Soft: file was just touched.
- Sparks along edges = signal rippling from a file touched in the current commit toward its strongest co-change neighbours.
- Beacons mark each module's home. Hover a point or beacon for details.
src/extract/walksgit log --numstat -M70%, resolves renames into stable file ids, and emits per-commit deltas plus cluster-cluster affinity todata.json.src/renderer/replays those deltas with time-based decay on activity and edge weights.- A d3-force-3d simulation lays clusters out seeded by affinity; a second sim places files inside each cluster. Three.js draws the scene.
Drop a holy-graph.config.js (or .mjs / .ts) next to your repo:
// holy-graph.config.mjs
export default {
port: 3000,
extract: {
maxFilesPerCommit: 40,
minFileTotalTouches: 3,
// exclude: [/\/fixtures\//, /\.generated\.ts$/],
},
};All keys are optional. CLI flags (--port, --since, --config) override config values.
| Setting | Effect |
|---|---|
port |
Dev server port (default: 5173, falls back if busy) |
extract.maxFilesPerCommit |
drop bulk-rewrite commits (default: 80) |
extract.minFileTotalTouches |
prune rarely-touched files (default: 2) |
extract.exclude |
path regexes to ignore (adds to defaults) |
Drag to orbit · scroll to zoom · right-drag to pan · play/scrub from the HUD · click a module chip to zoom into it · double-click anywhere to reset.
FSL-1.1-ALv2 — source-available, non-competing use permitted, auto-converts to Apache 2.0 on the second anniversary of each release.
Built by Fatih Burak Karagöz as part of CDLI — Intelligence for Developers · Insights for Products · Impact for Business. Source on github.com/cdliai/holy-graph.