free-coding-models 0.1.49 → 0.1.51

package/bin/free-coding-models.js

@@ -810,88 +810,87 @@ function checkNvidiaNimConfig() {
 }
 
 // ─── Start OpenCode ────────────────────────────────────────────────────────────
-// 📖 Launches OpenCode with the selected NVIDIA NIM model
-// 📖 If NVIDIA NIM is configured, use --model flag, otherwise show install prompt
-// 📖 Model format: { modelId, label, tier }
+// 📖 Launches OpenCode with the selected model.
+// 📖 Handles all 3 providers: nvidia (needs custom provider config), groq & cerebras (built-in in OpenCode).
+// 📖 For nvidia: checks if NIM is configured, sets provider.models entry, spawns with nvidia/model-id.
+// 📖 For groq/cerebras: OpenCode has built-in support — just sets model in config and spawns.
+// 📖 Model format: { modelId, label, tier, providerKey }
 async function startOpenCode(model) {
-  const hasNim = checkNvidiaNimConfig()
+  const providerKey = model.providerKey ?? 'nvidia'
+  // 📖 Full model reference string used in OpenCode config and --model flag
+  const modelRef = `${providerKey}/${model.modelId}`
 
-  if (hasNim) {
-    // 📖 NVIDIA NIM already configured - launch with model flag
-    console.log(chalk.green(`  🚀 Setting ${chalk.bold(model.label)} as default…`))
-    console.log(chalk.dim(`  Model: nvidia/${model.modelId}`))
-    console.log()
+  if (providerKey === 'nvidia') {
+    // 📖 NVIDIA NIM needs a custom provider block in OpenCode config (not built-in)
+    const hasNim = checkNvidiaNimConfig()
 
-    const config = loadOpenCodeConfig()
-    const backupPath = `${getOpenCodeConfigPath()}.backup-${Date.now()}`
+    if (hasNim) {
+      console.log(chalk.green(`  🚀 Setting ${chalk.bold(model.label)} as default…`))
+      console.log(chalk.dim(`  Model: ${modelRef}`))
+      console.log()
 
-    // 📖 Backup current config
-    if (existsSync(getOpenCodeConfigPath())) {
-      copyFileSync(getOpenCodeConfigPath(), backupPath)
-      console.log(chalk.dim(`  💾 Backup: ${backupPath}`))
-    }
+      const config = loadOpenCodeConfig()
+      const backupPath = `${getOpenCodeConfigPath()}.backup-${Date.now()}`
 
-    // 📖 Update default model to nvidia/model_id
-    config.model = `nvidia/${model.modelId}`
+      if (existsSync(getOpenCodeConfigPath())) {
+        copyFileSync(getOpenCodeConfigPath(), backupPath)
+        console.log(chalk.dim(`  💾 Backup: ${backupPath}`))
+      }
+
+      config.model = modelRef
 
-    // 📖 Register the model in the nvidia provider's models section
-    // 📖 OpenCode requires models to be explicitly listed in provider.models
-    // 📖 to recognize them — without this, it falls back to the previous default
-    if (config.provider?.nvidia) {
-      if (!config.provider.nvidia.models) config.provider.nvidia.models = {}
-      config.provider.nvidia.models[model.modelId] = {
-        name: model.label,
+      // 📖 Register the model in the nvidia provider's models section
+      // 📖 OpenCode requires models to be explicitly listed in provider.models
+      // 📖 to recognize them — without this, it falls back to the previous default
+      if (config.provider?.nvidia) {
+        if (!config.provider.nvidia.models) config.provider.nvidia.models = {}
+        config.provider.nvidia.models[model.modelId] = { name: model.label }
       }
-    }
 
-    saveOpenCodeConfig(config)
+      saveOpenCodeConfig(config)
 
-    // 📖 Verify config was saved correctly
-    const savedConfig = loadOpenCodeConfig()
-    console.log(chalk.dim(`  📝 Config saved to: ${getOpenCodeConfigPath()}`))
-    console.log(chalk.dim(`  📝 Default model in config: ${savedConfig.model || 'NOT SET'}`))
-    console.log()
-    
-    if (savedConfig.model === config.model) {
-      console.log(chalk.green(`  ✓ Default model set to: nvidia/${model.modelId}`))
-    } else {
-      console.log(chalk.yellow(`  ⚠ Config might not have been saved correctly`))
-    }
-    console.log()
-    console.log(chalk.dim('  Starting OpenCode…'))
-    console.log()
+      const savedConfig = loadOpenCodeConfig()
+      console.log(chalk.dim(`  📝 Config saved to: ${getOpenCodeConfigPath()}`))
+      console.log(chalk.dim(`  📝 Default model in config: ${savedConfig.model || 'NOT SET'}`))
+      console.log()
 
-    // 📖 Launch OpenCode and wait for it
-    // 📖 Use --model flag to ensure the model is selected
-    const { spawn } = await import('child_process')
-    const child = spawn('opencode', ['--model', `nvidia/${model.modelId}`], {
-      stdio: 'inherit',
-      shell: true,
-      detached: false
-    })
+      if (savedConfig.model === config.model) {
+        console.log(chalk.green(`  ✓ Default model set to: ${modelRef}`))
+      } else {
+        console.log(chalk.yellow(`  ⚠ Config might not have been saved correctly`))
+      }
+      console.log()
+      console.log(chalk.dim('  Starting OpenCode…'))
+      console.log()
 
-    // 📖 Wait for OpenCode to exit
-    await new Promise((resolve, reject) => {
-      child.on('exit', resolve)
-      child.on('error', (err) => {
-        if (err.code === 'ENOENT') {
-          console.error(chalk.red('\n  ✗ Could not find "opencode" — is it installed and in your PATH?'))
-          console.error(chalk.dim('    Install: npm i -g opencode   or see https://opencode.ai'))
-          resolve(1)
-        } else {
-          reject(err)
-        }
+      const { spawn } = await import('child_process')
+      const child = spawn('opencode', ['--model', modelRef], {
+        stdio: 'inherit',
+        shell: true,
+        detached: false
       })
-    })
-  } else {
-    // 📖 NVIDIA NIM not configured - show install prompt and launch
-    console.log(chalk.yellow('  ⚠ NVIDIA NIM not configured in OpenCode'))
-    console.log()
-    console.log(chalk.dim('  Starting OpenCode with installation prompt…'))
-    console.log()
 
-    const configPath = getOpenCodeConfigPath()
-    const installPrompt = `Please install NVIDIA NIM provider in OpenCode by adding this to ${configPath}:
+      await new Promise((resolve, reject) => {
+        child.on('exit', resolve)
+        child.on('error', (err) => {
+          if (err.code === 'ENOENT') {
+            console.error(chalk.red('\n  ✗ Could not find "opencode" — is it installed and in your PATH?'))
+            console.error(chalk.dim('    Install: npm i -g opencode   or see https://opencode.ai'))
+            resolve(1)
+          } else {
+            reject(err)
+          }
+        })
+      })
+    } else {
+      // 📖 NVIDIA NIM not configured — show install prompt
+      console.log(chalk.yellow('  ⚠ NVIDIA NIM not configured in OpenCode'))
+      console.log()
+      console.log(chalk.dim('  Starting OpenCode with installation prompt…'))
+      console.log()
+
+      const configPath = getOpenCodeConfigPath()
+      const installPrompt = `Please install NVIDIA NIM provider in OpenCode by adding this to ${configPath}:
 
 {
   "provider": {
@@ -908,21 +907,101 @@ async function startOpenCode(model) {
 
 ${isWindows ? 'set NVIDIA_API_KEY=your_key_here' : 'export NVIDIA_API_KEY=your_key_here'}
 
-After installation, you can use: opencode --model nvidia/${model.modelId}`
+After installation, you can use: opencode --model ${modelRef}`
+
+      console.log(chalk.cyan(installPrompt))
+      console.log()
+      console.log(chalk.dim('  Starting OpenCode…'))
+      console.log()
+
+      const { spawn } = await import('child_process')
+      const child = spawn('opencode', [], {
+        stdio: 'inherit',
+        shell: true,
+        detached: false
+      })
+
+      await new Promise((resolve, reject) => {
+        child.on('exit', resolve)
+        child.on('error', (err) => {
+          if (err.code === 'ENOENT') {
+            console.error(chalk.red('\n  ✗ Could not find "opencode" — is it installed and in your PATH?'))
+            console.error(chalk.dim('    Install: npm i -g opencode   or see https://opencode.ai'))
+            resolve(1)
+          } else {
+            reject(err)
+          }
+        })
+      })
+    }
+  } else {
+    // 📖 Groq: built-in OpenCode provider — needs provider block with apiKey in opencode.json.
+    // 📖 Cerebras: NOT built-in — needs @ai-sdk/openai-compatible + baseURL, like NVIDIA.
+    // 📖 Both need the model registered in provider.<key>.models so OpenCode can find it.
+    console.log(chalk.green(`  🚀 Setting ${chalk.bold(model.label)} as default…`))
+    console.log(chalk.dim(`  Model: ${modelRef}`))
+    console.log()
+
+    const config = loadOpenCodeConfig()
+    const backupPath = `${getOpenCodeConfigPath()}.backup-${Date.now()}`
+
+    if (existsSync(getOpenCodeConfigPath())) {
+      copyFileSync(getOpenCodeConfigPath(), backupPath)
+      console.log(chalk.dim(`  💾 Backup: ${backupPath}`))
+    }
+
+    // 📖 Ensure the provider block exists in config — create it if missing
+    if (!config.provider) config.provider = {}
+    if (!config.provider[providerKey]) {
+      if (providerKey === 'groq') {
+        // 📖 Groq is a built-in OpenCode provider — just needs apiKey options, no npm package
+        config.provider.groq = {
+          options: { apiKey: '{env:GROQ_API_KEY}' },
+          models: {}
+        }
+      } else if (providerKey === 'cerebras') {
+        // 📖 Cerebras is OpenAI-compatible — needs npm package and baseURL like NVIDIA
+        config.provider.cerebras = {
+          npm: '@ai-sdk/openai-compatible',
+          name: 'Cerebras',
+          options: {
+            baseURL: 'https://api.cerebras.ai/v1',
+            apiKey: '{env:CEREBRAS_API_KEY}'
+          },
+          models: {}
+        }
+      }
+    }
 
-    console.log(chalk.cyan(installPrompt))
+    // 📖 Register the model in the provider's models section
+    // 📖 OpenCode requires models to be explicitly listed to recognize them
+    if (!config.provider[providerKey].models) config.provider[providerKey].models = {}
+    config.provider[providerKey].models[model.modelId] = { name: model.label }
+
+    config.model = modelRef
+    saveOpenCodeConfig(config)
+
+    const savedConfig = loadOpenCodeConfig()
+    console.log(chalk.dim(`  📝 Config saved to: ${getOpenCodeConfigPath()}`))
+    console.log(chalk.dim(`  📝 Default model in config: ${savedConfig.model || 'NOT SET'}`))
+    console.log()
+
+    if (savedConfig.model === config.model) {
+      console.log(chalk.green(`  ✓ Default model set to: ${modelRef}`))
+    } else {
+      console.log(chalk.yellow(`  ⚠ Config might not have been saved correctly`))
+    }
     console.log()
     console.log(chalk.dim('  Starting OpenCode…'))
     console.log()
 
     const { spawn } = await import('child_process')
-    const child = spawn('opencode', [], {
+    const child = spawn('opencode', ['--model', modelRef], {
       stdio: 'inherit',
       shell: true,
       detached: false
     })
 
-    // 📖 Wait for OpenCode to exit
     await new Promise((resolve, reject) => {
       child.on('exit', resolve)
       child.on('error', (err) => {
@@ -941,67 +1020,25 @@ After installation, you can use: opencode --model nvidia/${model.modelId}`
 // ─── Start OpenCode Desktop ─────────────────────────────────────────────────────
 // 📖 startOpenCodeDesktop: Same config logic as startOpenCode, but opens the Desktop app.
 // 📖 OpenCode Desktop shares config at the same location as CLI.
+// 📖 Handles all 3 providers: nvidia (needs custom provider config), groq & cerebras (built-in).
 // 📖 No need to wait for exit — Desktop app stays open independently.
 async function startOpenCodeDesktop(model) {
-  const hasNim = checkNvidiaNimConfig()
-
-  if (hasNim) {
-    console.log(chalk.green(`  🖥 Setting ${chalk.bold(model.label)} as default for OpenCode Desktop…`))
-    console.log(chalk.dim(`  Model: nvidia/${model.modelId}`))
-    console.log()
-
-    const config = loadOpenCodeConfig()
-    const backupPath = `${getOpenCodeConfigPath()}.backup-${Date.now()}`
-
-    if (existsSync(getOpenCodeConfigPath())) {
-      copyFileSync(getOpenCodeConfigPath(), backupPath)
-      console.log(chalk.dim(`  💾 Backup: ${backupPath}`))
-    }
-
-    config.model = `nvidia/${model.modelId}`
-
-    if (config.provider?.nvidia) {
-      if (!config.provider.nvidia.models) config.provider.nvidia.models = {}
-      config.provider.nvidia.models[model.modelId] = {
-        name: model.label,
-      }
-    }
-
-    saveOpenCodeConfig(config)
-
-    // 📖 Verify config was saved correctly
-    const savedConfig = loadOpenCodeConfig()
-    console.log(chalk.dim(`  📝 Config saved to: ${getOpenCodeConfigPath()}`))
-    console.log(chalk.dim(`  📝 Default model in config: ${savedConfig.model || 'NOT SET'}`))
-    console.log()
-    
-    if (savedConfig.model === config.model) {
-      console.log(chalk.green(`  ✓ Default model set to: nvidia/${model.modelId}`))
-    } else {
-      console.log(chalk.yellow(`  ⚠ Config might not have been saved correctly`))
-    }
-    console.log()
-    console.log(chalk.dim('  Opening OpenCode Desktop…'))
-    console.log()
+  const providerKey = model.providerKey ?? 'nvidia'
+  // 📖 Full model reference string used in OpenCode config and --model flag
+  const modelRef = `${providerKey}/${model.modelId}`
 
-    // 📖 Launch Desktop app based on platform
+  // 📖 Helper to open the Desktop app based on platform
+  const launchDesktop = async () => {
     const { exec } = await import('child_process')
-    
     let command
     if (isMac) {
       command = 'open -a OpenCode'
     } else if (isWindows) {
-      // 📖 On Windows, try common installation paths
-      // 📖 User installation: %LOCALAPPDATA%\Programs\OpenCode\OpenCode.exe
-      // 📖 System installation: C:\Program Files\OpenCode\OpenCode.exe
       command = 'start "" "%LOCALAPPDATA%\\Programs\\OpenCode\\OpenCode.exe" 2>nul || start "" "%PROGRAMFILES%\\OpenCode\\OpenCode.exe" 2>nul || start OpenCode'
     } else if (isLinux) {
-      // 📖 On Linux, try different methods with model flag
-      // 📖 Check if opencode-desktop exists, otherwise try xdg-open
-      command = `opencode-desktop --model nvidia/${model.modelId} 2>/dev/null || flatpak run ai.opencode.OpenCode --model nvidia/${model.modelId} 2>/dev/null || snap run opencode --model nvidia/${model.modelId} 2>/dev/null || xdg-open /usr/share/applications/opencode.desktop 2>/dev/null || echo "OpenCode not found"`
+      command = `opencode-desktop --model ${modelRef} 2>/dev/null || flatpak run ai.opencode.OpenCode --model ${modelRef} 2>/dev/null || snap run opencode --model ${modelRef} 2>/dev/null || xdg-open /usr/share/applications/opencode.desktop 2>/dev/null || echo "OpenCode not found"`
     }
-
-    exec(command, (err, stdout, stderr) => {
+    exec(command, (err) => {
       if (err) {
         console.error(chalk.red('  ✗ Could not open OpenCode Desktop'))
         if (isWindows) {
@@ -1014,13 +1051,56 @@ async function startOpenCodeDesktop(model) {
         }
       }
     })
-  } else {
-    console.log(chalk.yellow('  ⚠ NVIDIA NIM not configured in OpenCode'))
-    console.log(chalk.dim('  Please configure it first. Config is shared between CLI and Desktop.'))
-    console.log()
-    
-    const configPath = getOpenCodeConfigPath()
-    const installPrompt = `Add this to ${configPath}:
+  }
+
+  if (providerKey === 'nvidia') {
+    // 📖 NVIDIA NIM needs a custom provider block in OpenCode config (not built-in)
+    const hasNim = checkNvidiaNimConfig()
+
+    if (hasNim) {
+      console.log(chalk.green(`  🖥 Setting ${chalk.bold(model.label)} as default for OpenCode Desktop…`))
+      console.log(chalk.dim(`  Model: ${modelRef}`))
+      console.log()
+
+      const config = loadOpenCodeConfig()
+      const backupPath = `${getOpenCodeConfigPath()}.backup-${Date.now()}`
+
+      if (existsSync(getOpenCodeConfigPath())) {
+        copyFileSync(getOpenCodeConfigPath(), backupPath)
+        console.log(chalk.dim(`  💾 Backup: ${backupPath}`))
+      }
+
+      config.model = modelRef
+
+      if (config.provider?.nvidia) {
+        if (!config.provider.nvidia.models) config.provider.nvidia.models = {}
+        config.provider.nvidia.models[model.modelId] = { name: model.label }
+      }
+
+      saveOpenCodeConfig(config)
+
+      const savedConfig = loadOpenCodeConfig()
+      console.log(chalk.dim(`  📝 Config saved to: ${getOpenCodeConfigPath()}`))
+      console.log(chalk.dim(`  📝 Default model in config: ${savedConfig.model || 'NOT SET'}`))
+      console.log()
+
+      if (savedConfig.model === config.model) {
+        console.log(chalk.green(`  ✓ Default model set to: ${modelRef}`))
+      } else {
+        console.log(chalk.yellow(`  ⚠ Config might not have been saved correctly`))
+      }
+      console.log()
+      console.log(chalk.dim('  Opening OpenCode Desktop…'))
+      console.log()
+
+      await launchDesktop()
+    } else {
+      console.log(chalk.yellow('  ⚠ NVIDIA NIM not configured in OpenCode'))
+      console.log(chalk.dim('  Please configure it first. Config is shared between CLI and Desktop.'))
+      console.log()
+
+      const configPath = getOpenCodeConfigPath()
+      const installPrompt = `Add this to ${configPath}:
 
 {
   "provider": {
@@ -1036,8 +1116,68 @@ async function startOpenCodeDesktop(model) {
 }
 
 ${isWindows ? 'set NVIDIA_API_KEY=your_key_here' : 'export NVIDIA_API_KEY=your_key_here'}`
-    console.log(chalk.cyan(installPrompt))
+      console.log(chalk.cyan(installPrompt))
+      console.log()
+    }
+  } else {
+    // 📖 Groq: built-in OpenCode provider — needs provider block with apiKey in opencode.json.
+    // 📖 Cerebras: NOT built-in — needs @ai-sdk/openai-compatible + baseURL, like NVIDIA.
+    // 📖 Both need the model registered in provider.<key>.models so OpenCode can find it.
+    console.log(chalk.green(`  🖥 Setting ${chalk.bold(model.label)} as default for OpenCode Desktop…`))
+    console.log(chalk.dim(`  Model: ${modelRef}`))
+    console.log()
+
+    const config = loadOpenCodeConfig()
+    const backupPath = `${getOpenCodeConfigPath()}.backup-${Date.now()}`
+
+    if (existsSync(getOpenCodeConfigPath())) {
+      copyFileSync(getOpenCodeConfigPath(), backupPath)
+      console.log(chalk.dim(`  💾 Backup: ${backupPath}`))
+    }
+
+    // 📖 Ensure the provider block exists in config — create it if missing
+    if (!config.provider) config.provider = {}
+    if (!config.provider[providerKey]) {
+      if (providerKey === 'groq') {
+        config.provider.groq = {
+          options: { apiKey: '{env:GROQ_API_KEY}' },
+          models: {}
+        }
+      } else if (providerKey === 'cerebras') {
+        config.provider.cerebras = {
+          npm: '@ai-sdk/openai-compatible',
+          name: 'Cerebras',
+          options: {
+            baseURL: 'https://api.cerebras.ai/v1',
+            apiKey: '{env:CEREBRAS_API_KEY}'
+          },
+          models: {}
+        }
+      }
+    }
+
+    // 📖 Register the model in the provider's models section
+    if (!config.provider[providerKey].models) config.provider[providerKey].models = {}
+    config.provider[providerKey].models[model.modelId] = { name: model.label }
+
+    config.model = modelRef
+    saveOpenCodeConfig(config)
+
+    const savedConfig = loadOpenCodeConfig()
+    console.log(chalk.dim(`  📝 Config saved to: ${getOpenCodeConfigPath()}`))
+    console.log(chalk.dim(`  📝 Default model in config: ${savedConfig.model || 'NOT SET'}`))
     console.log()
+
+    if (savedConfig.model === config.model) {
+      console.log(chalk.green(`  ✓ Default model set to: ${modelRef}`))
+    } else {
+      console.log(chalk.yellow(`  ⚠ Config might not have been saved correctly`))
+    }
+    console.log()
+    console.log(chalk.dim('  Opening OpenCode Desktop…'))
+    console.log()
+
+    await launchDesktop()
   }
 }
 
@@ -1673,7 +1813,7 @@ async function main() {
       const sorted = sortResults(results, state.sortColumn, state.sortDirection)
       const selected = sorted[state.cursor]
       // 📖 Allow selecting ANY model (even timeout/down) - user knows what they're doing
-      userSelected = { modelId: selected.modelId, label: selected.label, tier: selected.tier }
+      userSelected = { modelId: selected.modelId, label: selected.label, tier: selected.tier, providerKey: selected.providerKey }
 
       // 📖 Stop everything and act on selection immediately
       clearInterval(ticker)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "free-coding-models",
-  "version": "0.1.49",
+  "version": "0.1.51",
   "description": "Find the fastest coding LLM models in seconds — ping free models from multiple providers, pick the best one for OpenCode, Cursor, or any AI coding assistant.",
   "keywords": [
     "nvidia",