Files
antigravity-skills-reference/docs/users/windows-truncation-recovery.md
2026-03-14 20:00:09 +01:00

4.7 KiB

Windows Recovery for Truncation Crash Loops

Use this guide if Antigravity or a Jetski/Cortex-based integration on Windows gets stuck in a restart loop with an error like:

TrajectoryChatConverter: could not convert a single message before hitting truncation

This usually means a previous run stored a broken trajectory or tried to load too many skill instructions into one message.

When to use this guide

  • Antigravity crashes immediately after launch on Windows
  • the app keeps resuming the same broken session
  • a newly installed skill or bundle caused the failure
  • you already removed the offending skill but the app still reopens into the same error

Safety first

Before deleting anything, back up these folders if they exist:

  • %USERPROFILE%\.gemini\antigravity-browser-profile\Default
  • %AppData%\antigravity
  • %USERPROFILE%\.gemini\antigravity

If you installed skills into a different location, also back up that custom directory.

Manual recovery steps

  1. Fully close Antigravity.

  2. Remove the offending skill or package from your Antigravity skill install. Default path:

    %USERPROFILE%\.gemini\antigravity\plugins\skills
    
  3. Delete the stored browser database folders if they exist:

    %USERPROFILE%\.gemini\antigravity-browser-profile\Default\Local Storage
    %USERPROFILE%\.gemini\antigravity-browser-profile\Default\Session Storage
    %USERPROFILE%\.gemini\antigravity-browser-profile\Default\IndexedDB
    
  4. Delete the Antigravity app storage folders if they exist:

    %AppData%\antigravity\Local Storage
    %AppData%\antigravity\Session Storage
    
  5. Clear your Windows temp directory:

    %TEMP%
    
  6. Restart Antigravity.

  7. Reinstall only the skills you actually need, or switch your integration to lazy loading with explicit limits.

  • Do not concatenate every SKILL.md into one system prompt.
  • Use data/skills_index.json as a lightweight manifest.
  • Load SKILL.md files only when a skill is actually requested.
  • Set explicit limits for skills per turn.
  • Prefer overflowBehavior: "error" in the reference Jetski/Gemini loader so the host fails clearly instead of silently overfilling the context window.

See:

Optional Windows batch helper

The following script is adapted from the community recovery workflow shared by @DiggaX in issue #274. Review it before running it.

@echo off
setlocal enabledelayedexpansion
title Anti-Gravity_Recovery_Tool_Universal

set "TIMESTAMP=%date:~6,4%-%date:~3,2%-%date:~0,2%_%time:~0,2%-%time:~3,2%"
set "TIMESTAMP=%TIMESTAMP: =0%"
set "BACKUP_DIR=%USERPROFILE%\Desktop\AG_Emergency_Backup_%TIMESTAMP%"

set "PATH_BROWSER=%USERPROFILE%\.gemini\antigravity-browser-profile\Default"
set "PATH_APPCONFIG=%AppData%\antigravity"
set "PATH_MAIN=%USERPROFILE%\.gemini\antigravity"

echo ============================================================
echo      ANTI-GRAVITY RECOVERY ^& REPAIR TOOL (UNIVERSAL)
echo ============================================================
echo.
echo This tool targets the truncation crash loop on Windows.
echo [INFO] Backup location: %BACKUP_DIR%
echo.

if not exist "%BACKUP_DIR%" mkdir "%BACKUP_DIR%"

if exist "%PATH_BROWSER%" xcopy "%PATH_BROWSER%" "%BACKUP_DIR%\Browser_Profile" /E /I /Y /Q
if exist "%PATH_APPCONFIG%" xcopy "%PATH_APPCONFIG%" "%BACKUP_DIR%\App_Config" /E /I /Y /Q
if exist "%PATH_MAIN%" xcopy "%PATH_MAIN%" "%BACKUP_DIR%\Main_Skills" /E /I /Y /Q

(
echo === ANTI-GRAVITY RESTORATION GUIDE ===
echo.
echo Restore Browser_Profile to: %PATH_BROWSER%
echo Restore App_Config to: %PATH_APPCONFIG%
echo Restore Main_Skills to: %PATH_MAIN%
echo.
echo Close Antigravity before restoring.
) > "%BACKUP_DIR%\RECOVERY_INSTRUCTIONS.txt"

set /p "repair=Start the repair now? [Y/N]: "

if /i "%repair%"=="Y" (
    if exist "%PATH_BROWSER%\Local Storage" rd /s /q "%PATH_BROWSER%\Local Storage"
    if exist "%PATH_BROWSER%\Session Storage" rd /s /q "%PATH_BROWSER%\Session Storage"
    if exist "%PATH_BROWSER%\IndexedDB" rd /s /q "%PATH_BROWSER%\IndexedDB"
    if exist "%PATH_APPCONFIG%\Local Storage" rd /s /q "%PATH_APPCONFIG%\Local Storage"
    if exist "%PATH_APPCONFIG%\Session Storage" rd /s /q "%PATH_APPCONFIG%\Session Storage"
    del /q /s %temp%\* >nul 2>&1
    for /d %%x in (%temp%\*) do @rd /s /q "%%x" >nul 2>&1
    echo [SUCCESS] Recovery cleanup completed.
) else (
    echo Recovery skipped. No files were deleted.
)

echo.
echo Next step: remove the broken skill from %PATH_MAIN%\plugins\skills
pause