@jayjiang/open-cc 0.2.1 → 0.4.0

package/README.md

@@ -1,39 +1,89 @@
 # Open CC
 
-An AI coding assistant CLI tool for the terminal, powered by multi-vendor LLM routing (Anthropic, AWS Bedrock, Google Vertex, Azure Foundry).
+An AI coding assistant CLI tool for the terminal, with multi-provider LLM support (50+ providers including Anthropic, OpenAI, GitHub Copilot, Google Vertex AI, DeepSeek, and more).
 
 ## Install
 
 ```bash
-npm install -g open-cc
+npm install -g @jayjiang/open-cc
 ```
 
 Or with Bun:
 
 ```bash
-bun install -g open-cc
+bun install -g @jayjiang/open-cc
 ```
 
 ## Setup
 
-Set your API key for at least one provider:
+### Option 1: Interactive `/connect` (Recommended)
+
+Launch Open CC and use the `/connect` command to pick a provider and authenticate:
+
+```bash
+opencc
+# Then type: /connect
+```
+
+Supports 50+ providers dynamically loaded from [models.dev](https://models.dev), including:
+
+**Popular**: Anthropic, GitHub Copilot, OpenAI, Google, OpenRouter, Kimi, Zhipu AI, MiniMax
+
+**International**: Mistral, Groq, xAI, Cohere, Perplexity, Together AI, Fireworks, DeepInfra, Cerebras
+
+**China**: DeepSeek, Qwen, Moonshot, Doubao, Baichuan, Hunyuan, ERNIE, SenseTime, and more
+
+### Google Vertex AI
+
+Vertex AI uses Google Cloud Application Default Credentials (ADC). The `/connect` flow guides you through:
+
+1. Checks that `gcloud` CLI is installed
+2. Prompts for GCP project ID and region
+3. Verifies ADC credentials (runs `gcloud auth application-default login` if needed)
+4. Available models: Gemini 3.1 Pro, 3.1 Flash Lite, 3 Flash, 2.5 Flash, 2.5 Pro
+
+```bash
+# Pre-requisite: install gcloud CLI and authenticate
+gcloud auth application-default login
+
+# Then in Open CC:
+/connect  # Select "Google Vertex AI"
+```
+
+### Option 2: Environment Variable
+
+Set your API key for any provider:
 
 ```bash
 # Anthropic (default)
 export ANTHROPIC_API_KEY="sk-ant-..."
 
-# AWS Bedrock
-export AWS_ACCESS_KEY_ID="..."
-export AWS_SECRET_ACCESS_KEY="..."
-export AWS_REGION="us-east-1"
+# OpenAI
+export OPENAI_API_KEY="sk-..."
+
+# DeepSeek
+export DEEPSEEK_API_KEY="sk-..."
+
+# GitHub Copilot (use gh CLI token)
+# Authenticate via /connect in the app
+
+# See presets.ts for all supported env var names
+```
+
+### Option 3: Settings File
 
-# Google Vertex
-export GOOGLE_APPLICATION_CREDENTIALS="/path/to/credentials.json"
-export CLOUD_ML_REGION="us-central1"
+Edit `~/.open-cc/settings.json`:
 
-# Azure Foundry
-export AZURE_API_KEY="..."
-export AZURE_RESOURCE_NAME="..."
+```json
+{
+  "connectedProvider": "openai",
+  "model": "gpt-4o",
+  "providers": {
+    "openai": {
+      "auth": { "type": "api-key", "key": "sk-..." }
+    }
+  }
+}
 ```
 
 ## Usage
@@ -49,10 +99,21 @@ echo "explain this error" | opencc -p
 opencc --resume
 ```
 
+### Provider Commands
+
+```bash
+# Inside the REPL:
+/connect          # Switch provider (search, Popular/Other groups)
+/model            # Switch model for current provider
+```
+
 ## Features
 
 - Interactive REPL terminal UI (React + Ink)
-- Multi-vendor LLM routing (Anthropic, Bedrock, Vertex, Azure)
+- **50+ LLM providers** via OpenAI-compatible adapter + models.dev catalog
+- `/connect` command with search, Popular/Other grouping, OAuth support
+- GitHub Copilot OAuth device code flow
+- Google Vertex AI with Application Default Credentials (ADC)
 - Streaming conversations with tool calls
 - File read, write, edit, and search tools
 - Shell command execution with sandbox support
@@ -69,9 +130,10 @@ Global config lives at `~/.open-cc/`:
 
 | Path | Purpose |
 |------|---------|
-| `settings.json` | Global settings (provider, model, theme, etc.) |
+| `settings.json` | Global settings (provider, model, auth, etc.) |
 | `sessions/` | Session history |
 | `memory/` | Persistent memory files |
+| `cache/models.json` | Cached models.dev provider catalog |
 
 Project-level config: place a `CLAUDE.md` in your project root.
 
@@ -94,12 +156,19 @@ bun test               # Run tests
 bun run health         # Health check (lint + tests + build)
 ```
 
+### Adding a New Provider
+
+See the integration guides for pitfalls and checklists:
+- [Multi-Provider Integration Guide](./docs/multi-provider/integration-guide.md) (GitHub Copilot)
+- [Vertex AI Integration Guide](./docs/multi-provider/vertex-ai-integration.md) (Google Cloud ADC)
+
 ## Tech Stack
 
 - **Runtime**: Bun
 - **UI**: React + Ink (terminal rendering)
 - **CLI**: Commander.js
-- **API**: Anthropic SDK (multi-provider)
+- **API**: Multi-provider (Anthropic SDK + OpenAI-compatible adapter)
+- **Provider Catalog**: [models.dev](https://models.dev) (50+ providers, auto-refreshed)
 - **Build**: Bun.build() with code splitting
 
 ## License

package/dist/{chunk-jdt5s5k7.js → chunk-069dbns4.js}

@@ -2,11 +2,11 @@
 import {
   getDefaultSubagentModel,
   init_agent
-} from "./chunk-2y54j9ew.js";
+} from "./chunk-5635sk0j.js";
 import {
   getSourceDisplayName,
   init_constants
-} from "./chunk-30chpfyc.js";
+} from "./chunk-fq3bhb3m.js";
 import {
   __esm
 } from "./chunk-qp2qdcda.js";

