free-coding-models 0.3.37 → 0.3.41

package/README.md

@@ -14,7 +14,7 @@
 
 <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, π 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, 🦞 OpenClaw, 💘 Crush, 🪿 Goose, 🛠 Aider, 🐉 Qwen Code, 🤲 OpenHands, ⚡ Amp, 🔮 Hermes, ▶️ Continue, 🧠 Cline, 🛠️ Xcode, π Pi, 🦘 Rovo or ♊ Gemini in one keystroke</sub>
 </p>
 
 
@@ -159,6 +159,9 @@ free-coding-models --goose --tier S
 # "I want NVIDIA's top models only"
 free-coding-models --origin nvidia --tier S
 
+# "I want the local web dashboard"
+free-coding-models --web
+
 # "Start with an elite-focused preset, then adjust filters live"
 free-coding-models --premium
 
@@ -169,6 +172,8 @@ free-coding-models --tier S --json | jq -r '.[0].modelId'
 free-coding-models --openclaw --origin groq
 ```
 
+When launching the web dashboard, `free-coding-models` prefers `http://localhost:3333`. If that port is already used by another app, it now auto-picks the next free local port and prints the exact URL to open.
+
 ### Tool launcher flags
 
 | Flag | Launches |
@@ -182,6 +187,10 @@ free-coding-models --openclaw --origin groq
 | `--qwen` | 🐉 Qwen Code |
 | `--openhands` | 🤲 OpenHands |
 | `--amp` | ⚡ Amp |
+| `--hermes` | 🔮 Hermes |
+| `--continue` | ▶️ Continue CLI |
+| `--cline` | 🧠 Cline |
+| `--xcode` | 🛠️ Xcode Intelligence |
 | `--pi` | π Pi |
 | `--rovo` | 🦘 Rovo Dev CLI |
 | `--gemini` | ♊ Gemini CLI |

package/bin/free-coding-models.js

@@ -46,6 +46,14 @@ async function main() {
     process.exit(1);
   }
 
+  // 📖 --web mode: launch the web dashboard instead of the TUI
+  if (cliArgs.webMode) {
+    const { startWebServer } = await import('../web/server.js')
+    const port = parseInt(process.env.FCM_PORT || '3333', 10)
+    await startWebServer(port, { open: true })
+    return
+  }
+
   // 📖 Load JSON config
   const config = loadConfig();
   ensureTelemetryConfig(config);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "free-coding-models",
-  "version": "0.3.37",
+  "version": "0.3.41",
   "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",
@@ -41,6 +41,7 @@
   "files": [
     "bin/",
     "src/",
+    "web/",
     "sources.js",
     "patch-openclaw.js",
     "patch-openclaw-models.js",
@@ -51,16 +52,25 @@
   "scripts": {
     "start": "node bin/free-coding-models.js",
     "test": "node --test test/test.js",
+    "dev:web": "node scripts/dev-web.mjs",
+    "build:web": "vite build",
+    "preview:web": "vite preview",
     "test:fcm": "node scripts/testfcm-runner.mjs",
     "test:fcm:mock": "node scripts/testfcm-runner.mjs --tool crush --tool-bin-dir test/fixtures/mock-bin"
   },
   "dependencies": {
-    "chalk": "^5.4.1"
+    "chalk": "^5.6.2"
   },
+  "packageManager": "pnpm@10.24.0",
   "engines": {
     "node": ">=18.0.0"
   },
   "devDependencies": {
-    "@mariozechner/terminalcp": "^1.3.3"
+    "@vitejs/plugin-react": "^6.0.1",
+    "agent-tui": "^1.0.1",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "vite": "^8.0.5",
+    "vite-plus": "^0.1.16"
   }
 }

package/src/app.js

@@ -114,6 +114,7 @@ import { parseTelemetryEnv, isTelemetryDebugEnabled, telemetryDebug, ensureTelem
 import { ensureFavoritesConfig, toFavoriteKey, syncFavoriteFlags, toggleFavoriteModel } from '../src/favorites.js'
 import { checkForUpdateDetailed, checkForUpdate, runUpdate, promptUpdateNotification, fetchLastReleaseDate } from './updater.js'
 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'
@@ -215,6 +216,31 @@ export async function runApp(cliArgs, config) {
       console.log()
       process.exit(1)
     }
+    // 📖 New users get shell env enabled by default
+    if (config.settings.shellEnvEnabled === undefined) {
+      config.settings.shellEnvEnabled = true
+      saveConfig(config)
+      syncShellEnv(config)
+      ensureShellRcSource()
+    }
+  }
+
+  // 📖 Shell env migration popup for existing users who haven't been asked yet
+  // 📖 Only show when user has keys but shellEnvEnabled is still undefined (never prompted)
+  if (hasAnyKey && config.settings.shellEnvEnabled === undefined) {
+    const choice = await promptShellEnvMigration(config)
+    if (choice === 'enable') {
+      if (!config.settings) config.settings = {}
+      config.settings.shellEnvEnabled = true
+      saveConfig(config)
+      syncShellEnv(config)
+      ensureShellRcSource()
+    } else if (choice === 'never') {
+      if (!config.settings) config.settings = {}
+      config.settings.shellEnvEnabled = false
+      saveConfig(config)
+    }
+    // 📖 'skip' leaves shellEnvEnabled undefined — will prompt again next launch
   }
 
   // 📖 Default mode: use the last persisted launcher choice when valid,
