Antigravity Sync
VS Code Extension to sync Gemini Antigravity context (~/.gemini/antigravity/) across machines via private Git repository.
Problem: When switching machines, all conversation history, Knowledge Items and brain artifacts of Gemini Antigravity are lost. This extension auto-syncs via Git to solve that.
⚠️ IMPORTANT: Cross-Machine Sync
Workspace Path Matching
Antigravity stores conversation history by absolute workspace path. To see conversations from the old machine on a new machine, workspace paths MUST BE IDENTICAL.
Example:
- Machine A:
/Users/dung.leviet/Documents/myproject
- Machine B: MUST also be
/Users/dung.leviet/Documents/myproject
If paths differ, conversations won't appear even after successful sync.
Solution: Symlinks
Create symlinks on the new machine to match the old machine's paths:
# Linux/macOS
sudo mkdir -p /Users/dung.leviet/Documents
sudo ln -s /actual/path/to/project /Users/dung.leviet/Documents/myproject
# Windows (Run as Administrator)
mklink /D "C:\Users\dung.leviet\Documents\myproject" "D:\actual\path\to\project"
Reload Window After Sync
After pulling data from remote, you MUST reload VS Code window to load new conversations:
Cmd+Shift+P (macOS) / Ctrl+Shift+P (Windows/Linux)
→ "Developer: Reload Window"
OS Compatibility
| Sync between |
Works? |
Notes |
| macOS ↔ macOS |
✅ |
Use symlink |
| Linux ↔ Linux |
✅ |
Use symlink |
| Windows ↔ Windows |
✅ |
Use mklink /D (Admin) |
| macOS ↔ Linux |
✅ |
Use symlink |
| macOS/Linux ↔ Windows WSL |
✅ |
Symlink in WSL + VS Code Remote |
| macOS/Linux ↔ Windows native |
❌ |
Path format incompatible |
Note:
knowledge/ and brain/ work on all platforms without symlink- Only
conversations/ needs workspace path matching
Features
- Auto-sync — Auto sync changes to private repository
- Private repo only — Validate repository must be private
- Sensitive data protection — Auto-exclude OAuth tokens and credentials
- Side panel — Dashboard showing sync status, files and history
- Selective sync — Choose folders to sync
- Setup wizard — Step-by-step config
Installation
From VS Code Marketplace
- Open VS Code
- Extensions (
Cmd+Shift+X / Ctrl+Shift+X)
- Search "Antigravity Sync"
- Install
From VSIX
# If agy is already in PATH:
agy --install-extension antigravity-sync-0.1.0.vsix
# If agy is NOT in PATH, add it first:
# Cmd+Shift+P → "Shell Command: Install 'agy' command in PATH"
# Then run the install command above
Quick Start
- Create private Git repository (GitHub, GitLab, Bitbucket)
- Generate access token with repo scope
- Command Palette (
Cmd+Shift+P / Ctrl+Shift+P)
- Run
Antigravity Sync: Configure Repository
- Follow setup wizard
Configuration
| Setting |
Default |
Description |
antigravitySync.repositoryUrl |
"" |
Git repository URL (must be private) |
antigravitySync.autoSync |
true |
Auto sync changes |
antigravitySync.syncIntervalMinutes |
5 |
Auto-sync interval (minutes) |
antigravitySync.syncFolders |
["knowledge", "antigravity"] |
Folders to sync |
antigravitySync.excludePatterns |
[] |
Additional exclude patterns |
antigravitySync.geminiPath |
"" |
Custom path to .gemini |
Excluded Files (Default)
These files are never synced to protect privacy:
| Pattern |
Reason |
google_accounts.json |
OAuth credentials |
oauth_creds.json |
OAuth credentials |
browser_recordings/ |
Large video files |
code_tracker/ |
Machine-specific data |
implicit/ |
Workspace indexing |
user_settings.pb |
User preferences |
Note: conversations/*.pb ARE synced (chat history).
Custom patterns can be added in .antigravityignore at .gemini/antigravity.
Commands
| Command |
Description |
Antigravity Sync: Configure Repository |
Setup or change repository |
Antigravity Sync: Sync Now |
Manual sync (push + pull) |
Antigravity Sync: Push Changes |
Push local changes only |
Antigravity Sync: Pull Changes |
Pull remote changes only |
Antigravity Sync: Show Status |
Show sync status |
Security
⚠️ Extension requires Git access token with repo scope.
- Token stored in VS Code Secret Storage
- Only works with private repositories
- Sensitive files auto-excluded
- HTTPS only
Development
git clone https://github.com/mrd9999/antigravity-sync.git
cd antigravity-sync
yarn install
yarn build
yarn test
# Run extension (dev mode)
agy . && press F5
Contributing
License
MIT © Dung Le
