@xkei/openclaude 0.30.0-antigravity

package/docs/antigravity-plugin-install.md

@@ -0,0 +1,223 @@
+# OpenClaude + Antigravity Provider — Installation Guide
+
+Step-by-step instructions for installing the bundled OpenClaude package with
+the Google Antigravity provider plugin. After installation you can use
+**Gemini 3 Pro/Flash** and **Claude Sonnet 4.6 / Opus 4.6** through your
+personal Google accounts, with automatic multi-account rotation and no
+free-tier rate limits.
+
+---
+
+## What you get
+
+| Component | Description |
+|---|---|
+| **OpenClaude CLI** | Claude Code-style agent CLI (`openclaude` command) |
+| **`/accounts` command** | Built-in account manager (add / enable / disable / delete Google accounts, clear rate limits) |
+| **Antigravity provider plugin** | Auto-starting local proxy (`localhost:51122`) bridging OpenClaude to Google's Antigravity API |
+| **Zero-config bootstrap** | The plugin registers itself on first launch — no manual settings edits |
+
+---
+
+## Requirements
+
+- **OS:** Windows 10/11 (the bundled proxy is a Windows executable; hooks are
+  `.bat`/`.ps1`).
+- **Node.js 20+** (or Bun 1.0+) — runs the CLI.
+- One or more **Google accounts** (personal Gmail accounts work).
+- Optional: **Bun** — only needed if you want to rebuild the proxy from source.
+
+---
+
+## Step 1 — Install the package
+
+Install from the bundled tarball (`gitlawb-openclaude-0.30.0.tgz`):
+
+```powershell
+npm install -g .\gitlawb-openclaude-0.30.0.tgz
+```
+
+or with Bun:
+
+```powershell
+bun install -g .\gitlawb-openclaude-0.30.0.tgz
+```
+
+> If you are installing from a source checkout instead, see
+> [Appendix A](#appendix-a--installing-from-a-source-checkout).
+
+## Step 2 — Verify the CLI works
+
+```powershell
+openclaude --version
+```
+
+Expected output:
+
+```
+0.30.0 (OpenClaude)
+```
+
+> If `openclaude` is not found, restart your terminal so the global `bin`
+> directory is on `PATH`.
+
+## Step 3 — First launch (plugin self-registration)
+
+Start OpenClaude in any project folder:
+
+```powershell
+cd C:\your\project
+openclaude
+```
+
+On boot, OpenClaude automatically registers the bundled plugin by writing
+these entries into `~\.openclaude\settings.json` (only if missing — your own
+edits are never overwritten):
+
+```json
+{
+  "enabledPlugins": {
+    "openclaude-antigravity-provider@openclaude-antigravity-provider": true
+  },
+  "extraKnownMarketplaces": {
+    "openclaude-antigravity-provider": {
+      "source": { "source": "directory", "path": "…\\vendor\\openclaude-antigravity-provider" }
+    }
+  }
+}
+```
+
+**Verify:** inside OpenClaude run `/plugin` — `openclaude-antigravity-provider`
+should be listed as enabled.
+
+## Step 4 — Add a Google account
+
+1. Inside OpenClaude, type:
+   ```
+   /accounts
+   ```
+2. Select **Add new Google account** — a browser window opens for Google
+   sign-in.
+3. Sign in with your Google account and approve the consent prompt.
+4. The browser shows *"Account added!"* — return to OpenClaude. The account
+   now appears in the list as **enabled**.
+
+Repeat for each account you want in the rotation pool (LRU rotation — the
+least-recently-used healthy account serves each request).
+
+> Accounts are stored in `~\.openclaude\antigravity-accounts.json`.
+> Refresh tokens never leave your machine.
+
+## Step 5 — Select a model and start coding
+
+```
+/model
+```
+
+Pick one of the Antigravity models (auto-discovered from the proxy):
+
+| Model ID | Served as |
+|---|---|
+| `antigravity-gemini-3.1-pro` | Gemini 3.1 Pro (thinking: low) |
+| `antigravity-gemini-3-pro` | Gemini 3 Pro (thinking: low) |
+| `antigravity-gemini-3-flash` | Gemini 3 Flash |
+| `gemini-2.5-pro` / `gemini-2.5-flash` | Gemini 2.5 family |
+| `antigravity-claude-sonnet-4-6` | Claude Sonnet 4.6 |
+| `antigravity-claude-opus-4-6-thinking` | Claude Opus 4.6 (thinking) |
+
+Then just chat — the proxy auto-starts with every session and shuts down when
+OpenClaude exits.
+
+---
+
+## How it works
+
+```
+OpenClaude ──OpenAI-compatible──▶ local proxy (127.0.0.1:51122)
+                                      │  picks healthy Google account (LRU)
+                                      │  refreshes OAuth access token
+                                      ▼
+                      Google Antigravity daily sandbox
+                      (agent-type requests → unlimited quota)
+```
+
+- **Why no rate limits:** requests are sent Antigravity-Manager-style
+  (synthetic project + `requestType: "agent"` + bare tier-suffixed model
+  names) to the daily sandbox endpoint, which routes them into the
+  agent quota pool instead of the per-account free tier.
+- **Rotation:** on a 429 the account is marked rate-limited and the next
+  account is tried. If *all* accounts are limited and the longest wait is
+  under 2 minutes, the proxy silently sleeps it out and retries.
+- **Gemini-CLI fallback (optional):** if every account is exhausted on a
+  Gemini model, the proxy forwards the request to the official Gemini API
+  using the API key from your `~\.openclaude.json` provider profile named
+  **"Google AI / Gemini"** (if configured). Claude models are never rerouted —
+  they return the 429 to OpenClaude as normal.
+
+---
+
+## Managing accounts (`/accounts` reference)
+
+| Action | Effect |
+|---|---|
+| Select an account | Shows status, added/used dates, per-account actions |
+| Enable / Disable | Toggles inclusion in the rotation pool |
+| Clear rate limit | Removes an account's cooldown immediately |
+| Delete account | Removes it from the pool |
+| Clear all rate limits | Removes every cooldown |
+
+## Troubleshooting
+
+| Symptom | Fix |
+|---|---|
+| `openclaude` not found | Restart terminal (PATH refresh) |
+| Models not in `/model` list | Check the proxy: `Invoke-RestMethod http://127.0.0.1:51122/health` — expect `{"status":"ok","accounts":N,...}`. If not running, restart OpenClaude (the SessionStart hook relaunches it) |
+| Proxy slow to start | First launch may be delayed by antivirus scanning the exe (hook waits up to ~8 s; it keeps starting in the background) |
+| Port 51122 busy | Stop the stale process: `Get-Process antigravity-proxy \| Stop-Process -Force`, then restart OpenClaude |
+| OAuth add-account fails "port 51121 busy" | Another add-account flow is in progress or a stale listener holds the port — close it and retry |
+| 429 errors return | Rare on the sandbox path. Open `/accounts` → **Clear all rate limits**, or wait — the proxy auto-sleeps short cooldowns |
+| Settings not auto-written | File may be policy-locked; add the two entries from Step 3 manually or register via `/plugin` |
+
+## Disable / uninstall
+
+**Disable the plugin** (bootstrap will not re-enable it):
+
+```jsonc
+// ~\.openclaude\settings.json
+"enabledPlugins": {
+  "openclaude-antigravity-provider@openclaude-antigravity-provider": false
+}
+```
+
+**Uninstall the package:**
+
+```powershell
+npm uninstall -g @xkei/openclaude
+```
+
+---
+
+## Appendix A — Installing from a source checkout
+
+Requires Bun.
+
+```powershell
+git clone <this-repo>
+cd openclaude
+bun install
+
+# Build the CLI
+bun run build
+
+# Build the bundled proxy executable
+bun run build:proxy
+
+# Produce the installable tarball
+npm pack --pack-destination dist-pack
+npm install -g .\dist-pack\gitlawb-openclaude-0.30.0.tgz
+```
+
+**Standalone plugin only** (existing OpenClaude install): register the
+`vendor/openclaude-antigravity-provider` directory as a marketplace in
+`~\.openclaude\settings.json` (same JSON as Step 3), or copy the folder
+anywhere and point `path` at it, then enable it via `/plugin`.

package/docs/windows-aliases-and-launchers.md

@@ -0,0 +1,162 @@
+# Windows aliases and launchers
+
+This page documents optional PowerShell helper functions for launching OpenClaude on Windows after a global npm install.
+
+These helpers are designed for the installed package workflow:
+
+~~~powershell
+npm install -g @xkei/openclaude
+~~~
+
+The helpers use the installed `openclaude` CLI command. They do not require a source checkout and do not call source-only `bun run scripts/*.ts` entrypoints.
+
+## One-time setup
+
+Run this once in PowerShell:
+
+~~~powershell
+$packageRoot = Join-Path (npm root -g) "@xkei/openclaude"
+$aliases = Join-Path $packageRoot "scripts\windows\openclaude-aliases.ps1"
+
+if (-not (Test-Path $aliases)) {
+  throw "Alias script not found at $aliases. Update or reinstall @xkei/openclaude."
+}
+
+if (-not (Test-Path $PROFILE)) {
+  New-Item -ItemType File -Path $PROFILE -Force | Out-Null
+}
+
+$profileLine = ". `"$aliases`""
+
+if (-not (Select-String -Path $PROFILE -Pattern ([regex]::Escape($profileLine)) -Quiet)) {
+  Add-Content -Path $PROFILE -Value "`n$profileLine"
+}
+
+. $aliases
+oc-help
+~~~
+
+Open a new PowerShell window after setup, or dot-source the profile:
+
+~~~powershell
+. $PROFILE
+~~~
+
+## Daily commands
+
+### Launch OpenClaude using the installed CLI
+
+~~~powershell
+oc
+~~~
+
+You can pass normal CLI arguments through `oc`:
+
+~~~powershell
+oc --version
+oc --help
+~~~
+
+### Launch with local Ollama/OpenAI-compatible environment hints
+
+~~~powershell
+oc-local
+~~~
+
+By default, this uses local Ollama through the OpenAI-compatible API:
+
+~~~text
+CLAUDE_CODE_USE_OPENAI=1
+OPENAI_BASE_URL=http://localhost:11434/v1
+OPENAI_MODEL=llama3.1:8b
+~~~
+
+To use a different local model for that invocation:
+
+~~~powershell
+oc-local -Model "qwen2.5-coder:7b"
+~~~
+
+The environment overrides are scoped to that single `openclaude` invocation. A later plain `oc` call returns to normal installed CLI behavior and saved-provider-profile behavior.
+
+### Launch with low-latency local defaults
+
+~~~powershell
+oc-fast
+~~~
+
+To use a different model:
+
+~~~powershell
+oc-fast -Model "qwen2.5-coder:7b"
+~~~
+
+Like `oc-local`, the environment overrides are scoped to that single invocation.
+
+### Open the provider manager
+
+~~~powershell
+oc-provider
+~~~
+
+This opens the provider manager through the installed OpenClaude CLI.
+
+### Check local Ollama state
+
+~~~powershell
+oc-check
+~~~
+
+To check a specific model:
+
+~~~powershell
+oc-check -Model "qwen2.5-coder:7b"
+~~~
+
+### Pull/check a local model, then launch local mode
+
+~~~powershell
+oc-init
+~~~
+
+To choose a model:
+
+~~~powershell
+oc-init -Model "qwen2.5-coder:7b"
+~~~
+
+To skip pulling the model and only check/launch:
+
+~~~powershell
+oc-init -Model "qwen2.5-coder:7b" -SkipModelPull
+~~~
+
+`oc-init` does not save a provider profile. It pulls/checks the local Ollama model and then launches `oc-local`.
+
+### Show quick help
+
+~~~powershell
+oc-help
+~~~
+
+## Command summary
+
+| Command | Purpose |
+| --- | --- |
+| `oc` | Launch OpenClaude using the installed CLI and saved/default behavior |
+| `oc-local` | Launch once with local Ollama/OpenAI-compatible environment hints |
+| `oc-fast` | Launch once with local Ollama/OpenAI-compatible low-latency hints |
+| `oc-provider` | Open the provider manager |
+| `oc-check` | Show local Ollama install/listening/model state |
+| `oc-init` | Pull/check a local Ollama model, then launch local mode |
+| `oc-help` | Show quick command help |
+
+## Notes
+
+These helpers are intentionally global-install oriented. They use the installed CLI instead of source-checkout development scripts.
+
+For advanced provider setup, use the built-in provider manager:
+
+~~~powershell
+oc-provider
+~~~