@@ -233,6 +259,10 @@ export async function runApp(cliArgs, config) {
       qwen: cliArgs.qwenMode,
       openhands: cliArgs.openHandsMode,
       amp: cliArgs.ampMode,
+      hermes: cliArgs.hermesMode,
+      'continue': cliArgs.continueMode,
+      cline: cliArgs.clineMode,
+      xcode: cliArgs.xcodeMode,
       pi: cliArgs.piMode,
       rovo: cliArgs.rovoMode,
       gemini: cliArgs.geminiMode,

package/src/cli-help.js

@@ -36,12 +36,14 @@ const ANALYSIS_FLAGS = [
 ]
 
 const CONFIG_FLAGS = [
+  { flag: '--web', description: 'Launch the web dashboard in your browser' },
   { flag: '--no-telemetry', description: 'Disable anonymous telemetry for this run' },
   { flag: '--help, -h', description: 'Print this help and exit' },
 ]
 
 const EXAMPLES = [
   'free-coding-models --help',
+  'free-coding-models --web',
   'free-coding-models --openclaw --tier S',
   "free-coding-models --json | jq '.[0]'",
 ]

package/src/command-palette.js

@@ -28,6 +28,9 @@ const TOOL_MODE_DESCRIPTIONS = {
   qwen: 'Launch Qwen Code using the selected provider model.',
   openhands: 'Launch OpenHands with the selected model endpoint.',
   amp: 'Launch Amp with this model as active target.',
+  hermes: 'Launch Hermes Agent with the selected model.',
+  'continue': 'Launch Continue CLI with the selected model.',
+  cline: 'Launch Cline CLI with the selected model.',
   rovo: 'Rovo Dev CLI model (launch with Rovo tool only).',
   gemini: 'Gemini CLI model (launch with Gemini tool only).',
 }

package/src/config.js

@@ -102,6 +102,7 @@
 import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync, statSync, unlinkSync, renameSync } from 'node:fs'
 import { homedir } from 'node:os'
 import { join } from 'node:path'
+import { syncShellEnv } from './shell-env.js'
 
 // 📖 New JSON config path — stores all providers' API keys + enabled state
 export const CONFIG_PATH = join(homedir(), '.free-coding-models.json')
@@ -484,6 +485,12 @@ export function saveConfig(config, options = {}) {
       }
 
       replaceConfigContents(config, persistedConfig)
