What changed, by meaning, and what it breaks
godot_diffCompares Godot files by meaning instead of raw text, listing added, removed, moved, or changed nodes, properties, scripts, settings, and shaders while flagging references to removed items.
Instructions
A diff you can read, against git (default: the files on disk against HEAD), offline. A text diff of a .tscn is mostly noise (ids renumbered, sections moved); this compares what the files mean. Scenes and resources: nodes added, removed, moved or renamed, each changed property with resource ids resolved to paths and a changed sub-resource opened up (shape.radius 12 -> 16), groups, children reordered (the 2D draw order), connections, what the file loads; a file whose text changed but not its meaning is one line. Scripts: functions, signals, variables, constants and enums added, removed or changed, and the functions whose code changed. project.godot: settings, input actions and autoloads. Shaders: uniforms and functions. And for everything removed, what still uses it, marked !: a scene connection to a function that is gone (an error at load), an @export value still saved in a scene (dropped silently), a material that still sets a removed uniform, an input action or autoload code still asks for, callers of a function whose argument count changed, files that name a deleted file. Run it after a set of edits and before you call the work done, to check you changed only what you meant to; ref and to compare other commits (a review of a branch), against compares one file with another without git. It is an error when something is marked !. Read-only.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "godot_diff"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | a second commit: compare two commits instead of a commit with the files on disk | |
| ref | No | the commit to compare with (default HEAD), e.g. HEAD~1 or main | |
| path | No | project folder, or a file or folder inside it (relative to the server's folder; default: the current project) | |
| files | No | only these res:// files or folders (default: everything that changed) | |
| detail | No | brief (capped lists) or full (everything); default full | |
| against | No | with exactly one file in files: the earlier version as another file, instead of git |