build-graph

Build Graph

Build or incrementally update the persistent code knowledge graph for this repository.

Steps

1. 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.

2. 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)

3. 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)