agy-mobile

🤖 AGY Mobile | Antigravity CLI Web & PWA Portal

A sleek, mobile-optimized Web UI and Progressive Web App (PWA) portal for Google Antigravity (agy) CLI agents. Featuring real-time response streaming, model selection, voice input, reasoning effort toggles, and multi-workspace support.

---

⚡ Quick Installation Directions for Users

Option 1: One-Line Installer Script (Recommended for Linux & macOS)

Run this single command in your terminal:

curl -sSL https://raw.githubusercontent.com/<your-username>/agy-mobile/main/install.sh | bash

This will automatically:

1. Detect Python 3.9+ and verify the agy CLI installation.
2. Set up an isolated environment in ~/.agy-mobile.
3. Create the agy-mobile executable command.
4. Optionally install a background systemd user service.

---

Option 2: Install via Pip / Pipx

If you have Python installed, you can install agy-mobile directly:

pip install agy-mobile

Or with pipx for global CLI isolation:

pipx install agy-mobile

Then start the portal anytime by running:

agy-mobile

---

Option 3: Docker Container

If you prefer running in a container:

git clone https://github.com/<your-username>/agy-mobile.git
cd agy-mobile
docker compose up -d

---

⚙️ Usage & Configuration Flags

Launch agy-mobile with custom flags:

# Bind to all network interfaces so mobile devices on Wi-Fi can connect:
agy-mobile --host 0.0.0.0 --port 8505

# Specify a custom agy binary path if agy is installed in a non-standard location:
agy-mobile --agy-bin /path/to/agy

---

📱 Mobile PWA Installation (iOS & Android)

1. Open http://<your-computer-ip>:8505 in your mobile web browser (e.g. Chrome or Safari).
2. Android: Tap the green Install button in the top right header, or open Chrome's menu (⋮) and select Install app.
3. iOS (Safari): Tap the Safari Share icon (⎋ box with up arrow) -> select Add to Home Screen.
4. The AGY Mobile app icon (robot head avatar) will now appear on your phone's Home Screen like a native app!

---

🛠️ Requirements

• Operating System: Linux, macOS, or WSL2 (Windows)
• Python: >= 3.9
• Dependencies: Google Antigravity (agy) CLI binary installed on system PATH or ~/.local/bin/agy