package/dist/{chunk-789khc7a.js → chunk-0835agam.js}

@@ -6,10 +6,10 @@ import {
   init_useSettingsChange,
   useNotifications,
   useSettingsChange
-} from "./chunk-2y54j9ew.js";
+} from "./chunk-5635sk0j.js";
 import {
   require_compiler_runtime
-} from "./chunk-0yb4dz9c.js";
+} from "./chunk-zn656x85.js";
 import {
   require_react
 } from "./chunk-g338npwr.js";

package/dist/{chunk-4qedx22a.js → chunk-0bdhgvy1.js}

@@ -3,7 +3,7 @@ import {
   ThemedText,
   init_ink,
   require_compiler_runtime
-} from "./chunk-0yb4dz9c.js";
+} from "./chunk-zn656x85.js";
 import {
   require_jsx_dev_runtime
 } from "./chunk-g338npwr.js";

package/dist/{chunk-26k0324b.js → chunk-0dfqvmb4.js}

@@ -2,7 +2,7 @@
 import {
   editFileInEditor,
   init_promptEditor
-} from "./chunk-m0g3xv72.js";
+} from "./chunk-hj3vdw50.js";
 import {
   ListItem,
   Select,
@@ -19,43 +19,43 @@ import {
   isAutoDreamEnabled,
   readLastConsolidatedAt,
   useAppState
-} from "./chunk-2y54j9ew.js";
+} from "./chunk-5635sk0j.js";
 import"./chunk-1yzc16qa.js";
-import"./chunk-s10vyjz4.js";
-import"./chunk-1k4j1xcf.js";
-import"./chunk-3c4qja3e.js";
-import"./chunk-rc5bbzx4.js";
+import"./chunk-nn12ezz8.js";
+import"./chunk-xg2mj5wq.js";
+import"./chunk-ykek4ge8.js";
+import"./chunk-pcht3gfq.js";
 import {
   Dialog,
   init_Dialog
-} from "./chunk-e6rrwzv0.js";
+} from "./chunk-r6knz78j.js";
 import"./chunk-2gzv8nrw.js";
 import"./chunk-743znc5c.js";
