Documentation
Managing Godot projects across a team is messier than it should be. Different contributors run different engine versions. Addons are committed wholesale into the repository or documented in a README that nobody reads. There is no standard way to reproduce the full project environment from scratch.
Godot Goodie Grabber fixes this.
What is Godot Goodie Grabber?
Godot Goodie Grabber is a project manager for Godot games, inspired by uv for Python. It gives every project a ggg.toml file that declares two things:
- The Godot version the project requires
- A list of addon dependencies sourced from git repositories, pre-built archives, or the Godot Asset Library
From there, a single command - ggg sync - downloads the right Godot binary and installs every declared addon at the exact version pinned in ggg.lock. No more README instructions, no more committed vendor trees, no more "works on my machine" engine mismatches.
CLI Overview
| Command | What it does |
|---|---|
ggg init | Create a ggg.toml in the current directory |
ggg add | Add a dependency (git, archive, or asset library) |
ggg remove | Remove a dependency |
ggg deps | List all dependencies |
ggg search | Search the Godot Asset Library |
ggg update | Check for updates to asset library dependencies |
ggg sync | Download Godot and install all dependencies |
ggg edit | Open the project in the pinned Godot editor |
ggg run | Run the project with the pinned Godot binary |
ggg diff | Show local changes to installed addon files |
ggg ls-dep | Inspect a dependency's source tree before syncing |
What's Next?
Follow the Quick Start guide to set up a project in a few minutes.