Metadata-Version: 2.4
Name: agy-mobile
Version: 0.1.0
Summary: Mobile & Web UI Portal for Google Antigravity (AGY) CLI
Author-email: Developer <developer@example.com>
License-Expression: MIT
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: fastapi>=0.100.0
Requires-Dist: uvicorn[standard]>=0.20.0
Requires-Dist: pydantic>=2.0.0

# 🤖 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:
```bash
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:
```bash
pip install agy-mobile
```
Or with `pipx` for global CLI isolation:
```bash
pipx install agy-mobile
```

Then start the portal anytime by running:
```bash
agy-mobile
```

---

### Option 3: Docker Container

If you prefer running in a container:
```bash
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:

```bash
# 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
```

| Flag | Description | Default |
| :--- | :--- | :--- |
| `--host` | Network interface to bind (`127.0.0.1` for local only, `0.0.0.0` for local network access) | `127.0.0.1` |
| `--port` | Port number to listen on | `8505` |
| `--agy-bin` | Path to `agy` CLI executable binary | Auto-detected (`shutil.which("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`
