Build Code Knowledge Graph
Build or update the .gauntlet/graph.db knowledge graph
for the current codebase.
Steps
Detect target: Use the current working directory
or a user-specified path.
Check for existing graph: If .gauntlet/graph.db
exists, run an incremental update. Otherwise, run a
full build.
Run the build script:
For full build:
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/graph_build.py <dir>
For incremental update:
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/graph_build.py <dir> --incremental
Report results: Show the JSON output including
files parsed, nodes created, edges created, and
duration.
Suggest next steps: Recommend searching the graph
or running blast radius analysis.
When To Use
- At the start of a session to build structural awareness
- After significant code changes to update the graph
- Before running blast radius analysis or flow tracing
- When the user asks about codebase structure
What Gets Parsed
The graph extracts nodes (File, Class, Function, Type,
Test) and edges (CALLS, IMPORTS_FROM, INHERITS, CONTAINS,
IMPLEMENTS, TESTED_BY) from 20+ languages including
Python, JavaScript, TypeScript, Go, Rust, Java, C/C++,
Ruby, and PHP.
Storage
- Database:
.gauntlet/graph.db (SQLite with WAL mode)
- Auto-creates
.gauntlet/.gitignore to prevent commits
- Incremental updates use SHA-256 hashing to skip
unchanged files
1---2name: graph-build3description: Builds or updates the code knowledge graph via tree-sitter AST and SQLite. Use when setting up the graph before search or blast-radius analysis.4---5
6# Build Code Knowledge Graph
7
8Build or update the `.gauntlet/graph.db` knowledge graph
9for the current codebase.
10
11## Steps
12
131. **Detect target**: Use the current working directory
14 or a user-specified path.
15
162. **Check for existing graph**: If `.gauntlet/graph.db`
17 exists, run an incremental update. Otherwise, run a
18 full build.
19
203. **Run the build script**:
21
22 For full build:
23 ```bash
24 python3 ${CLAUDE_PLUGIN_ROOT}/scripts/graph_build.py <dir>
25 ```
26
27 For incremental update:
28 ```bash
29 python3 ${CLAUDE_PLUGIN_ROOT}/scripts/graph_build.py <dir> --incremental
30 ```
31
324. **Report results**: Show the JSON output including
33 files parsed, nodes created, edges created, and
34 duration.
35
365. **Suggest next steps**: Recommend searching the graph
37 or running blast radius analysis.
38
39## When To Use
40
41- At the start of a session to build structural awareness
42- After significant code changes to update the graph
43- Before running blast radius analysis or flow tracing
44- When the user asks about codebase structure
45
46## What Gets Parsed
47
48The graph extracts nodes (File, Class, Function, Type,
49Test) and edges (CALLS, IMPORTS_FROM, INHERITS, CONTAINS,
50IMPLEMENTS, TESTED_BY) from 20+ languages including
51Python, JavaScript, TypeScript, Go, Rust, Java, C/C++,
52Ruby, and PHP.
53
54## Storage
55
56- Database: `.gauntlet/graph.db` (SQLite with WAL mode)
57- Auto-creates `.gauntlet/.gitignore` to prevent commits
58- Incremental updates use SHA-256 hashing to skip
59 unchanged files
majiayu000