free-coding-models 0.3.37 → 0.3.41

package/src/shell-env.js

@@ -0,0 +1,393 @@
+/**
+ * @file shell-env.js
+ * @description Exposes API keys as shell environment variables via a sourced dotfile.
+ *
+ * @details
+ *   Creates `~/.free-coding-models.env` containing `export VAR="value"` lines for every
+ *   configured provider, and injects a single `[ -f ~/.free-coding-models.env ] && source ...`
+ *   line into the user's shell rc file (`.zshrc`, `.bashrc`, or fish `config.fish`).
+ *
+ *   The env file is kept in sync automatically: every time `saveConfig()` or
+ *   `persistApiKeysForProvider()` writes a new config to disk, `syncShellEnv()` is called
+ *   to regenerate the `.env` if `settings.shellEnvEnabled === true`.
+ *
+ *   Shell detection uses `$SHELL` with a fallback chain: zsh → bash → fish.
+ *   Each shell's rc path is resolved relative to `$HOME`. Fish uses `set -gx` syntax
+ *   instead of `export`, which is handled transparently.
+ *
+ *   The env file is written with mode `0600` (owner read/write only) to protect API keys.
+ *   The source line in the rc file is idempotent — calling `ensureShellRcSource()` multiple
+ *   times will never add a duplicate line.
+ *
+ * @functions
+ *   → `syncShellEnv(config)` — regenerate the .env file from current apiKeys
+ *   → `ensureShellRcSource()` — add the source line to the detected shell rc (idempotent)
+ *   → `removeShellEnv()` — delete the .env file and remove the source line from rc
+ *   → `detectShellInfo()` — return { shell, rcPath } for the current user
+ *   → `getEnvFilePath()` — return the absolute path to ~/.free-coding-models.env
+ *   → `buildEnvContent(config, shell)` — build the env file body (pure function, testable)
+ *   → `buildRcSourceLine(envFilePath, shell)` — build the rc source line for a given shell
+ *
+ * @exports syncShellEnv, ensureShellRcSource, removeShellEnv, detectShellInfo,
+ *          getEnvFilePath, buildEnvContent, buildRcSourceLine, ENV_FILE_MARKER
+ *
+ * @see src/config.js — calls syncShellEnv() after saveConfig()
+ * @see src/provider-metadata.js — ENV_VAR_NAMES maps provider → env var name
+ */
+
+import { readFileSync, writeFileSync, existsSync, mkdirSync, unlinkSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+import * as readline from 'node:readline'
+import chalk from 'chalk'
+import { ENV_VAR_NAMES } from './provider-metadata.js'
+
+// 📖 Unique marker used to identify the source line we inject into shell rc files.
+// 📖 This allows idempotent add/remove without relying on exact path matching.
+export const ENV_FILE_MARKER = '# free-coding-models-env'
+
+// 📖 The env dotfile path — always next to the JSON config in $HOME.
+const ENV_FILE_NAME = '.free-coding-models.env'
+
+/**
+ * 📖 Returns the absolute path to the env dotfile.
+ * @returns {string}
+ */
+export function getEnvFilePath() {
+  return join(homedir(), ENV_FILE_NAME)
+}
+
+/**
+ * 📖 Detect the user's shell and return its rc file path.
+ *
+ * Detection order: $SHELL env var → fallback to zsh → bash → fish.
+ * Returns the shell type ('zsh'|'bash'|'fish') and the absolute rc path.
+ *
+ * @returns {{ shell: 'zsh'|'bash'|'fish', rcPath: string }}
+ */
+export function detectShellInfo() {
+  const shellEnv = (process.env.SHELL || '').toLowerCase()
+  const home = homedir()
+
+  if (shellEnv.includes('zsh')) {
+    return { shell: 'zsh', rcPath: join(home, '.zshrc') }
+  }
+  if (shellEnv.includes('bash')) {
+    return { shell: 'bash', rcPath: join(home, '.bashrc') }
+  }
+  if (shellEnv.includes('fish')) {
+    return { shell: 'fish', rcPath: join(home, '.config', 'fish', 'config.fish') }
+  }
+
+  // 📖 Fallback: try to detect which rc files exist
+  if (existsSync(join(home, '.zshrc'))) {
+    return { shell: 'zsh', rcPath: join(home, '.zshrc') }
+  }
+  if (existsSync(join(home, '.bashrc'))) {
+    return { shell: 'bash', rcPath: join(home, '.bashrc') }
+  }
+  const fishConfig = join(home, '.config', 'fish', 'config.fish')
+  if (existsSync(fishConfig)) {
+    return { shell: 'fish', rcPath: fishConfig }
+  }
+
+  // 📖 Last resort: assume zsh (most common on macOS/Linux)
+  return { shell: 'zsh', rcPath: join(home, '.zshrc') }
+}
+
+/**
+ * 📖 Build the env file content for a given shell type.
+ *
+ * Pure function — no I/O. Iterates over config.apiKeys and generates
+ * the appropriate `export` (bash/zsh) or `set -gx` (fish) lines.
+ *
+ * @param {{ apiKeys: Record<string, string|string[]> }} config
+ * @param {'zsh'|'bash'|'fish'} shell
+ * @returns {string} The complete file content to write
+ */
+export function buildEnvContent(config, shell) {
+  const apiKeys = config?.apiKeys || {}
+  const lines = [
+    '#!/bin/env sh',
+    `# ${ENV_FILE_MARKER}`,
+    '# Auto-generated by free-coding-models — do not edit manually.',
+    '# Changes to API keys are synced automatically from the TUI.',
+    '',
+  ]
+
+  const isFish = shell === 'fish'
+
+  for (const [providerKey, envName] of Object.entries(ENV_VAR_NAMES)) {
+    const rawValue = apiKeys[providerKey]
+    if (!rawValue) continue
+
+    // 📖 Support multi-key arrays — use the first key for shell env
+    const value = Array.isArray(rawValue) ? rawValue[0] : rawValue
+    if (!value || typeof value !== 'string') continue
+
+    const safeValue = value.replace(/'/g, "'\\''")
+
+    if (isFish) {
+      lines.push(`set -gx ${envName} '${safeValue}'`)
+    } else {
+      lines.push(`export ${envName}='${safeValue}'`)
+    }
+  }
+
+  lines.push('')
+  return lines.join('\n')
+}
+
+/**
+ * 📖 Build the rc source line that loads the env file.
+ *
+ * For bash/zsh: `[ -f ~/.free-coding-models.env ] && . ~/.free-coding-models.env  # free-coding-models-env`
+ * For fish:     `test -f ~/.free-coding-models.env; and source ~/.free-coding-models.env  # free-coding-models-env`
+ *
+ * @param {string} envFilePath — absolute path to the .env file
+ * @param {'zsh'|'bash'|'fish'} shell
+ * @returns {string} A single line to append to the rc file
+ */
+export function buildRcSourceLine(envFilePath, shell) {
+  const home = homedir()
+  // 📖 Use ~/ relative path in rc for portability
+  const relativePath = envFilePath.startsWith(home)
+    ? '~/' + envFilePath.slice(home.length + 1)
+    : envFilePath
+
+  if (shell === 'fish') {
+    return `test -f ${relativePath}; and source ${relativePath}  ${ENV_FILE_MARKER}`
+  }
+  return `[ -f ${relativePath} ] && . ${relativePath}  ${ENV_FILE_MARKER}`
+}
+
+/**
+ * 📖 Regenerate the env file from the current config.
+ *
+ * Called after every saveConfig() when shellEnvEnabled is true.
+ * Writes with mode 0600 for security. Skips if there are no keys.
+ *
+ * @param {{ apiKeys: Record<string, string|string[]>, settings?: { shellEnvEnabled?: boolean } }} config
+ * @returns {{ success: boolean, envPath: string, error?: string }}
+ */
+export function syncShellEnv(config) {
+  const { shell } = detectShellInfo()
+  const envPath = getEnvFilePath()
+  const apiKeys = config?.apiKeys || {}
+  const hasKeys = Object.values(apiKeys).some(v => {
+    if (Array.isArray(v)) return v.length > 0
+    return !!v
+  })
+
+  if (!hasKeys) {
+    // 📖 No keys — remove stale env file if it exists
+    if (existsSync(envPath)) {
+      try { unlinkSync(envPath) } catch { /* best effort */ }
+    }
+    return { success: true, envPath }
+  }
+
+  try {
+    const content = buildEnvContent(config, shell)
+    writeFileSync(envPath, content, { mode: 0o600 })
+    return { success: true, envPath }
+  } catch (err) {
+    return { success: false, envPath, error: err.message }
+  }
+}
+
+/**
+ * 📖 Add the source line to the user's shell rc file (idempotent).
+ *
+ * Creates the rc file if it doesn't exist. Skips if the marker is already present.
+ *
+ * @returns {{ success: boolean, rcPath: string, wasAdded: boolean, error?: string }}
+ */
+export function ensureShellRcSource() {
+  const { shell, rcPath } = detectShellInfo()
+  const envPath = getEnvFilePath()
+  const sourceLine = buildRcSourceLine(envPath, shell)
+
+  let existingContent = ''
+  if (existsSync(rcPath)) {
+    try {
+      existingContent = readFileSync(rcPath, 'utf8')
+    } catch (err) {
+      return { success: false, rcPath, wasAdded: false, error: `Cannot read ${rcPath}: ${err.message}` }
+    }
+  }
+
+  // 📖 Idempotent: skip if our marker is already in the file
+  if (existingContent.includes(ENV_FILE_MARKER)) {
+    return { success: true, rcPath, wasAdded: false }
+  }
+
+  try {
+    // 📖 Ensure parent directory exists (e.g. ~/.config/fish/)
+    const dir = join(rcPath, '..')
+    if (!existsSync(dir)) mkdirSync(dir, { recursive: true })
+
+    const newContent = existingContent
+      ? existingContent.trimEnd() + '\n\n' + sourceLine + '\n'
+      : sourceLine + '\n'
+    writeFileSync(rcPath, newContent)
+    return { success: true, rcPath, wasAdded: true }
+  } catch (err) {
+    return { success: false, rcPath, wasAdded: false, error: `Cannot write ${rcPath}: ${err.message}` }
+  }
+}
+
+/**
+ * 📖 Remove the env file and the source line from the shell rc.
+ *
+ * @returns {{ success: boolean, envRemoved: boolean, rcCleaned: boolean, error?: string }}
+ */
+export function removeShellEnv() {
+  const { shell, rcPath } = detectShellInfo()
+  const envPath = getEnvFilePath()
+  let envRemoved = false
+  let rcCleaned = false
+
+  // 📖 Remove the env file
+  if (existsSync(envPath)) {
+    try {
+      unlinkSync(envPath)
+      envRemoved = true
+    } catch (err) {
+      return { success: false, envRemoved: false, rcCleaned: false, error: `Cannot delete ${envPath}: ${err.message}` }
+    }
+  }
+
+  // 📖 Remove the source line from rc
+  if (existsSync(rcPath)) {
+    try {
+      const content = readFileSync(rcPath, 'utf8')
+      if (content.includes(ENV_FILE_MARKER)) {
+        const cleaned = content
+          .split('\n')
+          .filter(line => !line.includes(ENV_FILE_MARKER))
+          .join('\n')
+          .replace(/\n{3,}/g, '\n\n')
+        writeFileSync(rcPath, cleaned)
+        rcCleaned = true
+      }
+    } catch {
+      // 📖 Non-critical — env file is already removed
+    }
+  }
+
+  return { success: true, envRemoved, rcCleaned }
+}
+
+/**
+ * 📖 Pre-TUI popup asking the user whether to enable shell env exposure.
+ *
+ * Follows the same pattern as `promptUpdateNotification()` in updater.js.
+ * Shows three options: Enable (recommended, green), Skip for now, Don't ask again.
+ * Runs BEFORE entering the alt-screen buffer so it renders in the normal terminal.
+ *
+ * @param {{ apiKeys: Record<string, string|string[]>, settings: object }} config
+ * @returns {Promise<'enable'|'skip'|'never'>} The user's choice
+ */
+export async function promptShellEnvMigration(config) {
+  const { shell, rcPath } = detectShellInfo()
+  const rcName = rcPath.split('/').pop()
+  const keyCount = Object.keys(config.apiKeys || {}).filter(pk => {
+    const v = config.apiKeys[pk]
+    return Array.isArray(v) ? v.length > 0 : !!v
+  }).length
+
+  return new Promise((resolve) => {
+    let selected = 0
+    const options = [
+      {
+        label: 'Yes, enable (recommended)',
+        icon: '✅',
+        description: `Export ${keyCount} API key${keyCount > 1 ? 's' : ''} to shell via ${rcName}`,
+      },
+      {
+        label: 'Skip for now',
+        icon: '⏭',
+        description: 'You can enable it later in Settings (P)',
+      },
+      {
+        label: "Don't ask again",
+        icon: '🔇',
+        description: 'Disable this prompt permanently',
+      },
+    ]
+
+    const render = () => {
+      process.stdout.write('\x1b[2J\x1b[H')
+
+      const terminalWidth = process.stdout.columns || 80
+      const maxWidth = Math.min(terminalWidth - 4, 70)
+      const centerPad = ' '.repeat(Math.max(0, Math.floor((terminalWidth - maxWidth) / 2)))
+
+      console.log()
+      console.log(centerPad + chalk.bold.rgb(110, 214, 255)('  🐚 Shell Environment Setup'))
+      console.log()
+      console.log(centerPad + chalk.white('  Expose your API keys as environment variables'))
+      console.log(centerPad + chalk.white('  so they are available globally in your shell.'))
+      console.log()
+      console.log(centerPad + chalk.dim(`  Detected shell: ${shell} (${rcName})`))
+      console.log(centerPad + chalk.dim(`  This adds a single source line to ${rcName}`))
+      console.log(centerPad + chalk.dim('  and creates ~/.free-coding-models.env (0600)'))
+      console.log()
+
+      for (let i = 0; i < options.length; i++) {
+        const isSelected = i === selected
+        const bullet = isSelected ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
+        let label
+        if (i === 0) {
+          label = isSelected
+            ? chalk.bold.rgb(112, 231, 181)(options[i].icon + ' ' + options[i].label + ' ★')
+            : chalk.rgb(112, 231, 181)(options[i].icon + ' ' + options[i].label)
+        } else {
+          label = isSelected
+            ? chalk.bold.white(options[i].icon + ' ' + options[i].label)
+            : chalk.dim(options[i].icon + ' ' + options[i].label)
+        }
+
+        console.log(centerPad + bullet + label)
+        console.log(centerPad + chalk.dim('       ' + options[i].description))
+        console.log()
+      }
+
+      console.log(centerPad + chalk.dim('  ↑↓ Navigate  •  Enter Select  •  Ctrl+C Skip'))
+      console.log()
+    }
+
+    render()
+
+    readline.emitKeypressEvents(process.stdin)
+    if (process.stdin.isTTY) process.stdin.setRawMode(true)
+
+    const onKey = (_str, key) => {
+      if (!key) return
+      if (key.ctrl && key.name === 'c') {
+        if (process.stdin.isTTY) process.stdin.setRawMode(false)
+        process.stdin.removeListener('keypress', onKey)
+        resolve('skip')
+        return
+      }
+      if (key.name === 'up' && selected > 0) {
+        selected--
+        render()
+      } else if (key.name === 'down' && selected < options.length - 1) {
+        selected++
+        render()
+      } else if (key.name === 'return') {
+        if (process.stdin.isTTY) process.stdin.setRawMode(false)
+        process.stdin.removeListener('keypress', onKey)
+        process.stdin.pause()
+
+        if (selected === 0) resolve('enable')
+        else if (selected === 1) resolve('skip')
+        else resolve('never')
+      }
+    }
+
+    process.stdin.on('keypress', onKey)
+  })
+}

package/src/tool-bootstrap.js

@@ -228,6 +228,47 @@ 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.',
+      },
+    },
+  },
+  xcode: {
+    binary: null,
+    docsUrl: 'https://developer.apple.com/documentation/Xcode/setting-up-coding-intelligence',
+    installUnsupported: {
+      default: 'Xcode Intelligence requires manual setup. Go to Xcode > Settings > Intelligence > Add a Chat Provider.',
+    },
+  },
+  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,82 @@ 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
+  // 📖 Must use 'model.default' not 'model', otherwise it replaces the entire model: dict with a string
+  // 📖 and subsequent model.provider / model.base_url / model.api_key calls silently fail
+  spawnSync(hermesBin, ['config', 'set', 'model.default', 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 +679,57 @@ 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 === 'xcode') {
+    return {
+      command: 'open',
+      args: ['-a', 'Xcode'],
+      env,
+      apiKey,
+      baseUrl,
+      meta,
+      configArtifacts: [],
+    }
+  }
+
   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 +812,38 @@ 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 === 'xcode') {
+    const xcodeUrl = baseUrl ? baseUrl.replace(/\/v1$/, '').replace(/\/v1\/chat\/completions$/, '') : ''
+    console.log(chalk.bold.cyan('\n  🛠️  Xcode Intelligence Setup Instructions:'))
+    console.log(chalk.white('  1. Open Xcode and go to ') + chalk.bold('Xcode > Settings > Intelligence'))
+    console.log(chalk.white('  2. Click ') + chalk.bold('Add a Chat Provider') + chalk.white(' and select ') + chalk.bold('Internet Hosted'))
+    console.log(chalk.white('  3. Enter the following details:'))
+    console.log(chalk.dim('     URL: ') + chalk.green(xcodeUrl))
+    console.log(chalk.dim('     API Key: ') + chalk.green(apiKey || '<your_api_key>'))
+    console.log(chalk.dim('     API Key Header: ') + chalk.green('Authorization') + chalk.dim(' (or x-api-key)'))
+    console.log(chalk.dim('     Description: ') + chalk.green(`FCM - ${sources[model.providerKey]?.name || model.providerKey}`))
+    console.log(chalk.white(`  4. Click Add, then select `) + chalk.bold(model.modelId) + chalk.white(` from the list.\n`))
+    console.log(chalk.dim(`  📖 Attempting to launch Xcode...`))
+    return spawnCommand(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,8 +36,12 @@ 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 },
+  xcode:             { label: 'Xcode Intelligence',emoji: '🛠️', flag: '--xcode',            color: [20, 126, 251] },
 }
 
 // 📖 Deduplicated emoji order for the "Compatible with" column.
@@ -53,8 +57,12 @@ 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] },
+  { emoji: '🛠️', toolKeys: ['xcode'],                        color: [20, 126, 251] },
 ]
 
 export const TOOL_MODE_ORDER = [
@@ -68,6 +76,10 @@ export const TOOL_MODE_ORDER = [
   'qwen',
   'openhands',
   'amp',
+  'hermes',
+  'continue',
+  'cline',
+  'xcode',
   'rovo',
   'gemini',
 ]