ggg run

ggg run [<godot-args>...]

Runs the current project using the Godot version declared in ggg.toml. If that version is not yet cached, it is downloaded first.

Unlike ggg edit, this launches Godot in game mode rather than opening the editor. Use it to run your project from the terminal, for example in a CI environment or to quickly test without opening the full editor.

Usage

ggg run

Run this from your project directory. Any arguments you add are forwarded verbatim to Godot:

ggg run --headless
ggg run --headless --script res://tests/run_tests.gd

Notes

• Requires a ggg.toml in the current directory.
• Downloads and caches the declared Godot version on first run. Subsequent runs start immediately from the cache.
• Does not run ggg sync first. If you have just added or updated dependencies, run ggg sync beforehand.

See also

• ggg edit: opens the project in the Godot editor instead
• ggg sync: installs dependencies before running