-import"./chunk-5p2ssw3d.js";
+import"./chunk-rvd8vyfs.js";
 import"./chunk-cgfdkzhb.js";
 import"./chunk-bhdt6k7w.js";
 import"./chunk-6wkdqk81.js";
 import"./chunk-5dbk24zg.js";
-import"./chunk-bda3gxxz.js";
-import"./chunk-zxhezavg.js";
+import"./chunk-gdmvfdmg.js";
+import"./chunk-xkfhbsf1.js";
 import {
   init_useExitOnCtrlCDWithKeybindings,
   useExitOnCtrlCDWithKeybindings
-} from "./chunk-x8eg216f.js";
+} from "./chunk-yp9ftz6g.js";
 import"./chunk-9gbamk79.js";
-import"./chunk-t175chdd.js";
+import"./chunk-1wa2q75b.js";
 import"./chunk-7rjyn5d3.js";
 import {
   init_useKeybinding,
   useKeybinding
-} from "./chunk-6q2x8zeg.js";
+} from "./chunk-q7h2cve1.js";
 import {
   Link,
   ThemedBox_default,
   ThemedText,
   init_ink,
   require_compiler_runtime
-} from "./chunk-0yb4dz9c.js";
+} from "./chunk-zn656x85.js";
 import"./chunk-7m2nd8da.js";
 import"./chunk-ps49ymvj.js";
 import {
@@ -63,13 +63,13 @@ import {
   require_react
 } from "./chunk-g338npwr.js";
 import"./chunk-zk2wsm7d.js";
-import"./chunk-eh474zhj.js";
+import"./chunk-dh739avg.js";
 import {
   init_browser,
   openPath
 } from "./chunk-ga5faygf.js";
-import"./chunk-e7c8ypwc.js";
-import"./chunk-g6qddbvf.js";
+import"./chunk-hfpyfd75.js";
+import"./chunk-jj1hyewd.js";
 import"./chunk-b1s11z4y.js";
 import"./chunk-4jm600zv.js";
 import"./chunk-yxmz5k16.js";
@@ -85,7 +85,7 @@ import {
   isAutoMemoryEnabled,
   source_default,
   updateSettingsForSource
-} from "./chunk-30chpfyc.js";
+} from "./chunk-fq3bhb3m.js";
 import"./chunk-84k64e4a.js";
 import"./chunk-y3py9g5d.js";
 import"./chunk-7pemewz2.js";

package/dist/{chunk-kkrz2zw2.js → chunk-0gqmbg8s.js}

@@ -20,42 +20,42 @@ import {
   restoreWorktreeSession,
   validateWorktreeSlug,
   worktreeBranchName
-} from "./chunk-2y54j9ew.js";
+} from "./chunk-5635sk0j.js";
 import"./chunk-1yzc16qa.js";
-import"./chunk-s10vyjz4.js";
-import"./chunk-1k4j1xcf.js";
-import"./chunk-3c4qja3e.js";
-import"./chunk-rc5bbzx4.js";
-import"./chunk-e6rrwzv0.js";
+import"./chunk-nn12ezz8.js";
+import"./chunk-xg2mj5wq.js";
+import"./chunk-ykek4ge8.js";
+import"./chunk-pcht3gfq.js";
+import"./chunk-r6knz78j.js";
 import"./chunk-2gzv8nrw.js";
 import"./chunk-743znc5c.js";
-import"./chunk-5p2ssw3d.js";
+import"./chunk-rvd8vyfs.js";
 import"./chunk-cgfdkzhb.js";
 import"./chunk-bhdt6k7w.js";
 import"./chunk-6wkdqk81.js";
 import"./chunk-5dbk24zg.js";
-import"./chunk-bda3gxxz.js";
-import"./chunk-zxhezavg.js";
-import"./chunk-x8eg216f.js";
+import"./chunk-gdmvfdmg.js";
+import"./chunk-xkfhbsf1.js";
+import"./chunk-yp9ftz6g.js";
 import"./chunk-9gbamk79.js";
