Antigravity Web 🪐

A self-hosted, mobile-first web app (PWA) for your Google Antigravity agent conversations. Read every past conversation from your phone or tablet, continue them, start new ones, and see artifacts, diffs and subagents — like the Gemini app, but for your own Antigravity agent.

🇹🇷 Türkçe açıklama aşağıda

Antigravity runs on your desktop (Antigravity 2.0 / IDE) and the agy CLI runs on your Linux server — but there is no way to reach those conversations from a phone. Antigravity Web fills that gap:

• 💻 Desktop conversations are synced (incrementally, over SSH) to your server.
• 🐧 Server conversations are read directly from the agy CLI data dir.
• 📱 Both are merged into one searchable, installable web app behind your own subdomain.

flowchart LR
  Phone["📱 Phone / Tablet (PWA)"] -->|HTTPS| CF["Cloudflare Tunnel<br/>agy.example.com"]
  CF --> App["agy-web (FastAPI)<br/>127.0.0.1:8085"]
  App -->|spawns| AGY["agy CLI<br/>stream-json"]
  App -->|reads| Data["~/.gemini/antigravity-cli<br/>brain/ · annotations/"]
  App -->|reads| Sync["pc_sync/"]
  PC["💻 Windows PC<br/>Antigravity 2.0"] -->|"sync_pc_to_ubuntu.py<br/>(tar over SSH, every 5 min)"| Sync
  App -.->|optional| Voice["Voice server<br/>/tts-only · /stt-only"]

git clone https://github.com/keremuysal/antigravity-web.git ~/agy-web
cd ~/agy-web
python3 -m venv venv && venv/bin/pip install -r requirements.txt
cp .env.example .env && nano .env        # set AGY_WEB_PIN (min. 6 chars)
venv/bin/uvicorn server:app --host 127.0.0.1 --port 8085   # quick test

Run it as a service: edit agy-web.service (replace YOUR_USER), then

sudo cp agy-web.service /etc/systemd/system/
sudo systemctl daemon-reload && sudo systemctl enable --now agy-web

Create a tunnel in the Cloudflare Zero Trust dashboard with a public hostname such as agy.example.com → http://127.0.0.1:8085, then on the server:

sudo cloudflared service install <TUNNEL_TOKEN>

No open ports needed. Optionally put Cloudflare Access in front for a second login factor (recommended).

setx AGY_REMOTE_HOST "ubuntu@YOUR_SERVER_IP"     # SSH key auth must already work
python sync_pc_to_ubuntu.py --full              # first full sync
# keep it in sync every 5 minutes in the background:
schtasks /Create /TN "AgyWebSync" /TR "pythonw.exe C:\path\to\sync_pc_to_ubuntu.py" /SC MINUTE /MO 5

The sync reads Antigravity's SQLite summary DB in read-only mode and only uploads changed files.

Open https://agy.example.com, log in with your PIN, then Share → Add to Home Screen.

• PIN is required (min. 6 chars); 5 failed attempts per IP → 15-minute lockout.
• Sessions are HMAC-signed tokens; the signing secret is random per install (.agy_web_secret) unless you set AGY_WEB_SECRET.
• Cookies are HttpOnly, Secure, SameSite=Strict; no CORS; API docs disabled.
• Agent-generated HTML artifacts are served with Content-Security-Policy: sandbox so they can't touch your session.
• The mini terminal is off unless AGY_WEB_ENABLE_TERMINAL=true.
• Bind to 127.0.0.1 and expose only via a TLS tunnel/reverse proxy. Adding Cloudflare Access is strongly recommended.
• Synced conversations may contain secrets you pasted into chats — pc_sync/ is git-ignored; keep the server private.

All settings are environment variables (see .env.example): AGY_WEB_PIN, AGY_WEB_SECRET, AGY_WEB_SESSION_DAYS, AGY_BIN, ANTIGRAVITY_DATA_DIR, AGY_WEB_DATA_DIR, AGY_WEB_ENABLE_TERMINAL, AGY_WEB_SERVICES, VOICE_SERVER_URL.

server.py               FastAPI backend (API, transcript parser, agy streaming, auth)
static/index.html       Single-file PWA frontend (no build step)
static/manifest.json    PWA manifest
sync_pc_to_ubuntu.py    Windows → server incremental sync (tar over SSH)
pc_senkron_baslat.bat   Run the sync in a loop (Windows)
agy-web.service         systemd unit template
extras/voice_endpoints.py  Optional voice-server routes

Issues and PRs are welcome — especially macOS/Linux desktop sync, more transcript step types, and UI translations.

MIT © Kerem Uysal

Antigravity Web, Google Antigravity ajan konuşmalarına telefondan ve tabletten erişmen için kendi sunucunda barındırdığın, mobil öncelikli bir web uygulamasıdır (PWA). Gemini uygulaması gibi — ama kendi Antigravity ajanın için.

• 💻 Bilgisayarındaki Antigravity 2.0 konuşmaları SSH üzerinden sunucuna senkronize edilir.
• 🐧 Sunucundaki agy CLI konuşmaları doğrudan okunur.
• 📱 Hepsi tek bir aranabilir uygulamada birleşir: geçmişi oku, kaldığın yerden devam et, yeni sohbet aç.

Öne çıkanlar: canlı yanıt akışı, ⏹️ durdurma, 📎 görsel/dosya yükleme, / komut ve @ etiket menüleri, tıklanabilir soru kartları, ⚔️ iki modeli yarıştırma, Artifacts / Diffs / Alt ajanlar / Terminal paneli, Mermaid & KaTeX, yetenek/otomasyon merkezi ve isteğe bağlı 🎙️ Türkçe sesli konuşma.

Kurulum adımları yukarıdaki Setup bölümündedir. Güvenlik uyarısını mutlaka oku: uygulama sunucundaki ajanı kontrol eder, PIN'ini SSH şifresi gibi koru.

Resmi olmayan bir topluluk projesidir; Google ile bağlantılı değildir.