Brain · Relationship graph

Relationship graph

See the brain as a graph, not a folder - the influence map that explains the codebase. Force-directed SVG graph of brain cross-references; node size scales with influence score.

See it in motion

Where to find it

  • Localhost: /relationship-graph.html?repo=<id>
  • API: GET /api/relationships?repo=<id>
  • Keyboard: ⌘ K then graph
  • Sidebar: Insights → Relationship graph

What it does for you

Hubs are visually obvious.CLAUDE.md, INDEX.md, and decisions.md become the big nodes in the center; tactical files cluster around them. You see the structure of the project's knowledge in one frame.
Orphans drift to the edge.Files with zero references fly off to the corners. If a file is supposed to matter and it's out there, that's a finding - probably nobody links to it from where it would actually be read.
Click any node, jump to the file.Each node deep-links to its rendered HTML twin. The graph is a launcher as much as a diagram.

Configure

Nothing - built from the same brain markdown as Relationship stats. Layout: a hand-rolled force-directed simulation in pure SVG (no D3, no framework). No client-side LLM. The graph reads up to 2,000 brain files per repo; edges are every cross-reference found among them.

Use it well

Open at the start of a new feature. Find the hub closest to the area you're changing; read it first. After the feature ships, re-open and check whether the new file gravitated toward the center or drifted to the edge.

Read more