Bug Report: Antigravity IDE WSL Project Crash
Status: Resolved
Priority: Critical
Date: 2026-01-25
1. Issue Summary
The Antigravity IDE was crashing during the “Resolving Authority” phase when attempting to start a WSL project. The application logs indicated a failure to parse the output of the server installation script:
[Error - 18:09:23.748] Error resolving authority
Error: Failed parsing install script output
at t.installCodeServer (extension.js:1:19964)
2. Technical Investigation & Root Cause
After analyzing the extension source code in antigravity-remote-wsl/dist/extension.js, I identified a quoting conflict between the Windows host and the WSL guest environment.
The Conflict:
-
Process Spawning: The extension used
child_process.spawn('wsl.exe', ...)with the{ windowsVerbatimArguments: true }option. -
Quoting Logic: The extension manually wrapped the
bash -ccommand in single quotes ('). -
Win32 Protocol: Under the Win32
CreateProcessAPI, single quotes are not recognized as argument delimiters. WhenwindowsVerbatimArgumentsis enabled, Node.js does not perform any escaping, passing the raw string towsl.exe. -
Result:
wsl.exereceived a broken command line truncated at the first space. Since the installation script begins with a comment (# Server installation script), the shell executed only the#character and exited successfully with no output, triggering the parsing error.
3. Resolution
I implemented a robust fix by transitioning the process runner to follow standard Win32 argument conventions:
-
Disabled Verbatim Arguments: Set
windowsVerbatimArguments: falsein theWSLManagerclass. This delegating quoting responsibilities to Node.js, which correctly uses double quotes (") for Windows compatibility. -
Normalized Script Injection: Removed manual single-quote wrapping in
installCodeServer. The script is now passed as a raw string, ensuring the entire block is received by the WSL distribution’s shell.
4. Verification
Reproduced the issue with a standalone script (repro_quote_bug.js) and verified that disabling windowsVerbatimArguments allows the full script (including spaces and newlines) to be processed correctly by wsl.exe.
Report generated by Antigravity AI.