CodeGraph Tools transforms any codebase, document collection, or binary into a fully interactive, queryable knowledge graph — right inside VS Code.
Whether you're onboarding to a large repo, auditing an unknown binary, or exploring architectural dependencies, CodeGraph Tools gives you a visual and conversational interface to understand your code at any scale.
Features
Knowledge Graph Visualization
- Interactive graph viewer with pan, zoom, search, filters, and minimap
- Shortest-path highlighting between any two nodes
- Snapshot diff to see what changed between graph builds
- Community explorer to navigate logical groupings of nodes
AI-Powered Graph Queries
- Ask natural language questions grounded in your actual codebase graph
- Saved query history for recurring investigations
- Audit report generation from graph data
Smart Code Integration
- CodeLens overlays linking graph nodes back to source locations
- Inline decorations and diagnostics tied directly to source files
- Path explorer to trace relationships between any two nodes
Watch Mode & Incremental Builds
- Auto-rebuild graph on file save with configurable debounce
.codegraphignore support to exclude irrelevant paths- Rebuild notifications and snapshot retention
Binary & Security Analysis (Optional)
- Ghidra integration for binary analysis and reverse engineering
- Symbol browsing, decompiled function review, and binary diffing
- Vulnerability surfacing from binary inspection
Export Options
- Export graph as SVG, PNG, GraphML, or Neo4j Cypher
Requirements
| Requirement |
Notes |
| VS Code ^1.85 |
Required |
| Python 3.9+ |
Required for analysis engine |
pip install codegraph-tools |
Python analysis library |
| Ghidra |
Optional — only needed for binary analysis |
GHIDRA_INSTALL_DIR env var |
Set to Ghidra install path for binary features |
Installation
1. Install the extension
Install CodeGraph Tools from the VS Code Marketplace.
2. Install the Python engine
Open the Command Palette (Ctrl+Shift+P) and run:
CodeGraph: Install Skill (Copilot/Codex/Claude)
Or install manually:
pip install codegraph-tools
3. Analyze your code
Right-click any folder in the Explorer → CodeGraph: Analyze This Folder
Or press Ctrl+Shift+G
The interactive graph opens automatically in your browser.
4. Query the graph
Press Ctrl+Shift+Q and ask anything:
- Which modules are most connected to the auth system?
- What calls into the database layer?
- Show me all functions that handle file I/O.
5. Analyze a binary with Ghidra
Open the Command Palette and run:
CodeGraph: Analyze Binary with Ghidra
Select your .exe / .so / .elf — Ghidra runs headlessly, results appear in the Ghidra Symbols panel with source links.
Commands Reference
| Command |
Shortcut |
Description |
CodeGraph: Analyze This Folder |
Ctrl+Shift+G |
Full graph build of selected folder |
CodeGraph: Update Graph (incremental) |
— |
Rebuild only changed files |
CodeGraph: Query the Graph |
Ctrl+Shift+Q |
Natural-language GraphRAG query |
CodeGraph: Open Graph Viewer |
— |
Open the last generated graph HTML |
CodeGraph: Analyze Binary with Ghidra |
— |
Ghidra headless analysis of a binary |
CodeGraph: What Changed in Binary Diff? |
— |
Semantic diff between two builds |
CodeGraph: Match Ghidra Symbol to Source |
— |
Map decompiled symbol → source file/line |
CodeGraph: Benchmark Token Reduction |
Ctrl+Shift+B |
Measure GraphRAG compression ratio |
CodeGraph: Install Skill |
— |
Install graph context into Copilot/Claude |
Extension Settings
| Setting |
Default |
Description |
codegraph.pythonPath |
"python" |
Path to Python executable |
codegraph.mode |
"fast" |
fast (AST only) or deep (AST + LLM) |
codegraph.autoOpenGraph |
true |
Auto-open graph after analysis |
codegraph.outputDir |
"codegraph-out" |
Output folder name |
codegraph.ghidraEnabled |
true |
Enable Ghidra binary analysis commands |
codegraph.watchOnSave |
true |
Rebuild graph on file save |
codegraph.watchDebounceMs |
2000 |
Debounce delay before rebuild (ms) |
Use Cases
Security Engineers & Malware Analysts
- Decompile suspicious binaries with Ghidra from inside VS Code
- Map decompiled symbols to known-safe source patterns
- Diff two versions of a binary to see what was patched (or backdoored)
- Visualize attack surface: all functions touching network, crypto, or file I/O
Software Architects
- Instantly visualize dependency sprawl in large monorepos
- Find circular dependencies and tightly-coupled modules
- Export GraphRAG JSON for LLM-assisted architecture review
AI / LLM Developers
- Install a graph "skill" into Copilot or Claude that represents your entire codebase
- Use the benchmark command to measure how much token cost you save with graph compression
- Query the graph instead of pasting raw source into prompts
Legacy Code Archaeology
- Build a semantic map of undocumented codebases
- Ask "what does this module actually do?" and get graph-grounded answers
- Trace call paths between any two nodes interactively
Output Files
After analysis, codegraph-out/ contains:
| File |
Description |
graph.html |
Interactive force-directed graph (opens in browser) |
graph.json |
GraphRAG-compatible semantic graph |
audit_report.md |
Auto-generated architecture audit |
communities.json |
Module community clusters |
snapshot_<timestamp>.json |
Point-in-time snapshot for diffing |
License
MIT — see LICENSE.
CodeGraph Tools is not affiliated with the NSA or the Ghidra project. Ghidra is a free and open-source reverse engineering tool developed by the NSA Research Directorate.