-import"./chunk-t175chdd.js";
+import"./chunk-1wa2q75b.js";
 import"./chunk-7rjyn5d3.js";
-import"./chunk-6q2x8zeg.js";
-import"./chunk-0yb4dz9c.js";
+import"./chunk-q7h2cve1.js";
+import"./chunk-zn656x85.js";
 import"./chunk-7m2nd8da.js";
 import"./chunk-ps49ymvj.js";
 import"./chunk-g338npwr.js";
 import"./chunk-zk2wsm7d.js";
-import"./chunk-eh474zhj.js";
+import"./chunk-dh739avg.js";
 import"./chunk-ga5faygf.js";
-import"./chunk-e7c8ypwc.js";
-import"./chunk-g6qddbvf.js";
+import"./chunk-hfpyfd75.js";
+import"./chunk-jj1hyewd.js";
 import"./chunk-b1s11z4y.js";
 import"./chunk-4jm600zv.js";
 import"./chunk-yxmz5k16.js";
 import"./chunk-v9smspw2.js";
 import"./chunk-qz2x630m.js";
-import"./chunk-30chpfyc.js";
+import"./chunk-fq3bhb3m.js";
 import"./chunk-84k64e4a.js";
 import"./chunk-y3py9g5d.js";
 import"./chunk-7pemewz2.js";

package/dist/{chunk-eaf7c8ck.js → chunk-0kahb9mv.js}

@@ -2,45 +2,45 @@
 import {
   PromptInputHelpMenu,
   init_PromptInputHelpMenu
-} from "./chunk-7azp8c8y.js";
+} from "./chunk-6wvp7ngj.js";
 import {
   Tab,
   Tabs,
   init_Tabs,
   useTabHeaderFocus
-} from "./chunk-3z7ae04g.js";
-import"./chunk-8pf73pc8.js";
+} from "./chunk-2t51rgyr.js";
+import"./chunk-47w2z6hx.js";
 import {
   Select,
   builtInCommandNames,
   formatDescriptionWithSource,
   init_commands1 as init_commands,
   init_select
-} from "./chunk-2y54j9ew.js";
+} from "./chunk-5635sk0j.js";
 import"./chunk-1yzc16qa.js";
-import"./chunk-s10vyjz4.js";
-import"./chunk-1k4j1xcf.js";
-import"./chunk-3c4qja3e.js";
-import"./chunk-rc5bbzx4.js";
+import"./chunk-nn12ezz8.js";
+import"./chunk-xg2mj5wq.js";
+import"./chunk-ykek4ge8.js";
+import"./chunk-pcht3gfq.js";
 import {
   init_useShortcutDisplay,
   useShortcutDisplay
-} from "./chunk-e6rrwzv0.js";
+} from "./chunk-r6knz78j.js";
 import"./chunk-2gzv8nrw.js";
 import"./chunk-743znc5c.js";
-import"./chunk-5p2ssw3d.js";
+import"./chunk-rvd8vyfs.js";
 import"./chunk-cgfdkzhb.js";
 import"./chunk-bhdt6k7w.js";
 import"./chunk-6wkdqk81.js";
 import"./chunk-5dbk24zg.js";
-import"./chunk-bda3gxxz.js";
-import"./chunk-zxhezavg.js";
+import"./chunk-gdmvfdmg.js";
+import"./chunk-xkfhbsf1.js";
 import {
   init_useExitOnCtrlCDWithKeybindings,
   useExitOnCtrlCDWithKeybindings
-} from "./chunk-x8eg216f.js";
+} from "./chunk-yp9ftz6g.js";
 import"./chunk-9gbamk79.js";
