Merge pull request #354 from jellydn/feat/ollama-provider

feat: add Ollama provider support

README.md

@@ -95,6 +95,8 @@ The dashboard provides visual management for all account types:
 | **Kiro** | OAuth | `ccs kiro` | AWS CodeWhisperer (Claude-powered) |
 | **Antigravity** | OAuth | `ccs agy` | Alternative routing |
 | **OpenRouter** | API Key | `ccs openrouter` | 300+ models, unified API |
+| **Ollama** | Local | `ccs ollama` | Local open-source models, privacy |
+| **Ollama Cloud** | API Key | `ccs ollama-cloud` | Cloud-hosted open-source models |
 | **GLM** | API Key | `ccs glm` | Cost-optimized execution |
 | **Kimi** | API Key | `ccs kimi` | Long-context, thinking mode |
 | **Azure Foundry** | API Key | `ccs foundry` | Claude via Microsoft Azure |
@@ -104,6 +106,8 @@ The dashboard provides visual management for all account types:
 
 **OpenRouter Integration** (v7.0.0): CCS v7.0.0 adds OpenRouter with interactive model picker, dynamic discovery, and tier mapping (opus/sonnet/haiku). Create via `ccs api create --preset openrouter` or dashboard.
 
+**Ollama Integration**: Run local open-source models (qwen3-coder, gpt-oss:20b) with full privacy. Use `ccs api create --preset ollama` - requires [Ollama v0.14.0+](https://ollama.com) installed. For cloud models, use `ccs api create --preset ollama-cloud`.
+
 **Azure Foundry**: Use `ccs api create --preset foundry` to set up Claude via Microsoft Azure AI Foundry. Requires Azure resource and API key from [ai.azure.com](https://ai.azure.com).
 
 ![OpenRouter API Profiles](assets/screenshots/api-profiles-openrouter.webp)
@@ -131,6 +135,7 @@ ccs codex     # OpenAI Codex (OAuth)
 ccs kiro      # Kiro/AWS CodeWhisperer (OAuth)
 ccs ghcp      # GitHub Copilot (OAuth device flow)
 ccs agy       # Antigravity (OAuth)
+ccs ollama    # Local Ollama (no API key needed)
 ccs glm       # GLM (API key)
 ```
 
@@ -145,7 +150,10 @@ ccs work "design the authentication system"
 # Terminal 2: Execution (GLM - cost optimized)
 ccs glm "implement the user service from the plan"
 
-# Terminal 3: Review (Gemini)
+# Terminal 3: Local testing (Ollama - offline, privacy)
+ccs ollama "run tests and generate coverage report"
+
+# Terminal 4: Review (Gemini)
 ccs gemini "review the implementation for security issues"
 ```
 

config/base-ollama-cloud.settings.json

@@ -0,0 +1,10 @@
+{
+  "env": {
+    "ANTHROPIC_BASE_URL": "https://ollama.com",
+    "ANTHROPIC_AUTH_TOKEN": "YOUR_OLLAMA_CLOUD_API_KEY_HERE",
+    "ANTHROPIC_MODEL": "glm-4.7:cloud",
+    "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3-coder:480b",
+    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.7:cloud",
+    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "minimax-m2.1:cloud"
+  }
+}

config/base-ollama.settings.json

@@ -0,0 +1,10 @@
+{
+  "env": {
+    "ANTHROPIC_BASE_URL": "http://localhost:11434",
+    "ANTHROPIC_AUTH_TOKEN": "ollama",
+    "ANTHROPIC_MODEL": "qwen3-coder",
+    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-oss:120b",
+    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-oss:20b",
+    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3-coder"
+  }
+}

src/api/services/provider-presets.ts

@@ -17,6 +17,8 @@ export interface ProviderPreset {
   apiKeyPlaceholder: string;
   apiKeyHint: string;
   category: PresetCategory;
+  /** Whether API key is required (default: true, set false for local providers) */
+  requiresApiKey: boolean;
   /** Additional env vars for thinking mode, etc. */
   extraEnv?: Record<string, string>;
   /** Enable always thinking mode */
@@ -42,6 +44,19 @@ export const PROVIDER_PRESETS: ProviderPreset[] = [
     apiKeyPlaceholder: 'sk-or-...',
     apiKeyHint: 'Get your API key at openrouter.ai/keys',
     category: 'recommended',
+    requiresApiKey: true,
+  },
+  {
+    id: 'ollama',
+    name: 'Ollama (Local)',
+    description: 'Local open-source models via Ollama (32K+ context)',
+    baseUrl: 'http://localhost:11434',
+    defaultProfileName: 'ollama',
+    defaultModel: 'qwen3-coder',
+    apiKeyPlaceholder: 'ollama',
+    apiKeyHint: 'Install Ollama from ollama.com - no API key needed for local',
+    category: 'recommended',
+    requiresApiKey: false,
   },
   // Alternative providers
   {
@@ -54,6 +69,7 @@ export const PROVIDER_PRESETS: ProviderPreset[] = [
     apiKeyPlaceholder: 'ghp_...',
     apiKeyHint: 'Get your API key from Z.AI',
     category: 'alternative',
+    requiresApiKey: true,
   },
   {
     id: 'glmt',
@@ -65,6 +81,7 @@ export const PROVIDER_PRESETS: ProviderPreset[] = [
     apiKeyPlaceholder: 'ghp_...',
     apiKeyHint: 'Same API key as GLM',
     category: 'alternative',
+    requiresApiKey: true,
     extraEnv: {
       ANTHROPIC_TEMPERATURE: '0.2',
       ANTHROPIC_MAX_TOKENS: '65536',
@@ -85,6 +102,7 @@ export const PROVIDER_PRESETS: ProviderPreset[] = [
     apiKeyPlaceholder: 'sk-...',
     apiKeyHint: 'Get your API key from Moonshot AI',
     category: 'alternative',
+    requiresApiKey: true,
     alwaysThinkingEnabled: true,
   },
   {
@@ -97,6 +115,7 @@ export const PROVIDER_PRESETS: ProviderPreset[] = [
     apiKeyPlaceholder: 'YOUR_AZURE_API_KEY',
     apiKeyHint: 'Create resource at ai.azure.com, get API key from Keys tab',
     category: 'alternative',
+    requiresApiKey: true,
   },
   {
     id: 'mm',
@@ -108,6 +127,7 @@ export const PROVIDER_PRESETS: ProviderPreset[] = [
     apiKeyPlaceholder: 'YOUR_MINIMAX_API_KEY_HERE',
     apiKeyHint: 'Get your API key at platform.minimax.io',
     category: 'alternative',
+    requiresApiKey: true,
   },
   {
     id: 'deepseek',
@@ -119,6 +139,7 @@ export const PROVIDER_PRESETS: ProviderPreset[] = [
     apiKeyPlaceholder: 'sk-...',
     apiKeyHint: 'Get your API key at platform.deepseek.com',
     category: 'alternative',
+    requiresApiKey: true,
   },
   {
     id: 'qwen',
@@ -130,6 +151,19 @@ export const PROVIDER_PRESETS: ProviderPreset[] = [
     apiKeyPlaceholder: 'sk-...',
     apiKeyHint: 'Get your API key from Alibaba Cloud Model Studio',
     category: 'alternative',
+    requiresApiKey: true,
+  },
+  {
+    id: 'ollama-cloud',
+    name: 'Ollama Cloud',
+    description: 'Ollama cloud models via direct API (glm-4.7:cloud, minimax-m2.1:cloud)',
+    baseUrl: 'https://ollama.com',
+    defaultProfileName: 'ollama-cloud',
+    defaultModel: 'glm-4.7:cloud',
+    apiKeyPlaceholder: 'YOUR_OLLAMA_CLOUD_API_KEY',
+    apiKeyHint: 'Get your API key at ollama.com',
+    category: 'alternative',
+    requiresApiKey: true,
   },
 ];
 

src/commands/api-command.ts

@@ -181,9 +181,21 @@ async function handleCreate(args: string[]): Promise<void> {
     console.log(dim('Note: For OpenRouter, ANTHROPIC_API_KEY should be empty.'));
   }
 
-  // Step 3: API Key
+  // Step 3: API Key (skip if preset has requiresApiKey: false)
   let apiKey = parsedArgs.apiKey;
-  if (!apiKey) {
+
+  if (preset?.requiresApiKey === false) {
+    // Preset doesn't require API key (e.g., local Ollama)
+    if (parsedArgs.apiKey) {
+      console.log(dim('Note: Using provided API key for local Ollama (optional)'));
+      apiKey = parsedArgs.apiKey;
+    } else {
+      console.log(info('No API key required for local Ollama'));
+      // Sentinel value 'ollama' matches config/base-ollama.settings.json template
+      // This is not a valid API key, just a placeholder for local-only providers
+      apiKey = 'ollama';
+    }
+  } else if (!apiKey) {
     const keyPrompt = preset?.apiKeyHint ? `API Key (${preset.apiKeyHint})` : 'API Key';
     apiKey = await InteractivePrompt.password(keyPrompt);
     if (!apiKey) {
@@ -426,7 +438,7 @@ async function showHelp(): Promise<void> {
   console.log('');
   console.log(subheader('Options'));
   console.log(
-    `  ${color('--preset <id>', 'command')}        Use provider preset (openrouter, glm, glmt, kimi, foundry, mm, deepseek, qwen)`
+    `  ${color('--preset <id>', 'command')}        Use provider preset (openrouter, ollama, ollama-cloud, glm, glmt, kimi, foundry, mm, deepseek, qwen)`
   );
   console.log(`  ${color('--base-url <url>', 'command')}     API base URL (create)`);
   console.log(`  ${color('--api-key <key>', 'command')}      API key (create)`);
@@ -438,6 +450,12 @@ async function showHelp(): Promise<void> {
   console.log(
     `  ${color('openrouter', 'command')}    OpenRouter - 349+ models (Claude, GPT, Gemini, Llama)`
   );
+  console.log(
+    `  ${color('ollama', 'command')}          Ollama - Local open-source models (no API key)`
+  );
+  console.log(
+    `  ${color('ollama-cloud', 'command')}   Ollama Cloud - glm-4.7:cloud, qwen3-coder:480b`
+  );
   console.log(`  ${color('glm', 'command')}           GLM - Claude via Z.AI`);
   console.log(`  ${color('glmt', 'command')}          GLMT - GLM with Thinking mode`);
   console.log(`  ${color('kimi', 'command')}          Kimi - Moonshot AI reasoning model`);

src/commands/help-command.ts

@@ -127,6 +127,8 @@ Run ${color('ccs config', 'command')} for web dashboard`.trim();
       ['ccs glm', 'GLM 4.6 (API key required)'],
       ['ccs glmt', 'GLM with thinking mode'],
       ['ccs kimi', 'Kimi for Coding (API key)'],
+      ['ccs ollama', 'Local Ollama (http://localhost:11434)'],
+      ['ccs ollama-cloud', 'Ollama Cloud (API key required)'],
       ['', ''], // Spacer
       ['ccs api create', 'Create custom API profile'],
       ['ccs api remove', 'Remove an API profile'],

ui/public/icons/ollama.svg

@@ -0,0 +1 @@
+<svg fill="currentColor" fill-rule="evenodd" height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>Ollama</title><path d="M7.905 1.09c.216.085.411.225.588.41.295.306.544.744.734 1.263.191.522.315 1.1.362 1.68a5.054 5.054 0 012.049-.636l.051-.004c.87-.07 1.73.087 2.48.474.101.053.2.11.297.17.05-.569.172-1.134.36-1.644.19-.52.439-.957.733-1.264a1.67 1.67 0 01.589-.41c.257-.1.53-.118.796-.042.401.114.745.368 1.016.737.248.337.434.769.561 1.287.23.934.27 2.163.115 3.645l.053.04.026.019c.757.576 1.284 1.397 1.563 2.35.435 1.487.216 3.155-.534 4.088l-.018.021.002.003c.417.762.67 1.567.724 2.4l.002.03c.064 1.065-.2 2.137-.814 3.19l-.007.01.01.024c.472 1.157.62 2.322.438 3.486l-.006.039a.651.651 0 01-.747.536.648.648 0 01-.54-.742c.167-1.033.01-2.069-.48-3.123a.643.643 0 01.04-.617l.004-.006c.604-.924.854-1.83.8-2.72-.046-.779-.325-1.544-.8-2.273a.644.644 0 01.18-.886l.009-.006c.243-.159.467-.565.58-1.12a4.229 4.229 0 00-.095-1.974c-.205-.7-.58-1.284-1.105-1.683-.595-.454-1.383-.673-2.38-.61a.653.653 0 01-.632-.371c-.314-.665-.772-1.141-1.343-1.436a3.288 3.288 0 00-1.772-.332c-1.245.099-2.343.801-2.67 1.686a.652.652 0 01-.61.425c-1.067.002-1.893.252-2.497.703-.522.39-.878.935-1.066 1.588a4.07 4.07 0 00-.068 1.886c.112.558.331 1.02.582 1.269l.008.007c.212.207.257.53.109.785-.36.622-.629 1.549-.673 2.44-.05 1.018.186 1.902.719 2.536l.016.019a.643.643 0 01.095.69c-.576 1.236-.753 2.252-.562 3.052a.652.652 0 01-1.269.298c-.243-1.018-.078-2.184.473-3.498l.014-.035-.008-.012a4.339 4.339 0 01-.598-1.309l-.005-.019a5.764 5.764 0 01-.177-1.785c.044-.91.278-1.842.622-2.59l.012-.026-.002-.002c-.293-.418-.51-.953-.63-1.545l-.005-.024a5.352 5.352 0 01.093-2.49c.262-.915.777-1.701 1.536-2.269.06-.045.123-.09.186-.132-.159-1.493-.119-2.73.112-3.67.127-.518.314-.95.562-1.287.27-.368.614-.622 1.015-.737.266-.076.54-.059.797.042zm4.116 9.09c.936 0 1.8.313 2.446.855.63.527 1.005 1.235 1.005 1.94 0 .888-.406 1.58-1.133 2.022-.62.375-1.451.557-2.403.557-1.009 0-1.871-.259-2.493-.734-.617-.47-.963-1.13-.963-1.845 0-.707.398-1.417 1.056-1.946.668-.537 1.55-.849 2.485-.849zm0 .896a3.07 3.07 0 00-1.916.65c-.461.37-.722.835-.722 1.25 0 .428.21.829.61 1.134.455.347 1.124.548 1.943.548.799 0 1.473-.147 1.932-.426.463-.28.7-.686.7-1.257 0-.423-.246-.89-.683-1.256-.484-.405-1.14-.643-1.864-.643zm.662 1.21l.004.004c.12.151.095.37-.056.49l-.292.23v.446a.375.375 0 01-.376.373.375.375 0 01-.376-.373v-.46l-.271-.218a.347.347 0 01-.052-.49.353.353 0 01.494-.051l.215.172.22-.174a.353.353 0 01.49.051zm-5.04-1.919c.478 0 .867.39.867.871a.87.87 0 01-.868.871.87.87 0 01-.867-.87.87.87 0 01.867-.872zm8.706 0c.48 0 .868.39.868.871a.87.87 0 01-.868.871.87.87 0 01-.867-.87.87.87 0 01.867-.872zM7.44 2.3l-.003.002a.659.659 0 00-.285.238l-.005.006c-.138.189-.258.467-.348.832-.17.692-.216 1.631-.124 2.782.43-.128.899-.208 1.404-.237l.01-.001.019-.034c.046-.082.095-.161.148-.239.123-.771.022-1.692-.253-2.444-.134-.364-.297-.65-.453-.813a.628.628 0 00-.107-.09L7.44 2.3zm9.174.04l-.002.001a.628.628 0 00-.107.09c-.156.163-.32.45-.453.814-.29.794-.387 1.776-.23 2.572l.058.097.008.014h.03a5.184 5.184 0 011.466.212c.086-1.124.038-2.043-.128-2.722-.09-.365-.21-.643-.349-.832l-.004-.006a.659.659 0 00-.285-.239h-.004z"></path></svg>

ui/src/components/profiles/profile-create-dialog.tsx

@@ -47,7 +47,7 @@ const schema = z.object({
     .min(1, 'Name is required')
     .regex(/^[a-zA-Z][a-zA-Z0-9._-]*$/, 'Must start with letter, only letters/numbers/.-_'),
   baseUrl: z.string().url('Invalid URL format'),
-  apiKey: z.string().min(1, 'API key is required'),
+  apiKey: z.string(), // Validation handled conditionally in onSubmit
   model: z.string().optional(),
   opusModel: z.string().optional(),
   sonnetModel: z.string().optional(),
@@ -207,9 +207,16 @@ export function ProfileCreateDialog({
   }, [baseUrlValue, selectedPreset]);
 
   const onSubmit = async (data: FormData) => {
+    // Validate API key - required unless preset has requiresApiKey: false
+    if (currentPreset?.requiresApiKey !== false && !data.apiKey) {
+      toast.error('API key is required');
+      return;
+    }
     // Use user-provided baseUrl (allows customization of preset URLs)
     const finalData = {
       ...data,
+      // Use provided API key, or empty string if not provided (for optional auth providers)
+      apiKey: data.apiKey || '',
     };
     try {
       await createMutation.mutateAsync(finalData);
@@ -367,17 +374,27 @@ export function ProfileCreateDialog({
                   )}
                 </div>
 
-                {/* API Key */}
+                {/* API Key - optional for presets that don't require it */}
                 <div className="space-y-1.5">
                   <Label htmlFor="apiKey">
-                    API Key <span className="text-destructive">*</span>
+                    API Key{' '}
+                    {currentPreset?.requiresApiKey !== false && (
+                      <span className="text-destructive">*</span>
+                    )}
+                    {currentPreset?.requiresApiKey === false && (
+                      <span className="text-muted-foreground text-xs font-normal">(optional)</span>
+                    )}
                   </Label>
                   <div className="relative">
                     <Input
                       id="apiKey"
                       type={showApiKey ? 'text' : 'password'}
                       {...register('apiKey')}
-                      placeholder={currentPreset?.apiKeyPlaceholder ?? 'sk-...'}
+                      placeholder={
+                        currentPreset?.requiresApiKey === false
+                          ? 'Optional - only if auth is enabled'
+                          : (currentPreset?.apiKeyPlaceholder ?? 'sk-...')
+                      }
                       className="pr-10"
                     />
                     <Button
@@ -393,6 +410,10 @@ export function ProfileCreateDialog({
                   </div>
                   {errors.apiKey ? (
                     <p className="text-xs text-destructive">{errors.apiKey.message}</p>
+                  ) : currentPreset?.requiresApiKey === false ? (
+                    <p className="text-xs text-muted-foreground">
+                      Only needed if you have configured Ollama authentication
+                    </p>
                   ) : (
                     currentPreset?.apiKeyHint && (
                       <p className="text-xs text-muted-foreground">{currentPreset.apiKeyHint}</p>

ui/src/lib/provider-presets.ts

@@ -44,6 +44,22 @@ export const PROVIDER_PRESETS: ProviderPreset[] = [
     apiKeyHint: 'Get your API key at openrouter.ai/keys',
     category: 'recommended',
   },
+  // Recommended - Ollama (Local)
+  {
+    id: 'ollama',
+    name: 'Ollama (Local)',
+    description: 'Local open-source models via Ollama (32K+ context)',
+    baseUrl: 'http://localhost:11434',
+    defaultProfileName: 'ollama',
+    badge: 'Local',
+    featured: true,
+    icon: '/icons/ollama.svg',
+    defaultModel: 'qwen3-coder',
+    requiresApiKey: false,
+    apiKeyPlaceholder: '',
+    apiKeyHint: 'No API key required for local Ollama',
+    category: 'recommended',
+  },
   // Alternative providers - GLM/GLMT/Kimi
   {
     id: 'glm',
@@ -136,6 +152,20 @@ export const PROVIDER_PRESETS: ProviderPreset[] = [
     apiKeyHint: 'Get your API key from Alibaba Cloud Model Studio',
     category: 'alternative',
   },
+  {
+    id: 'ollama-cloud',
+    name: 'Ollama Cloud',
+    description: 'Ollama cloud models via direct API (glm-4.7:cloud, minimax-m2.1:cloud)',
+    baseUrl: 'https://ollama.com',
+    defaultProfileName: 'ollama-cloud',
+    badge: 'Cloud',
+    icon: '/icons/ollama.svg',
+    defaultModel: 'glm-4.7:cloud',
+    requiresApiKey: true,
+    apiKeyPlaceholder: 'YOUR_OLLAMA_CLOUD_API_KEY',
+    apiKeyHint: 'Get your API key at ollama.com',
+    category: 'alternative',
+  },
 ];
 
 /** Get presets by category */