explaingit

ryukenshin546-a11y/antigravity-projects-fix

11JavaScriptAudience · developerComplexity · 1/5Setup · easy

TLDR

A small command-line tool that removes duplicate project entries in Google Antigravity 2.0, where one folder can appear dozens of times in the sidebar after the version 2.0 migration.

Mindmap

mindmap
  root((antigravity-fix))
    What it fixes
      Duplicate sidebar entries
      Post-migration clutter
    Run Modes
      Scan read only
      Consolidate duplicates
      Merge with chat history
      Interactive picker
      Purge all entries
      Restore from backup
    Safety Features
      Dry run by default
      Auto backup first
      Closes app before changes
    Platform Support
      Windows tested
      macOS experimental
      Linux experimental
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Scan your Antigravity sidebar to count duplicate project entries before making any changes.

USE CASE 2

Consolidate all duplicate entries down to one per folder while merging saved chat history under the surviving entry.

USE CASE 3

Purge all project entries for a completely clean start when the Antigravity sidebar is too cluttered to manage.

Tech stack

JavaScriptNode.js

Getting it running

Difficulty · easy Time to first run · 5min

Run with npx, no install required. All change commands are dry-run by default and create an automatic backup before modifying anything.

In plain English

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.

Copy-paste prompts

Prompt 1
Help me run antigravity-projects-fix in scan mode to see how many duplicate project entries I have without changing anything.
Prompt 2
Show me the difference between consolidate mode and merge mode in antigravity-projects-fix and which one I should use to keep my chat history.
Prompt 3
I ran antigravity-projects-fix and removed too many entries by mistake, how do I use the restore command to undo the changes?
Prompt 4
Walk me through using antigravity-projects-fix interactive mode to manually pick which duplicate entries to keep for a project called my-app.
Open on GitHub → Explain another repo

← ryukenshin546-a11y on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.