Repository navigation
Troubleshooting
Grouped by symptom. Each entry gives a check and a handling step.
Core not installed
Overview shows core status Not installed. Install the core and retry.
Account held
A mutex conflict dialog appears. Two options:
| Option | Action | Effect |
|---|---|---|
| Stop the owning instance | Stop that process on the Instances page, then retry | Unsaved work in the prior instance is lost |
| Force takeover | Confirm the risk prompt | The prior process is terminated and the lock is cleared |
Project held
Same handling. The owner is recorded in RunningInstanceId in data/projects.json.
Port in use
An instance needs a local port. Close the conflicting process, or restart Gravityless to reallocate.
Symptom: no Mica appearance, or the background is a flat color.
Check in order:
- The material option on the Appearance page is
None; - System transparency effects are enabled: Settings → Personalization → Colors → Transparency effects;
- The OS build meets the requirement listed in Appearance;
-
HKCU\Software\Microsoft\Windows\CurrentVersion\Themes\Personalize\EnableTransparencyis1.
The material is drawn by DWM. If any check fails, DWM emits no backdrop.
Symptom: material unchanged after editing the patch.
Re-injection happens only when the stamp in utils.js differs from MicaPatchVersion. Increment that constant after changing the template. Restart an instance to apply.
Symptom: menus and dialogs show no blurred background.
Check in order:
- Backdrop blur slider is 0;
- Popup transparency is 0% (
popupAlphais 1, the fill is opaque and hides the blur); - The popup sits over an empty material area with no page content to sample.
backdrop-filter samples page content only, never the DWM material.
Symptom: some Antigravity UI strings remain English.
Check whether the string is a key in locales/zh-CN.json.
| Case | Handling |
|---|---|
| Key exists but has no effect | Restart the instance |
| Key missing | Append the entry; key is the English source string |
| Key exists but is a fragment | The page splits a sentence; add each fragment separately |
Strings added by an Antigravity update do not enter the dictionary automatically.
Symptom: a conversation created in instance A is absent in instance B.
Depends on the project binding count:
| Bound projects | Behavior | Handling |
|---|---|---|
| 1 | Whole-directory junction, two-way | Should be visible at once. Check both instances bind the same project |
| ≥2 | One-way snapshot | Instance A writes back on exit; instance B must restart to remount |
Write-back requires the conversation workspace_uris to contain a bound project path. Otherwise the conversation stays in the sandbox.
Symptom: an account shows In use while no matching process runs.
A crashed instance left the lock behind.
Handling: Force unlock on the Accounts page, or Force unlock all.
Windows caches exe icons. If Explorer shows the old icon after a replacement:
- Close the app;
- Delete
%LocalAppData%\IconCache.db; - Restart
explorer.exefrom Task Manager.
Tray icons do not use the system icon cache. Restart the app after changing Assets\tray.ico.
Check these first when diagnosing:
| Path | Content |
|---|---|
<install>\data\instances.json |
Instance state |
<install>\data\projects.json |
Project state |
<install>\data\accounts.json |
Account lock state |
<install>\core\resources\app\dist\utils.js |
Patch output and version stamp |
<install>\core\resources\app.asar.stock |
Original package backup |
See Data Layout.
| Case | Handling |
|---|---|
| Patch corrupted | Delete core\resources\app\ and unpack again from app.asar.stock
|
| Core corrupted | Uninstall the core on the Overview page and reinstall; data\ is kept |
| Config corrupted | Delete the JSON file; defaults are rebuilt on restart |
A JSON parse failure falls back to defaults and does not block startup.
Gravityless · GPL-3.0 · English | 简体中文