ggg edit
ggg edit [--with-export-templates] [<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.
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.
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.
- 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.