| name | build-graph |
| description | Build or update the code review knowledge graph. Run this first to initialize, or let hooks keep it updated automatically. |
| argument-hint | [full] |
Build Graph
Build or incrementally update the persistent code knowledge graph for this repository.
Steps
-
Check graph status by calling the list_graph_stats MCP tool.
- If the graph has never been built (last_updated is null), proceed with a full build.
- If the graph exists, proceed with an incremental update.
-
Build the graph by calling the build_or_update_graph MCP tool:
- For first-time setup:
build_or_update_graph(full_rebuild=true)
- For updates:
build_or_update_graph() (incremental by default)
-
Verify by calling list_graph_stats again and report the results:
- Number of files parsed
- Number of nodes and edges created
- Languages detected
- Any errors encountered
When to Use
- First time setting up the graph for a repository
- After major refactoring or branch switches
- If the graph seems stale or out of sync
- The graph auto-updates via hooks on edit/commit, so manual builds are rarely needed
Notes
- The graph is stored as a SQLite database (
.claudette/graph.db) in the repo root
- Binary files, generated files, and patterns in
.claudetteignore are skipped
- Supported languages: Python, TypeScript/JavaScript, Go (more coming incrementally)