ggg edit
ggg edit [--with-export-templates] [--godot <path>] [<godot-args>...]Opens the current project in the Godot editor using the version declared in ggg.toml. If that version is not yet cached, it is downloaded first. A different executable can be supplied with --godot or GGG_GODOT_EXECUTABLE instead.
This is the standard way to open a project managed by Godot Goodie Grabber. Using ggg edit instead of launching Godot directly ensures you are always using the exact version the project requires.
Usage
ggg editRun this from your project directory. Godot opens with the current project loaded. When you close the editor, the terminal prompt returns.
ggg flags must come before any Godot arguments. Any arguments after the ggg flags are forwarded verbatim to Godot:
ggg edit --verbose
ggg edit --rendering-method gl_compatibility
ggg edit --with-export-templates --verboseFlags
--with-export-templates: download and install export templates for the declared Godot version before opening the editor, regardless of the export_templates setting in ggg.toml. Does not modify ggg.toml.
If export_templates = true is set in ggg.toml, templates are always ensured without needing this flag.
--godot <path>: use the Godot executable at <path> instead of the managed version declared in ggg.toml. No engine is downloaded or cached. The path must exist and be a regular file, otherwise ggg edit fails with an error naming the flag. When this flag is set it takes precedence over the GGG_GODOT_EXECUTABLE environment variable.
Notes
- Requires a
ggg.tomlin the current directory. - Downloads and caches the declared Godot version on first run. Subsequent runs start immediately from the cache. (Without a
--godotflag orGGG_GODOT_EXECUTABLEoverride.) - The Godot binary is shared across all your projects in a single cache directory. See the cache reference for the cache location and how to manage it.
ggg editdoes not runggg syncfirst. If you have just added or updated dependencies, runggg syncbefore opening the editor.