free-coding-models 0.3.51 → 0.3.52

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [0.3.52] - 2026-04-18
+
+### Added
+
+- **OpenCode WebUI Support** — Added `--opencode-web` flag to open the OpenCode WebUI dashboard after configuring the selected model. This mirrors the existing `--opencode-desktop` behavior.
+
 ## [0.3.51] - 2026-04-11
 
 ### Changed

package/README.md

@@ -11,10 +11,12 @@
 </p>
 
 <h1 align="center">free-coding-models</h1>
+                                                    
+                                                                                                                                                                                        
 
 <p align="center">
   <strong>Find the fastest free coding model in seconds</strong><br>
-  <sub>Ping 238 models across 25 AI Free providers in real-time </sub><br>  <sub> Install Free API endpoints to your favorite AI coding tool: <br>📦 OpenCode, 🦞 OpenClaw, 💘 Crush, 🪿 Goose, 🛠 Aider, 🐉 Qwen Code, 🤲 OpenHands, ⚡ Amp, 🔮 Hermes, ▶️ Continue, 🧠 Cline, 🛠️ Xcode, π Pi, 🦘 Rovo or ♊ Gemini in one keystroke</sub>
+  <sub>Ping 238 models across 25 AI Free providers in real-time </sub><br>  <sub> Install Free API endpoints to your favorite AI coding tool: <br>📦 OpenCode, 📦 OpenCode Desktop, 📦 OpenCode WebUI, 🦞 OpenClaw, 💘 Crush, 🪿 Goose, 🛠 Aider, 🐉 Qwen Code, 🤲 OpenHands, ⚡ Amp, 🔮 Hermes, ▶️ Continue, 🧠 Cline, 🛠️ Xcode, π Pi, 🦘 Rovo or ♊ Gemini in one keystroke</sub>
 </p>
 
 
