| name | graphify |
| description | Query the XerahS src knowledge graph for architecture, dependencies, and symbol relationships. Use when exploring how modules connect, finding paths between types, or orienting on unfamiliar areas of src/. |
graphify (XerahS)
Canonical graph lives at:
docs/architecture/graphify-out/
See README.
Full cross-agent kickoff prompt (copy-paste + skill/tool path index):
developers/guidelines/GRAPHIFY_AGENT_PROMPT.md
When to use
Use graphify first for:
- Architecture / "how does X connect to Y" questions
- Finding callers, dependents, or cross-project paths
- Orienting in an unfamiliar area of
src/
Do not block ordinary file edits or line-level debugging on graphify. After orientation, use Read/Grep as usual.
CLI
Repo-local binary (preferred):
G=.tools/graphify-venv/bin/graphify
GRAPH=docs/architecture/graphify-out/graph.json
If the venv is missing:
python3 -m venv .tools/graphify-venv
.tools/graphify-venv/bin/pip install -U pip graphifyy
Commands:
$G query "<question>" --graph "$GRAPH"
$G path "<A>" "<B>" --graph "$GRAPH"
$G explain "<concept>" --graph "$GRAPH"
$G affected "<symbol>" --graph "$GRAPH"
A root symlink graphify-out → docs/architecture/graphify-out may exist so default CLI paths work.
Human-readable entry points
docs/architecture/graphify-out/GRAPH_REPORT.md — hubs / god nodes / suggested questions
docs/architecture/graphify-out/GRAPH_TREE.html — lighter browser view
docs/architecture/graphify-out/graph.html — full force graph (large)
Rebuild
Full rebuild (preferred — scopes to src/, refreshes graph + tree + symlink):
scripts/update-graphify.sh
Incremental update (no --graph flag — path comes from the repo-root
graphify-out/ symlink. NEVER pass --graph to update; NEVER pass
. (whole-repo root) when you only want src/):
$G update src
After very large refactors, prefer the full scripts/update-graphify.sh
over an incremental update — the graph's clustering benefits from a clean
rebuild after structural changes.
Help caveat: graphify <subcommand> --help is unreliable; use
top-level graphify --help only.