From 1a033e7ab4bd2e83524de7d6f5ed17620f73bd54 Mon Sep 17 00:00:00 2001 From: admin Date: Fri, 22 May 2026 23:40:33 +0400 Subject: [PATCH] AG X v2.0.3 - Add README, CHANGELOG (.deb available in Releases) --- CHANGELOG.md | 38 +++++++++++++++ README.md | 130 ++++++++++++++++++++++++++++++++++++++------------- 2 files changed, 136 insertions(+), 32 deletions(-) create mode 100644 CHANGELOG.md diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..a5b0592 --- /dev/null +++ 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) diff --git a/README.md b/README.md index aee4ab9..95c8034 100644 --- 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