Skip to main content
Graph queries read the saved graph. Update it after changing the source to keep answers relevant.

Refresh code

For an assistant-driven incremental refresh that also considers document context:
The code and semantic paths have separate work and caching behavior. A code-only refresh does not replace a semantic refresh for changed documents.

Watch the project

Install the watch extra, then:
Or install git hooks:
The hooks refresh after commits, branch switches, merges and rebases, so git pull is covered whether it merges or rebases. They run in the background, so a query immediately after a commit or pull can briefly see the old graph.

Exclude unhelpful files

Graphify respects ignore files. Add a .graphifyignore at the repository root for project-specific exclusions:
.graphifyignore
graphify extract --no-gitignore opts out of Git’s ignore rules while retaining .graphifyignore. Use it only when ignored source belongs in the graph.

After a large refactor

Graphify has guards against accidentally replacing a graph with a smaller incomplete result. If you intentionally removed substantial source, inspect the warning, then explicitly allow the smaller graph:
Keep a copy of the old graph if you need to compare it. Regenerate visualizations with graphify export html after a refresh when necessary.

See the cache at work

These examples come from a code-only graph of the open-source httpx repository, built with Graphify CLI 0.9.97. Your counts will differ. The first run of update re-extracted only the files that weren’t already cached:
After a one-line edit, the next run extracted a single file:
When communities shift, Graphify renames them after their hub node. Run graphify label if you want an LLM to name them again. graphify extract without --force is incremental too:

Flags

Troubleshooting

error: watchdog not installed. Run: pip install watchdog. graphify watch needs the watch extra:
error: path not found. The path you passed doesn’t exist. Run update from the project root, or pass the root path. The node count dropped after a refactor. If the rebuild has fewer nodes, update won’t overwrite graph.json unless you pass --force. That stops a partial checkout from wiping the graph.

FAQ

Does update re-read documents? No. It re-extracts code without an LLM. For document, paper and image changes, run /graphify --update in your assistant.

Next steps

Try it in Graphify

We build and host the graph for you. The Free plan (up to 3 repositories) needs no card. Pro and Teams start with a 14-day trial, card required.

Repositories and builds

How Graphify indexes and rebuilds repositories.

Record useful findings

Save what you learn next to the graph.