@kaitranntt/ccs 4.4.0 → 5.0.1

package/README.md

@@ -46,10 +46,14 @@ bun add -g @kaitranntt/ccs
 ```
 
 <details>
-<summary><strong>Alternative: Direct Install (Traditional)</strong></summary>
+<summary><strong>[!] DEPRECATED: Native Shell Installers (Legacy)</strong></summary>
 
 <br>
 
+> [!WARNING]
+> **These installers are deprecated and will be removed in a future version.**
+> They now auto-redirect to npm installation. Please use npm directly.
+
 **macOS / Linux**
 ```bash
 curl -fsSL ccs.kaitran.ca/install | bash
@@ -60,12 +64,79 @@ curl -fsSL ccs.kaitran.ca/install | bash
 irm ccs.kaitran.ca/install | iex
 ```
 
-**Note:** Traditional installs bypass Node.js routing for faster startup, but npm is prioritized for easier deployment automation.
+**Note:** Scripts show deprecation warning and automatically run npm installation if Node.js is available.
 
 </details>
 
 <br>
 
+## Zero-Config OAuth Providers
+
+**New in v5.0.0**: Instant access to premium models with zero API key setup. Browser-based OAuth authentication.
+
+> Powered by [CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI) - the universal API proxy for AI models.
+
+| Provider | Default Model | Opus | Haiku | Example |
+|:---------|:--------------|:-----|:------|:--------|
+| **Gemini** | gemini-2.5-pro | gemini-2.5-pro | gemini-2.5-flash | `ccs gemini "explain code"` |
+| **Codex** | gpt-5.1-codex-max | gpt-5.1-codex-max-high | gpt-5.1-codex-mini-high | `ccs codex "implement API"` |
+| **Antigravity** | gemini-3-pro-preview | gemini-3-pro-preview | gemini-2.5-flash | `ccs agy "review architecture"` |
+
+**First Run**: Browser opens for authentication. Tokens cached in `~/.ccs/cliproxy/auth/<provider>/`.
+
+**Subsequent Runs**: Instant - no re-auth needed until token expires.
+
+### Authentication Commands
+
+```bash
+# Interactive OAuth (default) - browser opens, complete auth
+ccs gemini
+
+# Authenticate only (save tokens, don't start session)
+ccs gemini --auth
+ccs codex --auth
+
+# Headless mode (for SSH/servers without browser)
+ccs agy --headless       # Displays URL, paste in browser elsewhere
+
+# Logout (clear tokens)
+ccs gemini --logout
+```
+
+### OAuth vs API Key Models
+
+| Feature | OAuth Providers<br>(gemini, codex, agy) | API Key Models<br>(glm, kimi) |
+|:--------|:----------------------------------------|:------------------------------|
+| **Setup** | Browser auth on first run | Edit settings.json, add API key |
+| **Token Storage** | `~/.ccs/cliproxy/auth/<provider>/` | `~/.ccs/*.settings.json` |
+| **Renewal** | Automatic (OAuth refresh tokens) | Manual (update key when expired) |
+| **Binary** | Auto-downloads CLIProxyAPI (~15MB) | No additional binaries |
+| **Port** | 8317 (configurable) | N/A |
+| **Best For** | Quick testing, no key management | Production, explicit key control |
+
+### Troubleshooting OAuth
+
+**OAuth timeout (2min limit)**:
+```bash
+# If browser doesn't load in time:
+ccs gemini --auth --headless   # Get URL manually
+```
+
+**Port 8317 conflict**:
+```bash
+ccs doctor                      # Check port availability
+# Error: "Port 8317 in use"
+lsof -ti:8317 | xargs kill      # Unix: kill process using port
+```
+
+**Binary download failures**:
+```bash
+ccs doctor                      # Shows binary status + version
+# Manual download: https://github.com/router-for-me/CLIProxyAPI/releases
+```
+
+<br>
+
 ### Configuration (Auto-created)
 
 **CCS automatically creates configuration during installation** (via npm postinstall script).
@@ -303,8 +374,24 @@ graph LR
 
 ## Architecture
 
+CCS resolves profiles in priority order:
+1. **CLIProxy profiles** (gemini, codex, agy) - OAuth-based, zero config
+2. **Settings-based profiles** (glm, kimi) - API key required
+3. **Account-based profiles** (work, personal) - Isolated Claude instances
+4. **Default** - Claude CLI with subscription
+
 ### Profile Types
 
+**CLIProxy**: gemini, codex, agy (v5.0+)
+- OAuth-based authentication via [CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)
+- Browser auth on first run, tokens cached in `~/.ccs/cliproxy/auth/<provider>/`
+- Proxy runs on port 8317, auto-spawned per session
+- Binary: `~/.ccs/cliproxy/bin/cli-proxy-api` (~15MB, auto-downloaded)
+- Model mappings:
+  - **Gemini**: gemini-2.5-pro (opus), gemini-2.0-flash (sonnet), flash-lite (haiku)
+  - **Codex**: gpt-5.1-codex-max (opus), gpt-4o (sonnet), gpt-4o-mini (haiku)
+  - **Antigravity**: agy-pro (sonnet), agy-turbo (haiku)
+
 **Settings-based**: GLM, GLMT, Kimi, default
 - Uses `--settings` flag pointing to config files
 - GLMT: Embedded proxy for thinking mode support
@@ -325,6 +412,7 @@ graph LR
 - sessions/ - Conversation history
 - todolists/ - Todo lists
 - logs/ - Execution logs
+- **cliproxy/auth/** - OAuth tokens (CLIProxy profiles only)
 
 > [!NOTE]
 > **v4.4 Breaking Change**: settings.json now shared across profiles. Previously each profile had isolated settings. Migration is automatic on install using ~/.claude/settings.json as the authoritative source. Backups created: `<instance>/settings.json.pre-shared-migration`
@@ -748,15 +836,18 @@ ccs sync
 
 ## Uninstall
 
+### npm (Recommended)
+
+```bash
+npm uninstall -g @kaitranntt/ccs
+```
+
 <details>
-<summary><h3>Package Managers</h3></summary>
+<summary><strong>Alternative Package Managers</strong></summary>
 
 <br>
 
 ```bash
-# npm
-npm uninstall -g @kaitranntt/ccs
-
 # yarn
 yarn global remove @kaitranntt/ccs
 
@@ -770,7 +861,7 @@ bun remove -g @kaitranntt/ccs
 </details>
 
 <details>
-<summary><h3>Official Uninstaller</h3></summary>
+<summary><strong>Legacy Uninstallers (for native installs)</strong></summary>
 
 <br>
 

package/VERSION

@@ -1 +1 @@
-4.4.0
+5.0.1

package/config/base-agy.settings.json

@@ -0,0 +1,10 @@
+{
+  "env": {
+    "ANTHROPIC_BASE_URL": "http://127.0.0.1:8317/api/provider/agy",
+    "ANTHROPIC_AUTH_TOKEN": "ccs-internal-managed",
+    "ANTHROPIC_MODEL": "gemini-3-pro-preview",
+    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gemini-3-pro-preview",
+    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gemini-3-pro-preview",
+    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gemini-2.5-flash"
+  }
+}

package/config/base-codex.settings.json

@@ -0,0 +1,10 @@
+{
+  "env": {
+    "ANTHROPIC_BASE_URL": "http://127.0.0.1:8317/api/provider/codex",
+    "ANTHROPIC_AUTH_TOKEN": "ccs-internal-managed",
+    "ANTHROPIC_MODEL": "gpt-5.1-codex-max",
+    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-5.1-codex-max-high",
+    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-5.1-codex-max",
+    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gpt-5.1-codex-mini-high"
+  }
+}

package/config/base-gemini.settings.json

@@ -0,0 +1,10 @@
+{
+  "env": {
+    "ANTHROPIC_BASE_URL": "http://127.0.0.1:8317/api/provider/gemini",
+    "ANTHROPIC_AUTH_TOKEN": "ccs-internal-managed",
+    "ANTHROPIC_MODEL": "gemini-2.5-pro",
+    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gemini-2.5-pro",
+    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gemini-2.5-pro",
+    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gemini-2.5-flash"
+  }
+}

package/dist/auth/auth-commands.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Auth Commands (Simplified)
+ *
+ * CLI interface for CCS multi-account management.
+ * Commands: create, list, show, remove, default
+ *
+ * Login-per-profile model: Each profile is an isolated Claude instance.
+ * Users login directly in each instance (no credential copying).
+ */
+/**
+ * Auth Commands Class
+ */
+declare class AuthCommands {
+    private registry;
+    private instanceMgr;
+    private readonly version;
+    constructor();
+    /**
+     * Show help for auth commands
+     */
+    showHelp(): void;
+    /**
+     * Parse command arguments
+     */
+    private parseArgs;
+    /**
+     * Create new profile and prompt for login
+     */
+    handleCreate(args: string[]): Promise<void>;
+    /**
+     * List all saved profiles
+     */
+    handleList(args: string[]): Promise<void>;
+    /**
+     * Show details for a specific profile
+     */
+    handleShow(args: string[]): Promise<void>;
+    /**
+     * Remove a saved profile
+     */
+    handleRemove(args: string[]): Promise<void>;
+    /**
+     * Set default profile
+     */
+    handleDefault(args: string[]): Promise<void>;
+    /**
+     * Route auth command to appropriate handler
+     */
+    route(args: string[]): Promise<void>;
+}
+export default AuthCommands;
+//# sourceMappingURL=auth-commands.d.ts.map

package/dist/auth/auth-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-commands.d.ts","sourceRoot":"","sources":["../../src/auth/auth-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmCH;;GAEG;AACH,cAAM,YAAY;IAChB,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;;IAOvD;;OAEG;IACH,QAAQ,IAAI,IAAI;IAsDhB;;OAEG;IACH,OAAO,CAAC,SAAS;IAWjB;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgGjD;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkG/C;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgE/C;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiEjD;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBlD;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CA8D3C;AAED,eAAe,YAAY,CAAC"}