dsh-obsidian

Obsidian's graph view is a joy to explore, yet it knows nothing about the repositories scattered across your machine. It only indexes Markdown notes and [[wiki links]] inside a vault, so turning a forest of codebases into a readable knowledge graph still means writing every note and edge by hand. dsh-obsidian removes that friction: open Settings, press Scan Projects, then Generate Knowledge Graph, and the plugin takes care of the rest. It auto-detects projects through manifests (package.json, Cargo.toml, go.mod, pyproject.toml, .git), extracts their dependencies, tech stack, root-directory areas, and keyword topics, and wires up every edge with fully deterministic rules. No hallucinated relationships, no black-box heuristics.

Once generated, the notes are plain .md files that Obsidian picks up the instant you open the vault. Hub pages under graph/, tech/, areas/, and topics/ naturally become cluster centroids in the graph view, while dependencies appear as connecting edges. A single index note ties the entire structure together. Writes go through the Obsidian Local REST API when the app is running, or simply fall back to the filesystem when it is idle. A dedicated state file tracks incremental changes so only plugin-managed files are ever rewritten or removed. A compact force-directed preview lives in the DSH settings tab for a quick dependency sanity check, and the entire pipeline runs offline. No data ever leaves your machine.

The ideal user is someone who already treats Obsidian as a second brain and keeps several local codebases in active rotation. dsh-obsidian bridges the gap between repository metadata and a living, link-rich knowledge graph, all within the DSH Web profile and without a single outbound network call.