# AG X — Antigravity Fork

**AG X** is a fork of the Antigravity desktop application with enhanced multi-provider support. It allows you to use Google OAuth or any custom OpenAI-compatible API provider.

![AG X Icon](icon.png)

## Features

- 🔄 **Multi-Provider Support** — Switch between Google OAuth and custom API providers
- ⚡ **Custom Endpoints** — Configure your own OpenAI-compatible API endpoints
- 🌐 **Translation Proxy** — Built-in translation service proxy for multi-language support
- 🔧 **Provider Settings UI** — Easy-to-use settings page for managing providers
- 📦 **Debian Package** — Installable `.deb` package for Ubuntu/Debian
- 🖥️ **System Tray** — Minimize to system tray with status indicators
- 🔒 **Secure Storage** — Provider configurations stored locally and securely

## Quick Start

### Install from .deb

```bash
sudo dpkg -i ag-x_2.0.3_amd64.deb
sudo apt-get install -f  # fix any missing dependencies
```

### First Run

1. Launch AG X from your application menu or run `ag-x`
2. On first launch, you'll see the **Welcome Screen**
3. Choose your provider:
   - **Google OAuth** — Use the default Antigravity/Google authentication
   - **Custom Provider** — Enter your own API endpoint URL and API key
4. Start using the app!

### Configure Provider

After initial setup, you can change your provider at any time:
- Click the AG X tray icon → **Settings**
- Or use the in-app provider settings

## Project Structure

```
ag-x/
├── dist/                          # Application source (compiled)
│   ├── main.js                    # Electron main process
│   ├── languageServer.js          # Language Server proxy
│   ├── preload.js                 # Electron preload script
│   ├── providerSettings.js        # Provider settings window
│   ├── provider/
│   │   ├── welcome.html           # First-run welcome screen
│   │   └── settings.html          # Provider settings page
│   ├── services/
│   │   ├── apiProxy.js            # API request proxy
│   │   ├── providerService.js     # Provider management
│   │   ├── translationProxy.js    # Translation proxy
│   │   └── settingsService.js     # Settings persistence
│   └── ...
├── releases/
│   └── ag-x_2.0.3_amd64.deb      # Debian installer package
├── icon.png                       # Application icon
├── trayTemplate.png               # Tray icon template
├── trayTemplate@2x.png            # Tray icon template (Retina)
├── package.json                   # Node.js package manifest
├── CHANGELOG.md                   # Version history
└── README.md                      # This file
```

## Configuration

AG X stores configuration in:
- `~/.ag-x/ag-x/provider_config.json` — Provider settings
- `~/.codex/endpoints.json` — Language Server endpoint configuration

### Custom Provider Format

```json
{
  "providerType": "custom",
  "apiEndpoint": "https://your-api.example.com/v1",
  "apiKey": "your-api-key",
  "models": ["gpt-4", "gpt-3.5-turbo"]
}
```

## Building from Source

### Prerequisites
- Node.js 18+
- npm 9+

### Build Steps

```bash
npm install
npm run build
npm run package:linux
```

The `.deb` package will be in `releases/`.

## License

Fork of Antigravity. See original project for license details.

## Links

- **Repository**: [https://github.rommark.dev/admin/antigravity-ai-providers](https://github.rommark.dev/admin/antigravity-ai-providers)
- **Original**: Antigravity Desktop App