What is antigravity-projects-fix?

This tool fixes a specific bug in Google Antigravity 2.0, an AI-assisted code editor, where a single project folder gets listed in the sidebar dozens of times with sequential numbers appended to the name. For example, a folder called my-app might appear as my-app, my-app 2, my-app 3, all the way to my-app 41, even though all of them point to the same directory on your computer. The bug happens because Antigravity stores each project as a small JSON file identified by a unique ID. During the version 2.0 migration, the editor kept creating a new ID for the same folder rather than reusing the existing one, so one folder collected dozens of separate registry entries. There is no built-in way to remove them all at once, which is what this tool provides. The tool is a small Node.js command-line program with no dependencies. You can run it without installing anything, using the npx command that comes with Node.js. It offers several modes: a read-only scan that shows how many duplicates exist, a consolidate mode that keeps one entry per folder and deletes the rest, a merge mode that does the same thing while also moving your saved chat history under the surviving entry, an interactive mode with a checkbox picker, a purge mode that removes all project entries for a clean start, and a restore command that reverses any of those changes using an automatic backup the tool creates before modifying anything. All commands that make changes are dry-run by default, meaning they show you what they would do before asking for confirmation. The tool also closes Antigravity before making changes to avoid conflicts. The project has been tested on Windows. macOS and Linux are supported in the code but had not been tested on real hardware at the time of writing, so the README recommends running the read-only scan first on those platforms. The tool is an unofficial community project and is not affiliated with Google.