-import"./chunk-t175chdd.js";
+import"./chunk-1wa2q75b.js";
 import"./chunk-7rjyn5d3.js";
 import {
   Pane,
@@ -51,30 +51,30 @@ import {
   useIsInsideModal,
   useKeybinding,
   useTerminalSize
-} from "./chunk-6q2x8zeg.js";
+} from "./chunk-q7h2cve1.js";
 import {
   Link,
   ThemedBox_default,
   ThemedText,
   init_ink,
   require_compiler_runtime
-} from "./chunk-0yb4dz9c.js";
+} from "./chunk-zn656x85.js";
 import"./chunk-7m2nd8da.js";
 import"./chunk-ps49ymvj.js";
 import {
   require_jsx_dev_runtime
 } from "./chunk-g338npwr.js";
 import"./chunk-zk2wsm7d.js";
-import"./chunk-eh474zhj.js";
+import"./chunk-dh739avg.js";
 import"./chunk-ga5faygf.js";
-import"./chunk-e7c8ypwc.js";
-import"./chunk-g6qddbvf.js";
+import"./chunk-hfpyfd75.js";
+import"./chunk-jj1hyewd.js";
 import"./chunk-b1s11z4y.js";
 import"./chunk-4jm600zv.js";
 import"./chunk-yxmz5k16.js";
 import"./chunk-v9smspw2.js";
 import"./chunk-qz2x630m.js";
-import"./chunk-30chpfyc.js";
+import"./chunk-fq3bhb3m.js";
 import"./chunk-84k64e4a.js";
 import"./chunk-y3py9g5d.js";
 import"./chunk-7pemewz2.js";

package/dist/{chunk-178ykx7k.js → chunk-0qy38dac.js}

