gdscript-code-graph 1.0.1

CLI tool that analyzes GDScript codebases and produces a structured JSON graph of files, metrics, and relationships.

gdscript-code-graph

CLI tool that statically analyzes GDScript (Godot Engine) projects and outputs a structured JSON graph of files, code metrics, and inter-file relationships.

Installation

Requires Python 3.10+.

pip install gdscript-code-graph

Usage

# Analyze a Godot project (output to stdout)
gdscript-code-graph analyze <project-dir>

# Write output to a file
gdscript-code-graph analyze <project-dir> -o graph.json

# Custom repo name and directory exclusions
gdscript-code-graph analyze <project-dir> -o graph.json --repo-name my-game -e addons -e test

Options

Flag	Description
-o, --out	Output file path (default: stdout)
--repo-name	Repository name in output (default: directory name)
-e, --exclude	Directory names to exclude (repeatable)

Output

The output format is documented in simple-code-graph-viewer/docs/schema.md.