---
name: vault-graph
description: Render the brain's knowledge graph and show it in chat BOTH ways at once — the Obsidian-style picture inline (every note a dot sized by its links, wikilinks as threads, folder-colored, force-laid-out on the near-black canvas) plus the live interactive pane (hover a node for its label + PEAK location + lit neighborhood, click to pin, drag/scroll to pan and zoom, ☰ folder legend). Wraps the engine's `graph_image` module, a headless port of the desktop app's 2D graph view (same scan as graph_get, same d3-force physics, same palette — plus a no-overlap pass, so no two notes ever render on top of each other). Use when the owner says "show me my brain", "show my graph", "graph my vault", "what does my brain look like", "render the knowledge graph", "interactive graph", "graph around <note>", "map my notes", or wants the picture for a deck, a post, or a progress note. Read-only against the notes (it writes only into the gitignored `.state/cache/`); NOT vault-health/vault-stats (those are numbers — this is the picture), NOT the desktop app's live Graph tab (offer it for extended exploring).
---

# vault-graph — folder-root adapter

The real playbook lives in the brain: **`Agent/skills/vault-graph.md`** (this folder
is the vault root). Read that file and follow it exactly as written, using the
shipped CLI at `.alexandria/app/.venv/bin/alexandria` wherever it says
`alexandria`, and `.alexandria/app/.venv/bin/python` for
`python -m alexandria_vault.…` entrypoints.

If `Agent/config.json` does not exist, nothing is installed yet — stop and
follow `./CLAUDE.md` (the installer) instead of this skill.
