AG X v2.0.3 - Add README, CHANGELOG (.deb available in Releases)

2026-05-22 23:40:33 +04:00
parent 43e2a2f78f
commit 1a033e7ab4
2 changed files with 136 additions and 32 deletions
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -0,0 +1,38 @@
+# AG X Changelog
+
+## v2.0.3 (2025-05-22)
+
+### Features
+- **Multi-Provider Support**: Choose between Google OAuth or Custom Provider at first launch
+- **Provider Settings UI**: Built-in settings page to configure custom API endpoints
+- **API Proxy**: Transparent proxy that routes requests to your chosen provider
+- **Translation Proxy**: Supports translation services for multi-language responses
+- **Welcome Screen**: First-run experience lets you select your preferred provider
+- **System Tray Integration**: Minimize to tray with status indicators
+
+### Fixes
+- Fixed provider selection flow - selecting a custom provider now correctly opens the app
+- Fixed endpoint configuration sync between AG X UI and Language Server proxy
+- Fixed OAuth redirect handling for custom providers
+- Fixed settings persistence across app restarts
+
+### Architecture
+- `dist/main.js` - Electron main process with provider orchestration
+- `dist/languageServer.js` - Language Server proxy with endpoint management
+- `dist/provider/welcome.html` - First-run provider selection screen
+- `dist/provider/settings.html` - Provider configuration settings page
+- `dist/providerSettings.js` - Provider settings window management
+- `dist/services/apiProxy.js` - API request proxy to custom endpoints
+- `dist/services/providerService.js` - Provider CRUD operations
+- `dist/services/translationProxy.js` - Translation service proxy
+
+## v2.0.2 (2025-05-22)
+
+- Initial AG X fork from Antigravity
+- Custom provider support
+- Settings UI improvements
+
+## v2.0.1 (2025-05-22)
+
+- Base Antigravity fork
+- Desktop app packaging (.deb)
--- a/README.md
+++ b/README.md
@@ -1,43 +1,109 @@
-# AG X (Antigravity fork) v2.0.3
+# AG X — Antigravity Fork

-AI-Powered Code Intelligence — agentic desktop application with multi-provider AI support.
+**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.

-## What's New in v2.0.3
-
-### 🐛 Critical Fix: Provider Selection Flow
- **Welcome screen now shows BEFORE the Language Server starts** — on first run, the user picks a provider before the LS launches, preventing the Google OAuth prompt from appearing for non-Google providers.
- **Provider config syncs to `~/.codex/endpoints.json`** — the provider choice from the welcome screen and settings panel is properly synced to the endpoints config that the translation proxy reads.
- **"Another AI Provider" flow fixed** — when user picks a custom provider, the settings panel opens and the app waits for the user to configure and save their provider before starting the Language Server.
-
-### Changes
-| File | Change |
-|---|---|
-| `main.js` | Restructured startup: welcome screen before LS start |
-| `main.js` | Added `syncProviderToEndpoints()` function |
-| `main.js` | Google Gemini handler sets active endpoint in `endpoints.json` |
-| `main.js` | Custom provider handler waits for settings save before continuing |
-| `providerSettings.js` | Save handler syncs to `endpoints.json` and emits `provider:settings-saved` |
-| `providerSettings.js` | Added close-settings IPC listener |
-| `settings.html` | Save handler shows restart notification and auto-closes |
+![AG X Icon](icon.png)

 ## Features
- 🔮 Google Gemini (OAuth) — zero config
- 🔌 15+ AI Providers (OpenAI, Anthropic, DeepSeek, Ollama, etc.)
- 🧠 Built-in translation proxy for non-native backends
- 🔄 Auto-update support
- 🖥️ System tray integration

-## Installation
+- 🔄 **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
-On first launch, AG X shows a welcome screen where you choose:
-1. **Google Gemini** — Sign in with Google (OAuth, no API key needed)
-2. **Another AI Provider** — Pick from 15+ providers and enter your API key
+### 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
- Provider settings: `~/.ag-x/ag-x/provider_config.json`
- Proxy endpoints: `~/.codex/endpoints.json`
- Menu → AI Provider Settings to change provider anytime
+
+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