@@ -2,28 +2,28 @@
 import {
   ValidationErrorsList,
   init_ValidationErrorsList
-} from "./chunk-cr6t6rth.js";
+} from "./chunk-vjxxksfk.js";
 import {
   init_useSettingsErrors,
   useSettingsErrors
-} from "./chunk-789khc7a.js";
+} from "./chunk-0835agam.js";
 import {
   PressEnterToContinue,
   init_PressEnterToContinue
-} from "./chunk-4qedx22a.js";
+} from "./chunk-0bdhgvy1.js";
 import {
   detectUnreachableRules,
   init_shadowedRuleDetection
-} from "./chunk-jpgr7zfs.js";
+} from "./chunk-q185tj2k.js";
 import {
   AGENT_DESCRIPTIONS_THRESHOLD,
   getAgentDescriptionsTotalTokens,
   init_statusNoticeHelpers
-} from "./chunk-sfht9xvd.js";
+} from "./chunk-wgqg6g51.js";
 import {
   McpParsingWarnings,
   init_McpParsingWarnings
-} from "./chunk-pthzapbx.js";
+} from "./chunk-xjeqam4f.js";
 import {
   BASH_MAX_OUTPUT_DEFAULT,
   BASH_MAX_OUTPUT_UPPER_LIMIT,
@@ -62,23 +62,23 @@ import {
   roughTokenCountEstimation,
   useAppState,
   validateBoundedIntEnvVar
-} from "./chunk-2y54j9ew.js";
+} from "./chunk-5635sk0j.js";
 import {
   init_useExitOnCtrlCDWithKeybindings,
   useExitOnCtrlCDWithKeybindings
-} from "./chunk-x8eg216f.js";
+} from "./chunk-yp9ftz6g.js";
 import {
   Pane,
   init_Pane,
   init_useKeybinding,
   useKeybindings
-} from "./chunk-6q2x8zeg.js";
+} from "./chunk-q7h2cve1.js";
 import {
   ThemedBox_default,
   ThemedText,
   init_ink,
   require_compiler_runtime
-} from "./chunk-0yb4dz9c.js";
+} from "./chunk-zn656x85.js";
 import {
   require_jsx_dev_runtime,
   require_react
@@ -96,7 +96,7 @@ import {
   pathExists,
   permissionRuleValueToString,
   plural
-} from "./chunk-30chpfyc.js";
+} from "./chunk-fq3bhb3m.js";
 import {
   figures_default,
   init_figures

package/dist/{chunk-svar8pp2.js → chunk-0w9z2zwf.js}

@@ -2,17 +2,17 @@
 import {
   CCRClient,
   SSETransport
-} from "./chunk-3m45xtza.js";
+} from "./chunk-fcwdx0ba.js";
 import {
   registerWorker
 } from "./chunk-kyvwf342.js";
 import {
   init_bridgeEnabled
-} from "./chunk-b9k5cs09.js";
+} from "./chunk-93emhb8f.js";
 import {
   init_sessionIngressAuth,
   updateSessionIngressAuthToken
-} from "./chunk-s10vyjz4.js";
+} from "./chunk-nn12ezz8.js";
 import {
   init_semver,
   lt
@@ -20,7 +20,7 @@ import {
 import {
   getFeatureValue_DEPRECATED,
   init_growthbook
-} from "./chunk-30chpfyc.js";
+} from "./chunk-fq3bhb3m.js";
 import {
   init_v4
 } from "./chunk-g0j0t6qk.js";

package/dist/{chunk-qgjgqmy5.js → chunk-0ykfpxvc.js}

@@ -10,35 +10,35 @@ import {
   getRecentReleaseNotesSync,
   init_logoV2Utils,
   truncatePath
-} from "./chunk-m4bc15mz.js";
+} from "./chunk-xys2sdyd.js";
 import {
   checkForReleaseNotesSync,
   init_releaseNotes
-} from "./chunk-t7z7vg91.js";
+} from "./chunk-e8jvq82w.js";
 import {
   AGENT_DESCRIPTIONS_THRESHOLD,
   getAgentDescriptionsTotalTokens,
   init_statusNoticeHelpers
-} from "./chunk-sfht9xvd.js";
+} from "./chunk-wgqg6g51.js";
 import {
   OverageCreditUpsell,
   createOverageCreditFeed,
   incrementOverageCreditUpsellSeenCount,
   init_OverageCreditUpsell,
   useShowOverageCreditUpsell
-} from "./chunk-nrnkshv2.js";
+} from "./chunk-c2jm4mw0.js";
 import {
   PromptInputFooterSuggestions_default,
   init_PromptInputFooterSuggestions
-} from "./chunk-47gy6qkp.js";
+} from "./chunk-v5f1ccgn.js";
 import {
   ScrollBox_default,
   init_ScrollBox
-} from "./chunk-8pf73pc8.js";
+} from "./chunk-47w2z6hx.js";
 import {
   init_useMainLoopModel,
   useMainLoopModel
-} from "./chunk-khmz14d4.js";
+} from "./chunk-ngynyrep.js";
 import {
   AssistantThinkingMessage,
   BACKGROUND_BASH_SUMMARY_PREFIX,
@@ -106,24 +106,24 @@ import {
   toRGBColor,
   toolCallOf,
   useAppState
-} from "./chunk-2y54j9ew.js";
+} from "./chunk-5635sk0j.js";
 import {
   init_useShortcutDisplay,
   useShortcutDisplay
-} from "./chunk-e6rrwzv0.js";
+} from "./chunk-r6knz78j.js";
 import {
   checkCachedPassesEligibility,
   formatCreditAmount,
   getCachedReferrerReward,
   getCachedRemainingPasses,
   init_referral
-} from "./chunk-zxhezavg.js";
+} from "./chunk-xkfhbsf1.js";
 import {
   getSteps,
   incrementProjectOnboardingSeenCount,
   init_projectOnboardingState,
   shouldShowProjectOnboarding
-} from "./chunk-t175chdd.js";
+} from "./chunk-1wa2q75b.js";
 import {
   Divider,
   ModalContext,
@@ -131,7 +131,7 @@ import {
   init_modalContext,
   init_useTerminalSize,
   useTerminalSize
-} from "./chunk-6q2x8zeg.js";
+} from "./chunk-q7h2cve1.js";
 import {
   TextHoverColorContext,
   ThemedBox_default,
@@ -149,7 +149,7 @@ import {
   resolveThemeSetting,
   useAnimationFrame,
   useTerminalNotification
-} from "./chunk-0yb4dz9c.js";
+} from "./chunk-zn656x85.js";
 import {
   require_jsx_dev_runtime,
   require_react
@@ -186,7 +186,7 @@ import {
   saveGlobalConfig,
   sleep,
   source_default
-} from "./chunk-30chpfyc.js";
+} from "./chunk-fq3bhb3m.js";
 import {
   env,
   init_env