@kamel-ahmed/proxy-claude 1.0.5 → 1.0.6

package/README.md

@@ -4,12 +4,9 @@
 [![npm downloads](https://img.shields.io/npm/dm/@kamel-ahmed/proxy-claude.svg)](https://www.npmjs.com/package/@kamel-ahmed/proxy-claude)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-<a href="https://buymeacoffee.com/badrinarayanans" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="50"></a>
 
 A proxy server that exposes an **Anthropic-compatible API** backed by **Antigravity's Cloud Code**, letting you use Claude and Gemini models with **Claude Code CLI**.
 
-![Antigravity Claude Proxy Banner](images/banner.png)
-
 ## How It Works
 
 ```
@@ -28,65 +25,234 @@ A proxy server that exposes an **Anthropic-compatible API** backed by **Antigrav
 
 ## Prerequisites
 
-- **Node.js** 18 or later
-- **Antigravity** installed (for single-account mode) OR Google account(s) for multi-account mode
+- **Node.js** 18 or later (download from [nodejs.org](https://nodejs.org))
+- **Claude Code CLI** (installed automatically by setup wizard)
+- Google account(s) for authentication
 
 ---
 
 ## Installation
 
-### Automated Setup (Recommended)
+### Windows Installation
+
+**Step 1: Install Node.js**
+
+1. Download Node.js 18+ from [nodejs.org](https://nodejs.org)
+2. Run the installer and follow the setup wizard
+3. Restart your computer (or just close & reopen PowerShell)
+4. Verify installation in PowerShell:
+   ```powershell
+   node --version
+   npm --version
+   ```
+
+**Step 2: Install proxy-claude**
+
+Open PowerShell or Command Prompt and run:
+
+```powershell
+npm install -g @kamel-ahmed/proxy-claude
+proxy-claude init
+```
+
+**Step 3: Complete Setup Wizard**
+
+The wizard will:
+- ✅ Check Node.js and Claude Code CLI
+- ✅ Add your Google account(s)
+- ✅ Pick models for each tier
+- ✅ Auto-configure settings
 
-Run the setup command to automatically install Claude Code CLI and create a global `proxy-claude` command:
+**Step 4: Start Using**
+
+```powershell
+proxy-claude
+```
+
+That's it! Claude Code will launch connected to the proxy.
+
+---
+
+### macOS/Linux Installation
+
+**Step 1: Install Node.js** (if not already installed)
+
+```bash
+# macOS with Homebrew
+brew install node
+
+# Or download from https://nodejs.org
+```
+
+**Step 2: Install proxy-claude**
 
 ```bash
-# Install globally (recommended)
 npm install -g @kamel-ahmed/proxy-claude
-proxy-claude setup
+proxy-claude init
+```
 
-# Or run via npx
-npx @kamel-ahmed/proxy-claude setup
+**Step 3: Start Using**
 
-# If cloned locally
-npm run setup
+```bash
+proxy-claude
+```
+
+---
+
+### Quick Install (Recommended)
+
+```bash
+# Install globally
+npm install -g @kamel-ahmed/proxy-claude
+
+# Run setup wizard
+proxy-claude init
+```
+
+The setup wizard will:
+1. ✅ Check prerequisites (Node.js, Claude Code CLI)
+2. ✅ Help you add Google account(s)
+3. ✅ Let you pick models for each tier (Opus, Sonnet, Haiku)
+4. ✅ Auto-configure `~/.claude/settings.json`
+
+After setup, just run:
+
+```bash
+proxy-claude
 ```
 
-After setup completes, you can run Claude with the proxy from anywhere:
+This will:
+1. Start the proxy server in the background
+2. Wait for the server to be ready
+3. Launch Claude Code CLI connected to the proxy
+4. Automatically shut down the proxy when you exit
+
+---
+
+### Quick Install (All Platforms)
+
+```bash
+# Install globally
+npm install -g @kamel-ahmed/proxy-claude
+
+# Run setup wizard
+proxy-claude init
+```
+
+The setup wizard will:
+1. ✅ Check prerequisites (Node.js, Claude Code CLI)
+2. ✅ Help you add Google account(s)
+3. ✅ Let you pick models for each tier (Opus, Sonnet, Haiku)
+4. ✅ Auto-configure `~/.claude/settings.json`
+
+After setup, just run:
 
 ```bash
 proxy-claude
 ```
 
-The `proxy-claude` command will:
-1. Start the proxy server in the background.
-2. Wait for the server to be ready.
-3. Launch `claude` (Claude Code CLI) connected to the proxy.
-4. Automatically shut down the proxy when you exit Claude.
+This will:
+1. Start the proxy server in the background
+2. Wait for the server to be ready
+3. Launch Claude Code CLI connected to the proxy
+4. Automatically shut down the proxy when you exit
+
+---
+
+## Troubleshooting
+
+### Windows: "npm: The term 'npm' is not recognized"
+
+**Solution:** Node.js wasn't installed correctly or PowerShell needs to be restarted.
+
+1. Download and reinstall Node.js from [nodejs.org](https://nodejs.org)
+2. Close PowerShell/Command Prompt completely
+3. Reopen PowerShell as Administrator
+4. Try again: `npm --version`
+
+### Windows: "proxy-claude: The term 'proxy-claude' is not recognized"
+
+**Solution:** npm install path isn't in your PATH environment variable.
+
+```powershell
+# Find where npm installed it
+npm config get prefix
+
+# Add to PATH (replace C:\Users\YourUsername\AppData\Roaming\npm if different):
+$env:Path += ";C:\Users\$env:USERNAME\AppData\Roaming\npm"
+```
+
+Then close and reopen PowerShell.
+
+### Port Already in Use
 
-You can also customize the port and pass arguments to Claude:
+If port 8080 is already in use, specify a different port:
 
 ```bash
-# Use a custom port
 PORT=3000 proxy-claude
+# or
+proxy-claude --port 3000
+```
+
+### "Claude Code CLI not found" Error
 
-# Pass arguments to Claude
-proxy-claude --model sonnet
+The setup wizard will automatically install Claude Code CLI for you. If it fails:
+
+```bash
+npm install -g @anthropic-ai/claude-code
 ```
 
-> **Note:** The setup requires write access to `/usr/local/bin`. If prompted, enter your password to allow installation.
+### Settings Not Persisting
 
-### Option 1: npm (Manual)
+The wizard auto-configures `~/.claude/settings.json`. You can verify it was created:
+
+**Windows:**
+```powershell
+notepad "$env:USERPROFILE\.claude\settings.json"
+```
 
+**macOS/Linux:**
 ```bash
-# Run directly with npx (no install needed)
-npx @kamel-ahmed/proxy-claude start
+cat ~/.claude/settings.json
+```
 
-# Or install globally
-npm install -g @kamel-ahmed/proxy-claude
-proxy-claude start
+---
+
+### CLI Commands
+
+```bash
+proxy-claude              # Start proxy + Claude Code (default)
+proxy-claude init         # Run setup wizard
+proxy-claude start        # Start proxy server only
+proxy-claude stop         # Stop proxy server  
+proxy-claude status       # Check if proxy is running
+proxy-claude accounts     # Manage Google accounts
+proxy-claude refresh      # Refresh account tokens
+proxy-claude --help       # Show all commands
+```
+
+Custom port:
+
+```bash
+PORT=3000 proxy-claude
+proxy-claude --port 3000
+```
+
+### Cross-Platform Support
+
+Works on **Windows**, **macOS**, and **Linux** with full feature parity.
+
+### Alternative: npx (No Install)
+
+```bash
+# Run directly without installing
+npx @kamel-ahmed/proxy-claude
+
+# Or just start the server
+npx @kamel-ahmed/proxy-claude start
 ```
 
-### Option 2: Clone Repository
+### Development: Clone Repository
 
 ```bash
 git clone https://github.com/badri-s2001/antigravity-claude-proxy.git
@@ -99,22 +265,23 @@ npm start
 
 ## Quick Start
 
-### 1. Start the Proxy Server
+If you used `proxy-claude init`, you're already set up! Just run:
 
 ```bash
-# If installed via npm
-proxy-claude start
+proxy-claude
+```
 
-# If using npx
-npx @kamel-ahmed/proxy-claude start
+### Manual Setup (Alternative)
 
-# If cloned locally
-npm start
+#### 1. Start the Proxy Server
+
+```bash
+proxy-claude start
 ```
 
 The server runs on `http://localhost:8080` by default.
 
-### 2. Link Account(s)
+#### 2. Link Account(s)
 
 Choose one of the following methods to authorize the proxy:
 
@@ -616,8 +783,4 @@ This project is based on insights and code from:
 
 MIT
 
----
-
-## Star History
-
-[![Star History Chart](https://api.star-history.com/svg?repos=badrisnarayanan/antigravity-claude-proxy&type=date&legend=top-left&cache-control=no-cache)](https://www.star-history.com/#badrisnarayanan/antigravity-claude-proxy&type=date&legend=top-left)
+---

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kamel-ahmed/proxy-claude",
-  "version": "1.0.5",
-  "description": "Proxy server to use Antigravity's Claude models with Claude Code CLI - run 'proxy-claude' to start",
+  "version": "1.0.6",
+  "description": "Cross-platform CLI proxy for Antigravity Cloud Code. Use Claude & Gemini models with Claude Code CLI on Windows, macOS, and Linux.",
   "main": "src/index.js",
   "type": "module",
   "bin": {
@@ -45,17 +45,22 @@
     "anthropic",
     "antigravity",
     "proxy",
-    "vertex-ai"
+    "gemini",
+    "claude-code",
+    "cross-platform",
+    "windows",
+    "macos",
+    "linux"
   ],
-  "author": "Kamel Ahmed",
+  "author": "Kamel Ahmed <kamel.ahmed.mostafa.kamel@gmail.com>",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/kamel-ahmed/proxy-claude.git"
+    "url": "git+https://github.com/KamelAhmed01/antigravity-claude-proxy.git"
   },
-  "homepage": "https://github.com/kamel-ahmed/proxy-claude#readme",
+  "homepage": "https://github.com/KamelAhmed01/antigravity-claude-proxy#readme",
   "bugs": {
-    "url": "https://github.com/kamel-ahmed/proxy-claude/issues"
+    "url": "https://github.com/KamelAhmed01/antigravity-claude-proxy/issues"
   },
   "publishConfig": {
     "access": "public"

package/src/cli/accounts.js

@@ -95,7 +95,7 @@ function openBrowser(url) {
         args = [url];
     } else if (platform === 'win32') {
         command = 'cmd';
-        args = ['/c', 'start', '', url];
+        args = ['/c', 'start', '', url.replace(/&/g, '^&')];
     } else {
         command = 'xdg-open';
         args = [url];