free-coding-models 0.3.37 → 0.3.40

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, π Pi, 🦘 Rovo or ♊ Gemini in one keystroke</sub>
 </p>
 
 
@@ -182,6 +182,9 @@ free-coding-models --openclaw --origin groq
 | `--qwen` | 🐉 Qwen Code |
 | `--openhands` | 🤲 OpenHands |
 | `--amp` | ⚡ Amp |
+| `--hermes` | 🔮 Hermes |
+| `--continue` | ▶️ Continue CLI |
+| `--cline` | 🧠 Cline |
 | `--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.40",
   "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

@@ -233,6 +233,9 @@ export async function runApp(cliArgs, config) {
       qwen: cliArgs.qwenMode,
       openhands: cliArgs.openHandsMode,
       amp: cliArgs.ampMode,
+      hermes: cliArgs.hermesMode,
+      'continue': cliArgs.continueMode,
+      cline: cliArgs.clineMode,
       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/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/tool-bootstrap.js

@@ -228,6 +228,40 @@ export const TOOL_BOOTSTRAP_METADATA = {
       },
     },
   },
+  'continue': {
+    binary: 'cn',
+    docsUrl: 'https://docs.continue.dev/cli/overview',
+    install: {
+      default: {
+        shellCommand: 'npm install -g @continuedev/cli',
+        summary: 'Install Continue CLI globally via npm.',
+      },
+    },
+  },
+  cline: {
+    binary: 'cline',
+    docsUrl: 'https://docs.cline.bot/cline-cli/overview',
+    install: {
+      default: {
+        shellCommand: 'npm install -g cline',
+        summary: 'Install Cline CLI globally via npm.',
+      },
+    },
+  },
+  hermes: {
+    binary: 'hermes',
+    docsUrl: 'https://github.com/NousResearch/hermes-agent',
+    install: {
+      default: {
+        shellCommand: 'curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash',
+        summary: 'Install Hermes Agent via the official Nous Research installer.',
+        note: 'Hermes requires Python 3.11+ and git. The installer handles everything else automatically.',
+      },
+    },
+    installUnsupported: {
+      win32: 'Hermes Agent does not support native Windows. Use WSL2 instead.',
+    },
+  },
   gemini: {
     binary: 'gemini',
     docsUrl: 'https://github.com/google-gemini/gemini-cli',

package/src/tool-launchers.js

@@ -17,6 +17,9 @@
  *   📖 Crush: writes crush.json with provider config + models.large/small defaults
  *   📖 Pi: uses --provider/--model CLI flags for guaranteed auto-selection
  *   📖 Aider: writes ~/.aider.conf.yml + passes --model flag
+ *   📖 Hermes: uses `hermes config set` CLI commands + `hermes gateway restart` before launching `hermes chat`
+ *   📖 Continue: writes ~/.continue/config.yaml with provider: openai + apiBase
+ *   📖 Cline: writes ~/.cline/globalState.json with openai-compatible provider config
  *
  * @functions
  *   → `resolveLauncherModelId` — choose the provider-specific id for a launch
@@ -36,7 +39,7 @@ import chalk from 'chalk'
 import { existsSync, mkdirSync, readFileSync, writeFileSync, copyFileSync } from 'fs'
 import { homedir } from 'os'
 import { dirname, join } from 'path'
-import { spawn } from 'child_process'
+import { spawn, spawnSync } from 'child_process'
 import { sources } from '../sources.js'
 import { PROVIDER_COLOR } from './render-table.js'
 import { getApiKey } from './config.js'
@@ -73,6 +76,9 @@ function getDefaultToolPaths(homeDir = homedir()) {
     piModelsPath: join(homeDir, '.pi', 'agent', 'models.json'),
     piSettingsPath: join(homeDir, '.pi', 'agent', 'settings.json'),
     openHandsEnvPath: join(homeDir, '.fcm-openhands-env'),
+    hermesConfigPath: join(homeDir, '.hermes', 'config.yaml'),
+    continueConfigPath: join(homeDir, '.continue', 'config.yaml'),
+    clineConfigPath: join(homeDir, '.cline', 'globalState.json'),
   }
 }
 
@@ -401,6 +407,80 @@ function writeRovoConfig(model, configPath = join(homedir(), '.rovodev', 'config
   return { filePath: configPath, backupPath }
 }
 
+// 📖 writeContinueConfig — write ~/.continue/config.yaml with the selected model.
+// 📖 Continue CLI uses YAML config with `provider: openai` for OpenAI-compatible endpoints.
+function writeContinueConfig(model, apiKey, baseUrl, paths = getDefaultToolPaths()) {
+  const filePath = paths.continueConfigPath
+  const backupPath = backupIfExists(filePath)
+  // 📖 Write a minimal config.yaml that Continue CLI can parse directly
+  const content = [
+    '# 📖 Managed by free-coding-models',
+    'name: FCM Config',
+    'version: 0.0.1',
+    'schema: v1',
+    'models:',
+    '  - name: ' + (model.label || model.modelId),
+    '    provider: openai',
+    '    model: ' + model.modelId,
+    ...(baseUrl ? ['    apiBase: ' + baseUrl] : []),
+    ...(apiKey ? ['    apiKey: ' + apiKey] : []),
+    '    roles:',
+    '      - chat',
+    '      - edit',
+    '      - apply',
+    '',
+  ].join('\n')
+  ensureDir(filePath)
+  writeFileSync(filePath, content)
+  return { filePath, backupPath }
+}
+
+// 📖 writeClineConfig — write ~/.cline/globalState.json with the selected model.
+// 📖 Cline CLI stores provider config in globalState.json under apiConfiguration.
+function writeClineConfig(model, apiKey, baseUrl, paths = getDefaultToolPaths()) {
+  const filePath = paths.clineConfigPath
+  const backupPath = backupIfExists(filePath)
+  const config = readJson(filePath, {})
+  // 📖 Set the API provider to "openai-compatible" and configure the endpoint
+  config.apiConfiguration = {
+    ...(config.apiConfiguration || {}),
+    apiProvider: 'openai-compatible',
+    openAiCompatibleApiModelId: model.modelId,
+    ...(baseUrl ? { openAiCompatibleApiBaseUrl: baseUrl } : {}),
+    ...(apiKey ? { openAiCompatibleApiKey: apiKey } : {}),
+  }
+  writeJson(filePath, config)
+  return { filePath, backupPath }
+}
+
+// 📖 writeHermesConfig — configure Hermes Agent via its own `hermes config set` CLI.
+// 📖 This avoids YAML parsing and uses Hermes's native config management.
+// 📖 Sets model name, base_url (OpenAI-compatible endpoint), and api_key.
+function writeHermesConfig(model, apiKey, baseUrl, paths = getDefaultToolPaths()) {
+  const configPath = paths.hermesConfigPath
+  const backupPath = backupIfExists(configPath)
+  const hermesBin = resolveToolBinaryPath('hermes') || 'hermes'
+
+  // 📖 Use `hermes config set` for each field — robust and dependency-free
+  spawnSync(hermesBin, ['config', 'set', 'model', model.modelId], { stdio: 'ignore' })
+  spawnSync(hermesBin, ['config', 'set', 'model.provider', 'custom'], { stdio: 'ignore' })
+  if (baseUrl) {
+    spawnSync(hermesBin, ['config', 'set', 'model.base_url', baseUrl], { stdio: 'ignore' })
+  }
+  if (apiKey) {
+    spawnSync(hermesBin, ['config', 'set', 'model.api_key', apiKey], { stdio: 'ignore' })
+  }
+
+  return { filePath: configPath, backupPath }
+}
+
+// 📖 restartHermesGateway — restart the Hermes messaging gateway after config changes.
+// 📖 Non-blocking: if gateway is not running, this is a no-op.
+function restartHermesGateway() {
+  const hermesBin = resolveToolBinaryPath('hermes') || 'hermes'
+  spawnSync(hermesBin, ['gateway', 'restart'], { stdio: 'ignore', timeout: 10000 })
+}
+
 /**
  * 📖 buildGeminiEnv - Build environment variables for Gemini CLI
  *
@@ -597,6 +677,45 @@ export function prepareExternalToolLaunch(mode, model, config, options = {}) {
     }
   }
 
+  if (mode === 'hermes') {
+    const result = writeHermesConfig(model, apiKey, baseUrl, paths)
+    return {
+      command: 'hermes',
+      args: ['chat'],
+      env,
+      apiKey,
+      baseUrl,
+      meta,
+      configArtifacts: [{ path: result.filePath, backupPath: result.backupPath, label: 'config' }],
+    }
+  }
+
+  if (mode === 'continue') {
+    const result = writeContinueConfig(model, apiKey, baseUrl, paths)
+    return {
+      command: 'cn',
+      args: [],
+      env,
+      apiKey,
+      baseUrl,
+      meta,
+      configArtifacts: [{ path: result.filePath, backupPath: result.backupPath, label: 'config' }],
+    }
+  }
+
+  if (mode === 'cline') {
+    const result = writeClineConfig(model, apiKey, baseUrl, paths)
+    return {
+      command: 'cline',
+      args: [],
+      env,
+      apiKey,
+      baseUrl,
+      meta,
+      configArtifacts: [{ path: result.filePath, backupPath: result.backupPath, label: 'config' }],
+    }
+  }
+
   if (mode === 'rovo') {
     const result = writeRovoConfig(model, join(homedir(), '.rovodev', 'config.yml'), paths)
     console.log(chalk.dim(`  📖 Rovo Dev CLI configured with model: ${model.modelId}`))
@@ -679,6 +798,23 @@ export async function startExternalTool(mode, model, config) {
     return spawnCommand(resolveLaunchCommand(mode, launchPlan.command), launchPlan.args, launchPlan.env)
   }
 
+  if (mode === 'hermes') {
+    // 📖 Restart the Hermes gateway so the new model config takes effect immediately
+    restartHermesGateway()
+    console.log(chalk.dim(`  📖 Hermes Agent configured with model: ${model.modelId}`))
+    return spawnCommand(resolveLaunchCommand(mode, launchPlan.command), launchPlan.args, launchPlan.env)
+  }
+
+  if (mode === 'continue') {
+    console.log(chalk.dim(`  📖 Continue CLI configured with model: ${model.modelId}`))
+    return spawnCommand(resolveLaunchCommand(mode, launchPlan.command), launchPlan.args, launchPlan.env)
+  }
+
+  if (mode === 'cline') {
+    console.log(chalk.dim(`  📖 Cline configured with model: ${model.modelId}`))
+    return spawnCommand(resolveLaunchCommand(mode, launchPlan.command), launchPlan.args, launchPlan.env)
+  }
+
   if (mode === 'rovo') {
     console.log(chalk.dim(`  📖 Launching Rovo Dev CLI in interactive mode...`))
     return spawnCommand(resolveLaunchCommand(mode, launchPlan.command), launchPlan.args, launchPlan.env)

package/src/tool-metadata.js

@@ -36,6 +36,9 @@ export const TOOL_METADATA = {
   qwen:              { label: 'Qwen Code',         emoji: '🐉', flag: '--qwen',             color: [255, 213, 128] },
   openhands:         { label: 'OpenHands',         emoji: '🤲', flag: '--openhands',        color: [228, 191, 239] },
   amp:               { label: 'Amp',               emoji: '⚡', flag: '--amp',              color: [255, 232, 98] },
+  hermes:            { label: 'Hermes',            emoji: '🔮', flag: '--hermes',           color: [200, 160, 255] },
+  'continue':        { label: 'Continue CLI',     emoji: '▶️', flag: '--continue',         color: [255, 100, 100] },
+  cline:             { label: 'Cline',             emoji: '🧠', flag: '--cline',            color: [100, 220, 180] },
   rovo:              { label: 'Rovo Dev CLI',      emoji: '🦘', flag: '--rovo',             color: [148, 163, 184], cliOnly: true },
   gemini:            { label: 'Gemini CLI',        emoji: '♊', flag: '--gemini',           color: [66, 165, 245],  cliOnly: true },
 }
@@ -53,6 +56,9 @@ export const COMPAT_COLUMN_SLOTS = [
   { emoji: '🐉', toolKeys: ['qwen'],                         color: [255, 213, 128] },
   { emoji: '🤲', toolKeys: ['openhands'],                    color: [228, 191, 239] },
   { emoji: '⚡', toolKeys: ['amp'],                          color: [255, 232, 98] },
+  { emoji: '🔮', toolKeys: ['hermes'],                       color: [200, 160, 255] },
+  { emoji: '▶️', toolKeys: ['continue'],                     color: [255, 100, 100] },
+  { emoji: '🧠', toolKeys: ['cline'],                        color: [100, 220, 180] },
   { emoji: '🦘', toolKeys: ['rovo'],                         color: [148, 163, 184] },
   { emoji: '♊', toolKeys: ['gemini'],                       color: [66, 165, 245] },
 ]
@@ -68,6 +74,9 @@ export const TOOL_MODE_ORDER = [
   'qwen',
   'openhands',
   'amp',
+  'hermes',
+  'continue',
+  'cline',
   'rovo',
   'gemini',
 ]

package/src/utils.js

@@ -455,12 +455,18 @@ export function parseArgs(argv) {
   const ampMode = flags.includes('--amp')
   const piMode = flags.includes('--pi')
   const rovoMode = flags.includes('--rovo')
+  const hermesMode = flags.includes('--hermes')
+  const continueMode = flags.includes('--continue')
+  const clineMode = flags.includes('--cline')
   const geminiMode = flags.includes('--gemini')
   const noTelemetry = flags.includes('--no-telemetry')
   const jsonMode = flags.includes('--json')
   const helpMode = flags.includes('--help') || flags.includes('-h')
   const premiumMode = flags.includes('--premium')
 
+  // 📖 --web / --gui / web subcommand — launch the web dashboard instead of the TUI
+  const webMode = flags.includes('--web') || flags.includes('--gui') || args[0] === 'web'
+
   // New boolean flags
   const sortDesc = flags.includes('--desc')
   const sortAscFlag = flags.includes('--asc')
@@ -492,6 +498,9 @@ export function parseArgs(argv) {
     openHandsMode,
     ampMode,
     piMode,
+    hermesMode,
+    continueMode,
+    clineMode,
     rovoMode,
     geminiMode,
     noTelemetry,
@@ -505,6 +514,7 @@ export function parseArgs(argv) {
     hideUnconfigured,
     showUnconfigured,
     premiumMode,
+    webMode,
     // 📖 Profile system removed - API keys now persist permanently across all sessions
     recommendMode,
   }