+
+      // 📖 Keep shell env file in sync when enabled
+      if (persistedConfig.settings?.shellEnvEnabled) {
+        try { syncShellEnv(persistedConfig) } catch { /* non-critical */ }
+      }
+
       return { success: true, backupCreated }
     } catch (verifyError) {
       // 📖 Verification failed - this is critical!

package/src/endpoint-installer.js

@@ -52,7 +52,7 @@ import { getToolMeta } from './tool-metadata.js'
 const DIRECT_INSTALL_UNSUPPORTED_PROVIDERS = new Set(['replicate', 'zai', 'rovo', 'gemini', 'opencode-zen'])
 // 📖 Install Endpoints only lists tools whose persisted config shape is actually supported here.
 // 📖 Claude Code, Codex, and Gemini stay out while their dedicated bridges are being rebuilt.
-const INSTALL_TARGET_MODES = ['opencode', 'opencode-desktop', 'openclaw', 'crush', 'goose', 'pi', 'aider', 'qwen', 'openhands', 'amp']
+const INSTALL_TARGET_MODES = ['opencode', 'opencode-desktop', 'openclaw', 'crush', 'goose', 'pi', 'aider', 'qwen', 'openhands', 'amp', 'hermes', 'continue', 'cline']
 
 function getDefaultPaths() {
   const home = homedir()

package/src/key-handler.js

@@ -33,6 +33,7 @@ import { loadConfig, replaceConfigContents } from './config.js'
 import { cleanupLegacyProxyArtifacts } from './legacy-proxy-cleanup.js'
 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 { scanAllToolConfigs, softDeleteModel } from './installed-models-manager.js'
@@ -553,6 +554,19 @@ export function createKeyHandler(ctx) {
     applyThemeSetting(cycleThemeSetting(currentTheme))
   }
 
+  function toggleShellEnv() {
+    if (!state.config.settings) state.config.settings = {}
+    const currentlyEnabled = state.config.settings.shellEnvEnabled === true
+    state.config.settings.shellEnvEnabled = !currentlyEnabled
+    saveConfig(state.config)
+    if (!currentlyEnabled) {
+      syncShellEnv(state.config)
+      ensureShellRcSource()
+    } else {
+      removeShellEnv()
+    }
+  }
+
   function resetInstallEndpointsOverlay() {
     state.installEndpointsOpen = false
     state.installEndpointsPhase = 'providers'
@@ -1828,8 +1842,9 @@ export function createKeyHandler(ctx) {
       const favoritesModeRowIdx = themeRowIdx + 1
       const cleanupLegacyProxyRowIdx = favoritesModeRowIdx + 1
       const changelogViewRowIdx = cleanupLegacyProxyRowIdx + 1
+      const shellEnvRowIdx = changelogViewRowIdx + 1
         // 📖 Profile system removed - API keys now persist permanently across all sessions
-      const maxRowIdx = changelogViewRowIdx
+      const maxRowIdx = shellEnvRowIdx
 
       // 📖 Edit/Add-key mode: capture typed characters for the API key
       if (state.settingsEditMode || state.settingsAddKeyMode) {
@@ -1993,6 +2008,12 @@ export function createKeyHandler(ctx) {
           return
         }
 
+        // 📖 Shell env row: Enter → toggle shell env export
+        if (state.settingsCursor === shellEnvRowIdx) {
+          toggleShellEnv()
+          return
+        }
+
         // 📖 Profile system removed - API keys now persist permanently across all sessions
 
         // 📖 Enter edit mode for the selected provider's key
@@ -2010,6 +2031,11 @@ export function createKeyHandler(ctx) {
           || state.settingsCursor === cleanupLegacyProxyRowIdx
           || state.settingsCursor === changelogViewRowIdx
         ) return
+        // 📖 Shell env toggle
+        if (state.settingsCursor === shellEnvRowIdx) {
+          toggleShellEnv()
+          return
+        }
         // 📖 Theme configuration cycle inside settings
         if (state.settingsCursor === themeRowIdx) {
           cycleGlobalTheme()

package/src/overlays.js

@@ -120,6 +120,7 @@ export function createOverlayRenderers(state, deps) {
     const favoritesModeRowIdx = themeRowIdx + 1
     const cleanupLegacyProxyRowIdx = favoritesModeRowIdx + 1
     const changelogViewRowIdx = cleanupLegacyProxyRowIdx + 1
+    const shellEnvRowIdx = changelogViewRowIdx + 1
     const EL = '\x1b[K'
     const lines = []
     const cursorLineByRow = {}
@@ -272,6 +273,15 @@ export function createOverlayRenderers(state, deps) {
     cursorLineByRow[changelogViewRowIdx] = lines.length
     lines.push(state.settingsCursor === changelogViewRowIdx ? themeColors.bgCursorSettingsList(changelogViewRow) : changelogViewRow)
 
+    // 📖 Shell env toggle — expose API keys as shell environment variables
+    const shellEnvEnabled = state.config.settings?.shellEnvEnabled === true
+    const shellEnvStatus = shellEnvEnabled
+      ? themeColors.successBold('✅ Enabled — keys available in shell')
+      : themeColors.dim('❌ Disabled')
+    const shellEnvRow = `${bullet(state.settingsCursor === shellEnvRowIdx)}${themeColors.textBold('Shell Env Export').padEnd(44)} ${shellEnvStatus}`
+    cursorLineByRow[shellEnvRowIdx] = lines.length
+    lines.push(state.settingsCursor === shellEnvRowIdx ? themeColors.bgCursorSettingsList(shellEnvRow) : shellEnvRow)
+
     // 📖 Profile system removed - API keys now persist permanently across all sessions
 
     lines.push('')
@@ -313,7 +323,7 @@ export function createOverlayRenderers(state, deps) {
     // 📖 Mouse support: record layout so click handler can map Y → settingsCursor
     overlayLayout.settingsCursorToLine = { ...cursorLineByRow }
     overlayLayout.settingsScrollOffset = offset
-    overlayLayout.settingsMaxRow = changelogViewRowIdx
+    overlayLayout.settingsMaxRow = shellEnvRowIdx
 
     const tintedLines = tintOverlayLines(visible, themeColors.overlayBgSettings, state.terminalCols)
     const cleared = tintedLines.map(l => l + EL)