╔══════════════════════════════════════════════════╗

   ██████╗ ██╗   ██╗
  ██╔════╝ ██║   ██║
  ██║  ███╗██║   ██║
  ██║   ██║╚██╗ ██╔╝
  ╚██████╔╝ ╚████╔╝
   ╚═════╝   ╚═══╝

  GRAPHIFY OBSIDIAN VISUALIZER
  Obsidian plugin  ·  Graphify bridge  ·  embed graph.html

╚══════════════════════════════════════════════════╝

Graphify Obsidian Visualizer

Browse Graphify knowledge graphs inside Obsidian — catalog cache maps, embed official graph.html, keep Node Info 1:1 with the web viewer.

Companion to Graphify by Graphify Labs. This plugin is a viewer bridge 🗂️ — it does not analyze code.

Website · Upstream CLI / skill · App early access

Compatible with

  

Obsidian · Graphify

Why this exists

Graphify turns a codebase into a queryable knowledge graph (graph.html + graph.json). You already open that HTML in a browser.

Graphify Obsidian Visualizer puts the same official viewer next to your notes:

Feature	What you get
📚 Catalog	Lists every slug under ~/.cache/graphify-lupa with json/html flags, node counts, code root
🖼️ Embed	Official Graphify graph.html inside an Obsidian leaf (communities legend + Node Info)
🌐 Browser escape hatch	One click opens the same HTML in the system browser
🗂️ Filing cabinet	Obsidian indexes and opens maps — Graphify CLI still cooks them

Catalog view — pick a cache slug, then embed or open in browser.

What it is not

• Not Obsidian’s built-in note graph
• Not a vault-wide indexer or second Graphify engine
• Not tree-sitter / Python analysis (that stays in upstream Graphify)
• Not mobile Refresh (desktop / Electron only)

How the bridge works

Software repo → Graphify CLI → ~/.cache/graphify-lupa → this plugin embeds graph.html in Obsidian.

Architecture: docs/ARCHITECTURE.md · decisions: docs/DECISIONS.md · diagram source: docs/assets/bridge-architecture.excalidraw

Upstream

Resource	URL
Origin repo	github.com/Graphify-Labs/graphify
Product site	www.graphify.com
Platform login	app.graphify.com

Install Graphify first (uv tool install graphifyy → graphify install → /graphify . in your assistant). Then use this plugin to browse the resulting maps in Obsidian.

Status

Phase	State
Fase 0 — ItemView scaffold	✅ Done
Fase 1 — catalog of cache graphs	✅ Done
Fase 2 — open graph.html in browser	✅ Done
Fase 3 — embed official graph.html in Obsidian	✅ Done
Fase 4 — Refresh via CLI subprocess	🔜 Next

Track: docs/ROADMAP.md

🚀 Quick start

git clone git@github.com:crafter-station/graphify-visualizer.git
cd graphify-visualizer/plugin
bun install && bun run build
# symlink plugin/ → <vault>/.obsidian/plugins/graphify-visualizer

Enable Graphify Obsidian Visualizer in Obsidian → command Open Graphify Obsidian Visualizer.

Expect maps at:

~/.cache/graphify-lupa/<slug>/graphify-out/graph.html

Details: plugin/README.md

Repo map

graphify-visualizer/
├── README.md
├── AGENTS.md
├── LICENSE
├── docs/                 # architecture, ADRs, roadmap, brand assets
├── Development-Log/
└── plugin/               # Obsidian plugin (esbuild → main.js)

Topics / search keywords

obsidian · obsidian-plugin · graphify · knowledge-graph · code-map · graph-visualization · pkm · typescript · desktop

Contributing

Issues and PRs welcome on docs, bridge UX, and schema mismatches against real graph.json / graph.html.

Agent rules: AGENTS.md

License

MIT — plugin code. Graphify itself is owned by Graphify Labs; this repo only embeds their generated graph.html.

---

with 🖤 by TheVeller & Crafter Station