@@ -260,6 +262,7 @@ When launching the web dashboard, `free-coding-models` prefers `http://localhost
 |------|----------|
 | `--opencode` | 📦 OpenCode CLI |
 | `--opencode-desktop` | 📦 OpenCode Desktop |
+| `--opencode-web` | 📦 OpenCode WebUI |
 | `--openclaw` | 🦞 OpenClaw |
 | `--crush` | 💘 Crush |
 | `--goose` | 🪿 Goose |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "free-coding-models",
-  "version": "0.3.51",
+  "version": "0.3.52",
   "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",

package/src/app.js

@@ -105,7 +105,7 @@ import { usageForRow as _usageForRow } from '../src/usage-reader.js'
 import { buildProviderModelTokenKey, loadTokenUsageByProviderModel } from '../src/token-usage-reader.js'
 import { parseOpenRouterResponse, fetchProviderQuota as _fetchProviderQuotaFromModule } from '../src/provider-quota-fetchers.js'
 import { isKnownQuotaTelemetry } from '../src/quota-capabilities.js'
-import { ALT_ENTER, ALT_LEAVE, ALT_HOME, PING_TIMEOUT, PING_INTERVAL, FPS, COL_MODEL, COL_MS, CELL_W, FRAMES, TIER_CYCLE, SETTINGS_OVERLAY_BG, HELP_OVERLAY_BG, RECOMMEND_OVERLAY_BG, OVERLAY_PANEL_WIDTH, TABLE_HEADER_LINES, TABLE_FOOTER_LINES, TABLE_FIXED_LINES, WIDTH_WARNING_MIN_COLS, msCell, spinCell } from '../src/constants.js'
+import { ALT_ENTER, ALT_LEAVE, ALT_HOME, PING_TIMEOUT, PING_INTERVAL, FPS, COL_MODEL, COL_MS, CELL_W, FRAMES, TIER_CYCLE, VERDICT_CYCLE, HEALTH_CYCLE, SETTINGS_OVERLAY_BG, HELP_OVERLAY_BG, RECOMMEND_OVERLAY_BG, OVERLAY_PANEL_WIDTH, TABLE_HEADER_LINES, TABLE_FOOTER_LINES, TABLE_FIXED_LINES, WIDTH_WARNING_MIN_COLS, msCell, spinCell } from '../src/constants.js'
 import { TIER_COLOR } from '../src/tier-colors.js'
 import { resolveCloudflareUrl, buildPingRequest, ping, extractQuotaPercent, getProviderQuotaPercentCached, usagePlaceholderForProvider } from '../src/ping.js'
 import { runFiableMode, filterByTierOrExit, fetchOpenRouterFreeModels } from '../src/analysis.js'
@@ -117,7 +117,7 @@ import { promptApiKey } from '../src/setup.js'
 import { syncShellEnv, ensureShellRcSource, promptShellEnvMigration, removeShellEnv } from '../src/shell-env.js'
 import { stripAnsi, maskApiKey, displayWidth, padEndDisplay, tintOverlayLines, keepOverlayTargetVisible, sliceOverlayLines, calculateViewport, sortResultsWithPinnedFavorites, adjustScrollOffset } from '../src/render-helpers.js'
 import { renderTable, PROVIDER_COLOR } from '../src/render-table.js'
-import { setOpenCodeModelData, startOpenCode, startOpenCodeDesktop } from '../src/opencode.js'
+import { setOpenCodeModelData, startOpenCode, startOpenCodeDesktop, startOpenCodeWeb } from '../src/opencode.js'
 import { startOpenClaw } from '../src/openclaw.js'
 import { createOverlayRenderers } from '../src/overlays.js'
 import { createKeyHandler, createMouseEventHandler } from '../src/key-handler.js'
@@ -252,6 +252,7 @@ export async function runApp(cliArgs, config) {
     const flagByMode = {
       opencode: cliArgs.openCodeMode,
       'opencode-desktop': cliArgs.openCodeDesktopMode,
+      'opencode-web': cliArgs.openCodeWebMode,
       openclaw: cliArgs.openClawMode,
       aider: cliArgs.aiderMode,
       crush: cliArgs.crushMode,
@@ -423,6 +424,8 @@ export async function runApp(cliArgs, config) {
     mode,                         // 📖 'opencode' or 'openclaw' — controls Enter action
     tierFilterMode: 0,            // 📖 Index into TIER_CYCLE (0=All, 1=S+, 2=S, ...)
     originFilterMode: 0,          // 📖 Index into ORIGIN_CYCLE (0=All, then providers)
+    verdictFilterMode: 0,        // 📖 Index into VERDICT_CYCLE (0=All, then verdicts)
+    healthFilterMode: 0,          // 📖 Index into HEALTH_CYCLE (0=All, then health states)
     hideUnconfiguredModels: config.settings?.hideUnconfiguredModels === true, // 📖 Hide providers with no configured API key when true.
     favoritesPinnedAndSticky: config.settings?.favoritesPinnedAndSticky === true, // 📖 false by default: favorites follow normal sort/filter rules until Y enables pinned+sticky mode.
     footerHidden: config.settings?.footerHidden === true, // 📖 true = footer is collapsed to a single toggle hint
@@ -739,6 +742,8 @@ export async function runApp(cliArgs, config) {
   function applyTierFilter() {
     const activeTier = TIER_CYCLE[state.tierFilterMode]
     const activeOrigin = ORIGIN_CYCLE[state.originFilterMode]
+    const activeVerdict = VERDICT_CYCLE[state.verdictFilterMode]
+    const activeHealth = HEALTH_CYCLE[state.healthFilterMode]
     state.results.forEach(r => {
       // 📖 Sticky-favorites mode keeps favorites visible regardless of configured-only, tier, or provider filters.
       if (state.favoritesPinnedAndSticky && r.isFavorite) {
@@ -754,12 +759,16 @@ export async function runApp(cliArgs, config) {
         r.hidden = true
         return
       }
-      // 📖 Apply both tier and origin filters — model is hidden if it fails either
-      // 📖 TIER_LETTER_MAP is used so --tier S also includes S+ models (tier family behavior).
+      // 📖 Apply tier, origin, verdict, and health filters — model is hidden if it fails any
       const allowedTiers = (activeTier && TIER_LETTER_MAP[activeTier]) ? TIER_LETTER_MAP[activeTier] : [activeTier]
       const tierHide = activeTier !== null && !allowedTiers.includes(r.tier)
       const originHide = activeOrigin !== null && r.providerKey !== activeOrigin
-      if (tierHide || originHide) {
+      // 📖 Verdict filter: match against getVerdict(r) when active
+      const rVerdict = getVerdict(r)
+      const verdictHide = activeVerdict !== null && rVerdict !== activeVerdict
+      // 📖 Health filter: match against r.status when active
+      const healthHide = activeHealth !== null && r.status !== activeHealth
+      if (tierHide || originHide || verdictHide || healthHide) {
         r.hidden = true
         return
       }
@@ -864,6 +873,7 @@ export async function runApp(cliArgs, config) {
     runUpdate,
     startOpenClaw,
     startOpenCodeDesktop,
+    startOpenCodeWeb,
     startOpenCode,
     startExternalTool,
     getToolModeOrder,
@@ -1042,7 +1052,10 @@ export async function runApp(cliArgs, config) {
           state.versionAlertsEnabled,
           state.favoritesPinnedAndSticky,
           state.customTextFilter,
-          state.lastReleaseDate
+          state.lastReleaseDate,
+          state.footerHidden,
+          state.verdictFilterMode,
+          state.healthFilterMode
         )
       }
       tableContent = state.commandPaletteFrozenTable
@@ -1077,7 +1090,10 @@ export async function runApp(cliArgs, config) {
         state.versionAlertsEnabled,
         state.favoritesPinnedAndSticky,
         state.customTextFilter,
-        state.lastReleaseDate
+        state.lastReleaseDate,
+        state.footerHidden,
+        state.verdictFilterMode,
+        state.healthFilterMode
       )
     }
 
@@ -1121,7 +1137,7 @@ export async function runApp(cliArgs, config) {
     pinFavorites: state.favoritesPinnedAndSticky,
   })
 
-      process.stdout.write(ALT_HOME + renderTable(state.results, state.pendingPings, state.frame, state.cursor, state.sortColumn, state.sortDirection, state.pingInterval, state.lastPingTime, state.mode, state.tierFilterMode, state.scrollOffset, state.terminalRows, state.terminalCols, state.originFilterMode, null, state.pingMode, state.pingModeSource, state.hideUnconfiguredModels, state.widthWarningStartedAt, state.widthWarningDismissed, state.widthWarningShowCount, state.settingsUpdateState, state.settingsUpdateLatestVersion, false, state.startupLatestVersion, state.versionAlertsEnabled, state.favoritesPinnedAndSticky, state.customTextFilter, state.lastReleaseDate, state.footerHidden))
+      process.stdout.write(ALT_HOME + renderTable(state.results, state.pendingPings, state.frame, state.cursor, state.sortColumn, state.sortDirection, state.pingInterval, state.lastPingTime, state.mode, state.tierFilterMode, state.scrollOffset, state.terminalRows, state.terminalCols, state.originFilterMode, null, state.pingMode, state.pingModeSource, state.hideUnconfiguredModels, state.widthWarningStartedAt, state.widthWarningDismissed, state.widthWarningShowCount, state.settingsUpdateState, state.settingsUpdateLatestVersion, false, state.startupLatestVersion, state.versionAlertsEnabled, state.favoritesPinnedAndSticky, state.customTextFilter, state.lastReleaseDate, state.footerHidden, state.verdictFilterMode, state.healthFilterMode))
   if (process.stdout.isTTY) {
     process.stdout.flush && process.stdout.flush()
   }

package/src/command-palette.js

@@ -20,6 +20,7 @@ import { TOOL_METADATA, TOOL_MODE_ORDER } from './tool-metadata.js'
 const TOOL_MODE_DESCRIPTIONS = {
   opencode: 'Launch in OpenCode CLI with the selected model.',
   'opencode-desktop': 'Set model in shared config, then open OpenCode Desktop.',
+  'opencode-web': 'Set model in shared config, then open OpenCode WebUI.',
   openclaw: 'Set default model in OpenClaw and launch it.',
   crush: 'Launch Crush with this provider/model pair.',
   goose: 'Launch Goose and preselect the active model.',

package/src/constants.js

@@ -77,6 +77,14 @@ export const FRAMES = ['⠋','⠙','⠹','⠸','⠼','⠴','⠦','⠧','⠇','
 // 📖 Index 0 = no filter (show all), then each tier name in descending quality order.
 export const TIER_CYCLE = [null, 'S+', 'S', 'A+', 'A', 'A-', 'B+', 'B', 'C']
 
+// 📖 VERDICT_CYCLE: cycles through health verdict labels (0=All, then each verdict).
+// 📖 Based on VERDICT_ORDER from utils.js — includes all possible getVerdict() values.
+export const VERDICT_CYCLE = [null, 'Perfect', 'Normal', 'Slow', 'Spiky', 'Very Slow', 'Overloaded', 'Unstable', 'Not Active', 'Pending']
+
+// 📖 HEALTH_CYCLE: cycles through ping status states (0=All, then each status).
+// 📖 Based on the status values in the app: up, timeout, down, auth_error, noauth, pending.
+export const HEALTH_CYCLE = [null, 'up', 'timeout', 'down', 'auth_error', 'noauth', 'pending']
+
 // 📖 Overlay background chalk functions — each overlay panel has a distinct tint
 // 📖 so users can tell Settings, Help, Recommend, and Log panels apart at a glance.
 export const SETTINGS_OVERLAY_BG  = chalk.bgRgb(0, 0, 0)
@@ -93,8 +101,8 @@ export const WIDTH_WARNING_MIN_COLS = 80
 
 // 📖 Table row-budget constants — must stay in sync with renderTable()'s actual output.
 // 📖 If this drifts, model rows overflow and can push the title row out of view.
-export const TABLE_HEADER_LINES = 4  // 📖 title, spacer, column headers, separator
-export const TABLE_FOOTER_LINES = 5  // 📖 spacer, hints line 1, hints line 2, spacer, credit+links
+export const TABLE_HEADER_LINES = 5  // 📖 title, filter bar, spacer, column headers, separator
+export const TABLE_FOOTER_LINES = 1  // 📖 single toggle-hint line when collapsed, full footer otherwise
 export const TABLE_FIXED_LINES  = TABLE_HEADER_LINES + TABLE_FOOTER_LINES
 
 // ─── Small cell-formatting helpers ────────────────────────────────────────────

package/src/key-handler.js

@@ -39,7 +39,7 @@ import { getLastLayout, COLUMN_SORT_MAP } from './render-table.js'
 import { cycleThemeSetting, detectActiveTheme } from './theme.js'
 import { syncShellEnv, ensureShellRcSource, removeShellEnv } from './shell-env.js'
 import { buildCommandPaletteTree, flattenCommandTree, filterCommandPaletteEntries } from './command-palette.js'
-import { WIDTH_WARNING_MIN_COLS } from './constants.js'
+import { WIDTH_WARNING_MIN_COLS, VERDICT_CYCLE, HEALTH_CYCLE } from './constants.js'
 import { scanAllToolConfigs, softDeleteModel } from './installed-models-manager.js'
 import { startExternalTool } from './tool-launchers.js'
 
@@ -264,6 +264,7 @@ export function createKeyHandler(ctx) {
     runUpdate,
     startOpenClaw,
     startOpenCodeDesktop,
+    startOpenCodeWeb,
     startOpenCode,
     startExternalTool,
     getToolModeOrder,
@@ -495,6 +496,8 @@ export function createKeyHandler(ctx) {
       exitCode = await startOpenClaw(userSelected, state.config, { launchCli: true })
     } else if (state.mode === 'opencode-desktop') {
       exitCode = await startOpenCodeDesktop(userSelected, state.config)
+    } else if (state.mode === 'opencode-web') {
+      exitCode = await startOpenCodeWeb(userSelected, state.config)
     } else if (state.mode === 'opencode') {
       exitCode = await startOpenCode(userSelected, state.config)
     } else {
@@ -2414,6 +2417,7 @@ export function createKeyHandler(ctx) {
       if (!state.config.settings || typeof state.config.settings !== 'object') state.config.settings = {}
       state.config.settings.footerHidden = state.footerHidden
       saveConfig(state.config)
+      state.frame++ // 📖 Force immediate re-render
       return
     }
 
@@ -2449,6 +2453,24 @@ export function createKeyHandler(ctx) {
       return
     }
 
+    // 📖 Verdict filter key: V = cycle through each verdict (All → Perfect → Normal → Slow → ... → All)
+    if (key.name === 'v') {
+      state.verdictFilterMode = (state.verdictFilterMode + 1) % VERDICT_CYCLE.length
+      applyTierFilter()
+      refreshVisibleSorted({ resetCursor: true })
+      persistUiSettings()
+      return
+    }
+
+    // 📖 Health filter key: H = cycle through each health status (All → Up → Timeout → Down → ... → All)
+    if (key.name === 'h') {
+      state.healthFilterMode = (state.healthFilterMode + 1) % HEALTH_CYCLE.length
+      applyTierFilter()
+      refreshVisibleSorted({ resetCursor: true })
+      persistUiSettings()
+      return
+    }
+
     // 📖 Help overlay key: Ctrl+H = toggle help overlay
     if (key.ctrl && key.name === 'h') {
       state.helpVisible = !state.helpVisible

package/src/opencode.js

@@ -543,6 +543,80 @@ export async function startOpenCode(model, fcmConfig) {
   await spawnOpenCode(['--model', modelRef], providerKey, fcmConfig)
 }
 
+// ─── Start OpenCode Web ───────────────────────────────────────────────────────
+
+export async function startOpenCodeWeb(model, fcmConfig) {
+  const providerKey = model.providerKey ?? 'nvidia'
+  const ocModelId = getOpenCodeModelId(providerKey, model.modelId)
+  const modelRef = `${providerKey}/${ocModelId}`
+
+  const launchWeb = async () => {
+    const { exec } = await import('child_process')
+    const url = 'https://opencode.ai'
+    let command
+    if (isMac) {
+      command = `open "${url}"`
+    } else if (isWindows) {
+      command = `start "${url}"`
+    } else {
+      command = `xdg-open "${url}"`
+    }
+    exec(command, (err) => {
+      if (err) {
+        console.error(chalk.red('  Could not open OpenCode WebUI'))
+        console.error(chalk.dim(`    Please visit ${url} manually`))
+      }
+    })
+  }
+
+  // 📖 Mirror OpenCode Desktop behavior: set the model in opencode.json
+  const config = loadOpenCodeConfig()
+  const backupPath = `${getOpenCodeConfigPath()}.backup-${Date.now()}`
+
+  if (existsSync(getOpenCodeConfigPath())) {
+    copyFileSync(getOpenCodeConfigPath(), backupPath)
+    console.log(chalk.dim(`  Backup: ${backupPath}`))
+  }
+
+  if (!config.provider) config.provider = {}
+  
+  // 📖 Provider-specific config setup (same as CLI/Desktop)
+  if (providerKey === 'nvidia' && !config.provider.nvidia) {
+    config.provider.nvidia = {
+      npm: '@ai-sdk/openai-compatible',
+      name: 'NVIDIA NIM',
+      options: { baseURL: 'https://integrate.api.nvidia.com/v1', apiKey: '{env:NVIDIA_API_KEY}' },
+      models: {}
+    }
+  } else if (providerKey === 'groq' && !config.provider.groq) {
+    config.provider.groq = { options: { apiKey: '{env:GROQ_API_KEY}' }, models: {} }
+  } else if (providerKey === 'cerebras' && !config.provider.cerebras) {
+    config.provider.cerebras = {
+      npm: '@ai-sdk/openai-compatible',
+      name: 'Cerebras',
+      options: { baseURL: 'https://api.cerebras.ai/v1', apiKey: '{env:CEREBRAS_API_KEY}' },
+      models: {}
+    }
+  }
+  // ... other providers are handled as they are selected
+
+  console.log(chalk.green(`  Setting ${chalk.bold(model.label)} as default (mirroring Desktop)...`))
+  
+  if (providerKey !== 'opencode-zen' && config.provider[providerKey]) {
+    if (!config.provider[providerKey].models) config.provider[providerKey].models = {}
+    config.provider[providerKey].models[ocModelId] = { name: model.label }
+  }
+
+  config.model = providerKey === 'opencode-zen' ? `opencode/${ocModelId}` : modelRef
+  saveOpenCodeConfig(config)
+
+  console.log(chalk.dim(`  Config saved to: ${getOpenCodeConfigPath()}`))
+  console.log(chalk.dim('  Opening OpenCode WebUI...'))
+  console.log()
+
+  await launchWeb()
+}
+
 // ─── Start OpenCode Desktop ───────────────────────────────────────────────────
 
 export async function startOpenCodeDesktop(model, fcmConfig) {