package/package.json

@@ -0,0 +1,226 @@
+{
+  "name": "@xkei/openclaude",
+  "version": "0.30.0-antigravity",
+  "description": "OpenClaude opens coding-agent workflows to any LLM — OpenAI, Gemini, DeepSeek, Ollama, and 200+ models",
+  "type": "module",
+  "bin": {
+    "openclaude": "bin/openclaude"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    "./dist/cli.mjs": "./dist/cli.mjs",
+    "./sdk": {
+      "types": "./src/entrypoints/sdk.d.ts",
+      "import": "./dist/sdk.mjs"
+    }
+  },
+  "files": [
+    "bin/",
+    "dist/cli.mjs",
+    "dist/sdk.mjs",
+    "src/entrypoints/sdk.d.ts",
+    "src/entrypoints/sdk/coreTypes.generated.ts",
+    "scripts/windows/openclaude-aliases.ps1",
+    "vendor/node-domexception-shim/",
+    "vendor/openclaude-antigravity-provider/.claude-plugin/",
+    "vendor/openclaude-antigravity-provider/bin/",
+    "vendor/openclaude-antigravity-provider/hooks/",
+    "vendor/openclaude-antigravity-provider/src/",
+    "vendor/openclaude-antigravity-provider/package.json",
+    "vendor/openclaude-antigravity-provider/tsconfig.json",
+    "docs/windows-aliases-and-launchers.md",
+    "docs/antigravity-plugin-install.md",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "bun run scripts/build.ts",
+    "build:proxy": "cd vendor/openclaude-antigravity-provider && bun build --compile src/server.ts --outfile bin/antigravity-proxy.exe",
+    "benchmark:startup": "node scripts/benchmark-openclaude-startup.mjs",
+    "integrations:generate": "bun run scripts/generate-integrations-artifacts.ts",
+    "integrations:check": "bun run scripts/generate-integrations-artifacts.ts --check",
+    "dev": "bun run build && node bin/openclaude",
+    "dev:profile": "bun run scripts/provider-launch.ts",
+    "dev:profile:fast": "bun run scripts/provider-launch.ts auto --fast --bare",
+    "dev:codex": "bun run scripts/provider-launch.ts codex",
+    "dev:openai": "bun run scripts/provider-launch.ts openai",
+    "dev:gemini": "bun run scripts/provider-launch.ts gemini",
+    "dev:ollama": "bun run scripts/provider-launch.ts ollama",
+    "dev:ollama:fast": "bun run scripts/provider-launch.ts ollama --fast --bare",
+    "dev:atomic-chat": "bun run scripts/provider-launch.ts atomic-chat",
+    "profile:init": "bun run scripts/provider-bootstrap.ts",
+    "profile:recommend": "bun run scripts/provider-recommend.ts",
+    "profile:auto": "bun run scripts/provider-recommend.ts --apply",
+    "profile:codex": "bun run profile:init -- --provider codex --model codexplan",
+    "profile:fast": "bun run profile:init -- --provider ollama --model llama3.2:3b",
+    "profile:code": "bun run profile:init -- --provider ollama --model qwen2.5-coder:7b",
+    "dev:fast": "bun run profile:fast && bun run dev:ollama:fast",
+    "dev:code": "bun run profile:code && bun run dev:profile",
+    "dev:grpc": "bun run scripts/start-grpc.ts",
+    "dev:grpc:cli": "bun run scripts/grpc-cli.ts",
+    "start": "node bin/openclaude",
+    "web:dev": "bun run --cwd web dev",
+    "web:build": "bun run --cwd web build",
+    "web:preview": "bun run --cwd web preview",
+    "web:typecheck": "bun run --cwd web typecheck",
+    "test": "bun test --feature=UNATTENDED_RETRY --max-concurrency=1",
+    "test:full": "bun test --feature=UNATTENDED_RETRY --max-concurrency=1 && bun run test:conversation-arc",
+    "test:conversation-arc": "bun test --feature=CONVERSATION_ARC --feature=MULTI_TURN_CONTEXT --max-concurrency=1 src/query.conversationArc.test.ts",
+    "test:coverage": "bun test --feature=UNATTENDED_RETRY --coverage --coverage-reporter=lcov --coverage-dir=coverage --max-concurrency=1 && bun run scripts/render-coverage-heatmap.ts",
+    "test:coverage:ui": "bun run scripts/render-coverage-heatmap.ts",
+    "security:pr-scan": "bun run scripts/pr-intent-scan.ts",
+    "test:provider-recommendation": "bun test src/utils/providerRecommendation.test.ts src/utils/providerProfile.test.ts",
+    "typecheck": "tsc --noEmit",
+    "typecheck:type-tests": "bun run scripts/typecheck-type-tests.ts",
+    "smoke": "bun run build && node dist/cli.mjs --version",
+    "deadcode": "knip --include files,dependencies",
+    "check": "bun run smoke && bun run deadcode && bun run test:full",
+    "verify:privacy": "bun run scripts/verify-no-phone-home.ts",
+    "install:verify": "bun run scripts/verify-clean-install.ts",
+    "install:verify:published": "bun run scripts/verify-clean-install.ts --published",
+    "build:verified": "bun run build && bun run verify:privacy",
+    "test:provider": "bun test --feature=UNATTENDED_RETRY --max-concurrency=1 src/services/api/*.test.ts src/services/api/openaiShim/*.test.ts src/utils/context.test.ts",
+    "doctor:runtime": "bun run scripts/system-check.ts",
+    "doctor:runtime:json": "bun run scripts/system-check.ts --json",
+    "doctor:report": "bun run scripts/system-check.ts --out reports/doctor-runtime.json",
+    "hardening:check": "bun run smoke && bun run doctor:runtime",
+    "hardening:strict": "bun run typecheck && bun run hardening:check",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "@orama/orama": "3.1.18",
+    "@orama/plugin-data-persistence": "3.1.18",
+    "@vscode/ripgrep": "1.18.0"
+  },
+  "devDependencies": {
+    "@alcalzone/ansi-tokenize": "0.3.0",
+    "@anthropic-ai/bedrock-sdk": "0.29.1",
+    "@sentry/node": "^10.70.0",
+    "@anthropic-ai/foundry-sdk": "0.2.3",
+    "@anthropic-ai/sandbox-runtime": "0.0.55",
+    "@anthropic-ai/sdk": "0.94.0",
+    "@aws-sdk/client-bedrock": "3.1047.0",
+    "@aws-sdk/client-sts": "3.1047.0",
+    "@aws-sdk/credential-provider-node": "3.972.41",
+    "@azure/identity": "^4.13.1",
+    "@commander-js/extra-typings": "12.1.0",
+    "@grpc/grpc-js": "^1.14.3",
+    "@grpc/proto-loader": "^0.8.0",
+    "@modelcontextprotocol/sdk": "1.29.0",
+    "@smithy/core": "3.24.3",
+    "@smithy/node-http-handler": "4.7.3",
+    "@types/bun": "1.3.11",
+    "@types/node": "25.5.0",
+    "@types/react": "19.2.14",
+    "ajv": "8.18.0",
+    "auto-bind": "5.0.1",
+    "axios": "1.16.0",
+    "bidi-js": "1.0.3",
+    "chalk": "5.6.2",
+    "chokidar": "4.0.3",
+    "cli-boxes": "3.0.0",
+    "cli-highlight": "2.1.11",
+    "commander": "12.1.0",
+    "cross-spawn": "7.0.6",
+    "diff": "8.0.3",
+    "duck-duck-scrape": "^2.2.7",
+    "emoji-regex": "10.6.0",
+    "env-paths": "3.0.0",
+    "execa": "9.6.1",
+    "fflate": "0.8.2",
+    "figures": "6.1.0",
+    "fuse.js": "7.1.0",
+    "graphology": "0.26.0",
+    "get-east-asian-width": "1.5.0",
+    "google-auth-library": "10.6.2",
+    "https-proxy-agent": "7.0.6",
+    "ignore": "7.0.5",
+    "graphology-metrics": "2.4.0",
+    "indent-string": "5.0.0",
+    "js-tiktoken": "1.0.21",
+    "jsonc-parser": "3.3.1",
+    "knip": "^6.16.1",
+    "lodash-es": "4.18.1",
+    "lru-cache": "11.2.7",
+    "marked": "15.0.12",
+    "p-map": "7.0.4",
+    "picomatch": "4.0.4",
+    "proper-lockfile": "4.1.2",
+    "qrcode": "1.5.4",
+    "react": "19.2.4",
+    "react-compiler-runtime": "1.0.0",
+    "react-reconciler": "0.33.0",
+    "semver": "7.7.4",
+    "sharp": "^0.34.5",
+    "shell-quote": "1.8.4",
+    "signal-exit": "4.1.0",
+    "supports-hyperlinks": "3.2.0",
+    "tree-kill": "1.2.2",
+    "tree-sitter-wasms": "0.1.13",
+    "turndown": "7.2.2",
+    "type-fest": "4.41.0",
+    "typescript": "5.9.3",
+    "undici": "7.28.0",
+    "usehooks-ts": "3.1.1",
+    "web-tree-sitter": "0.25.10",
+    "vscode-languageserver-protocol": "3.17.5",
+    "wrap-ansi": "9.0.2",
+    "ws": "8.21.0",
+    "xss": "1.0.15",
+    "yaml": "2.8.3",
+    "zod": "3.25.76"
+  },
+  "peerDependencies": {
+    "@anthropic-ai/sdk": "^0.94.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "react": "^19.0.0",
+    "react-reconciler": "^0.33.0"
+  },
+  "peerDependenciesMeta": {
+    "@anthropic-ai/sdk": {
+      "optional": true
+    },
+    "@modelcontextprotocol/sdk": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "react-reconciler": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stepanusjanu19/openclaude_antigravity_support.git"
+  },
+  "bugs": {
+    "url": "https://github.com/stepanusjanu19/openclaude_antigravity_support/issues"
+  },
+  "keywords": [
+    "claude-code",
+    "openai",
+    "llm",
+    "cli",
+    "agent",
+    "deepseek",
+    "ollama",
+    "gemini"
+  ],
+  "license": "SEE LICENSE FILE",
+  "publishConfig": {
+    "access": "public"
+  },
+  "overrides": {
+    "ip-address": "10.2.0",
+    "google-auth-library": "10.6.2",
+    "lodash-es": "4.18.1",
+    "node-domexception": "file:vendor/node-domexception-shim"
+  },
+  "allowScripts": {
+    "protobufjs@7.6.4": true,
+    "sharp@0.34.5": true
+  }
+}