Antigravity Chat & Workspace Recover

One-click recovery utility that rescues lost Antigravity conversations and missing project workspaces following system crashes, sudden reboots, or power failures. Reconstructs truncated Protobuf indices and reconnects sidebar trees with full historical accuracy dating back to 2025.

Dual-Index Synthesis

Parses raw SQLite (.db) sessions and Protobuf (.pb) blobs directly from your disk, synthesizing them into Antigravity's unified index (agyhub_summaries_proto.pb) and Electron database (state.vscdb).

Field 17 Project Compliance

Enforces strict Protobuf Field 17 Subfield 18 serialization so revived conversations correctly link to project workspace roots, preventing the UI from discarding them as unlinked orphans.

Transcript Forensics

Inspects conversation step logs in transcript.jsonl to extract true creation timestamps rather than misleading file modification dates, ensuring perfect chronological sorting from 2025 onward.

Why Antigravity conversations vanish after unexpected crashes.

Antigravity buffers active conversation metadata in volatile process memory, deferring disk synchronization until clean shutdown. When an unexpected crash or reboot occurs, the synchronization chain breaks:

Stage 01

Memory Buffering

Active session summaries live in volatile RAM. Disk writes to agyhub_summaries_proto.pb and state.vscdb are deferred until normal exit.

Stage 02

Abrupt Crash

Sudden Windows reboots, power cuts, or hard process crashes terminate the app without flushing, leaving summary indices truncated or zeroed out.

Stage 03

Intact Raw Files

Crucially, the raw message logs and transcripts remain completely intact on disk in ~/.gemini/antigravity/brain/, waiting to be linked.

Stage 04

Sidebar Rejection

Without valid Field 17 project linkages in the index file, the Antigravity frontend silently ignores these orphaned chats upon launch.

Two ways to restore your workspaces and conversations.

Automated CLI

1-Click Complete Restore

Double-click 1-Click-Restore.bat for an immediate, non-interactive recovery. Automatically stops stale instances, verifies index integrity, reconstructs missing project configs, compiles Protobuf summaries, and relaunches Antigravity with a 0% to 100% progress indicator.

Interactive Dashboard

Visual Recovery Console

Double-click Open-Dashboard.bat to launch a lightweight local HTTP dashboard at http://localhost:4999. Browse and search chats by prompt text or workspace, filter by project, verify true creation dates, and selectively restore with real-time feedback.

Built for precision recovery and absolute data safety.

Portability

Universal Path Resolution

Uses dynamic environment variable resolution (%USERPROFILE%, %APPDATA%) to run seamlessly across any Windows installation without hardcoded user paths.

Architecture

Dual-Storage Synthesis

Bridges the legacy SQLite (.db) format and modern Protobuf (.pb) schemas, ensuring comprehensive recovery across multiple Antigravity versions.

Discovery

Workspace Auto-Discovery

Inspects conversation transcript headers to automatically regenerate missing project workspace configuration files under ~/.gemini/config/projects/.

Chronology

True Historical Timestamps

Extracts original conversation creation timestamps directly from transcript.jsonl step records, maintaining correct chronological sorting dating back to 2025.

Simplicity

Zero External Dependencies

Engineered entirely with Python standard library modules (sqlite3, http.server, urllib, json, uuid). Requires no pip install or external binaries.

Safety

Automated Pre-Restore Snapshots

Creates timestamped safety backups in ~/.gemini/antigravity/backups/ before performing any file modification, guaranteeing non-destructive operations.

Clean, auditable single-purpose repository structure.

Designed for maximum transparency and rapid auditability. Every Python module is self-contained with explicit type checking and defensive exception handling:

ag-chat-recover/ │ ├── 1-Click-Restore.bat # One-click CLI batch launcher with live percentage progress ├── Open-Dashboard.bat # Visual web dashboard launcher (opens localhost:4999) ├── restore_engine.py # Core recovery engine (dynamic paths, auto-sync, protobuf serializer) ├── dashboard.py # Local air-gapped HTTP server with real-time percentage tracking ├── cdp_helper.py # Chrome DevTools Protocol helper for live Antigravity UI updates ├── README.md # User guide, root-cause explanation & recovery documentation └── LICENSE # MIT License

Non-destructive operational boundaries.

Target Component	Operation Performed	Safety Boundary Guarantee
`agyhub_summaries_proto.pb`	Reconstructed from disk transcripts	Pre-restore snapshot backed up before any write
`state.vscdb` (Electron Storage)	Synchronized with recovered chat IDs	Keys updated defensively; foreign database records untouched
`~/.gemini/config/projects/`	Regenerates missing workspace JSON configs	Existing project configuration files are never overwritten
Your Project Source Code	NEVER ACCESSED	Zero read or write operations on user code repositories

Common recovery inquiries.

Will this overwrite my code files?

No. AG-Chat-Recover strictly repairs Antigravity metadata indices and workspace descriptors. It contains zero file operations targeting your workspace source code or project folders.

What about chats from 2025?

The engine extracts original creation dates directly from transcript.jsonl internal records. Your oldest conversations dating back to 2025 and earlier will restore in proper chronological order.

Where are safety snapshots saved?

Before any modification, timestamped backups of all target index files are automatically preserved in %USERPROFILE%\.gemini\antigravity\backups\.