free-coding-models 0.3.64 → 0.3.66

package/CHANGELOG.md

@@ -1,10 +1,15 @@
-## [0.3.64] - 2026-05-06
+## [0.3.66] - 2026-05-16
 
-### Fixed
-
-- **E footer spacing and color** — Fixed the active `E` footer label so the hotkey letter keeps its distinct hotkey color and is separated from the active filter text by a readable space. This makes the active filter state easier to scan in the TUI footer.
+### Added
+- **ForgeCode Integration**: You can now seamlessly launch and install provider endpoints directly into ForgeCode's TOML config. Use the `--forgecode` flag to run it.
+- **GitHub Copilot CLI Support**: Added direct integration with GitHub Copilot CLI (`--copilot`), dynamically setting `COPILOT_*` environment variables for seamless Bring Your Own Key (BYOK) execution.
+- **Security Audit Report**: Added comprehensive security audit documentation from Jules.
 
 ### Changed
+- **NVIDIA NIM Model Catalog Update**: Removed 11 deprecated models and updated GLM to the new `glm5` to keep the catalog fresh and fully operational.
+- **README Optimization**: Refactored README layout and updated image sizes for a cleaner documentation experience.
+- **Testing Architecture Refactoring**: Replaced `agent-tui` with native `tmux` to streamline visual TUI testing.
 
-- **Clearer E filter names** — Renamed the `E` cycle from `Working only` / `Best mode` to `Configured only` / `Usable only`. The behavior is unchanged: `Configured only` keeps configured providers visible, while `Usable only` narrows the table to models with healthy status and usable verdicts.
-- **README TUI key reference** — Updated the `E` shortcut documentation to describe the full visibility cycle: `Active only → Configured only → Usable only`.
+### Fixed
+- **Repository Maintenance**: Cleaned up obsolete tooling artifacts to maintain a bloat-free codebase.
+- **Dependencies**: Bumped internal UI framework tools (React `19.2.6`, Vite `8.0.13`).

package/README.md

@@ -1,36 +1,32 @@
-<table>
-  <tr>
-    <td style="vertical-align: middle; width: 200px;">
-      <img src="logo.webp" alt="free-coding-models logo" width="128"><br><br>
-      <img src="https://img.shields.io/npm/v/free-coding-models?color=3d6b00&label=npm&logo=npm" alt="npm version" width="200"><br>
-      <img src="https://img.shields.io/node/v/free-coding-models?color=3d6b00&logo=node.js" alt="node version" width="200"><br>
-      <img src="https://img.shields.io/npm/l/free-coding-models?color=3d6b00" alt="license" width="200"><br>
-      <img src="https://img.shields.io/badge/models-170+-3d6b00?logo=nvidia" alt="models count" width="200"><br>
-      <img src="https://img.shields.io/badge/providers-16-1a56db" alt="providers count" width="200">
-    </td>
-    <td style="vertical-align: middle;">
-      <h1 style="margin-top: 0;">free-coding-models</h1>
-      <strong>Find the fastest free coding model in seconds</strong><br>
-      Track ~170 models across ~15 trusted free or free-limited AI providers in real time<br><br>
-      <strong>Install Free API endpoints to your favorite AI coding tools:</strong><br>
-      OpenCode CLI / Desktop / WebUI, OpenClaw, Crush, Goose, Aider, Kilo CLI, Qwen Code, OpenHands, Amp, Hermes, Continue, Cline, Xcode, Pi, Rovo, Gemini and more...<br><br>
-      <strong>Use Kimi K2, DeepSeek V3, GPT-OSS, Qwen3, MiniMax M2, GLM, Llama 4, Gemma 4, Devstral and more — for free</strong>
-    </td>
-  </tr>
-</table>
-
+<p align="center">
+  <img src="logo.webp" alt="free-coding-models logo" width="328">
+</p>
 
+<h1 align="center">free-coding-models</h1>
 
+<p align="center">
+  <strong>Find the fastest free coding model in seconds</strong><br>
+  Track ~170 models across ~15 trusted free or free-limited AI providers in real time<br><br>
+  <strong>Install Free API endpoints to your favorite AI coding tools:</strong><br>
+  OpenCode CLI / Desktop / WebUI, OpenClaw, Crush, Goose, Aider, Kilo CLI, Qwen Code, OpenHands, Amp, Hermes, Continue, Cline, Xcode, Pi, Rovo, Gemini and more...<br><br>
+  <strong>Use Kimi K2, DeepSeek V3, GPT-OSS, Qwen3, MiniMax M2, GLM, Llama 4, Gemma 4, Devstral and more — for free</strong>
+</p>
 
 <p align="center">
+  <img src="https://img.shields.io/npm/v/free-coding-models?color=3d6b00&label=npm&logo=npm" alt="npm version" width="200"><br>
+  <img src="https://img.shields.io/node/v/free-coding-models?color=3d6b00&logo=node.js" alt="node version" width="200"><br>
+  <img src="https://img.shields.io/npm/l/free-coding-models?color=3d6b00" alt="license" width="200"><br>
+  <img src="https://img.shields.io/badge/models-170+-3d6b00?logo=nvidia" alt="models count" width="200"><br>
+  <img src="https://img.shields.io/badge/providers-16-1a56db" alt="providers count" width="200">
+</p>
 
 ```bash
 npm install -g free-coding-models
 free-coding-models
 ```
 
-create a free account on one of the [providers](#-list-of-free-ai-providers)
-
+<p align="center">
+  create a free account on one of the <a href="#-list-of-free-ai-providers">providers</a>
 </p>
 
 <p align="center">
@@ -253,6 +249,8 @@ Routing behavior:
 | `--pi` | π Pi |
 | `--rovo` | 🦘 Rovo Dev CLI |
 | `--gemini` | ♊ Gemini CLI |
+| `--copilot` | 🤖 Copilot CLI |
+| `--forgecode` | 🔥 ForgeCode |
 
 Press **`Z`** in the TUI to cycle between tools without restarting.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "free-coding-models",
-  "version": "0.3.64",
+  "version": "0.3.66",
   "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",
@@ -68,10 +68,9 @@
   },
   "devDependencies": {
     "@vitejs/plugin-react": "^6.0.1",
-    "agent-tui": "^1.0.1",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4",
-    "vite": "^8.0.5",
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
+    "vite": "^8.0.13",
     "vite-plus": "^0.1.16"
   }
 }

package/sources.js

@@ -46,15 +46,10 @@ export const nvidiaNim = [
   ['moonshotai/kimi-k2.6',                         'Kimi K2.6',           'S+', '76.8%', '256k'],
   ['deepseek-ai/deepseek-v4-pro',                  'DeepSeek V4 Pro',     'S+', '73.1%', '128k'],
   ['deepseek-ai/deepseek-v4-flash',                'DeepSeek V4 Flash',   'S+', '72.0%', '128k'],
-  ['z-ai/glm4.7',                                  'GLM 4.7',             'S+', '73.8%', '200k'],
-  ['moonshotai/kimi-k2-thinking',                  'Kimi K2 Thinking',    'S+', '71.3%', '256k'], // ⚠️ Deprecation pending
-  ['minimaxai/minimax-m2.5',                       'MiniMax M2.5',        'S+', '80.2%', '200k'],
+  ['z-ai/glm5',                                    'GLM 5',               'S+', '73.8%', '200k'],
   ['stepfun-ai/step-3.5-flash',                    'Step 3.5 Flash',      'S+', '74.4%', '256k'],
   ['qwen/qwen3-coder-480b-a35b-instruct',          'Qwen3 Coder 480B',    'S+', '70.6%', '256k'],
-  ['mistralai/devstral-2-123b-instruct-2512',      'Devstral 2 123B',     'S+', '72.2%', '256k'],
   // ── S tier — SWE-bench Verified 60–70% ──
-  ['moonshotai/kimi-k2-instruct-0905',             'Kimi K2 Instruct 0905', 'S', '65.8%', '256k'],
-  ['moonshotai/kimi-k2-instruct',                  'Kimi K2 Instruct',    'S',  '65.8%', '128k'],
   ['minimaxai/minimax-m2',                         'MiniMax M2',          'S',  '69.4%', '128k'],
   ['qwen/qwen3-next-80b-a3b-thinking',             'Qwen3 80B Thinking',  'S',  '68.0%', '128k'],
   ['qwen/qwen3-next-80b-a3b-instruct',             'Qwen3 80B Instruct',  'S',  '65.0%', '128k'],
@@ -70,13 +65,9 @@ export const nvidiaNim = [
   ['nvidia/nemotron-3-super-120b-a12b',             'Nemotron 3 Super',    'A+', '56.0%', '128k'],
   ['nvidia/nemotron-3-nano-omni-30b-a3b-reasoning','Nemotron 3 Omni',     'A+', '52.0%', '128k'],
   // ── A tier — SWE-bench Verified 40–50% ──
-  ['mistralai/mistral-medium-3-instruct',          'Mistral Medium 3',    'A',  '48.0%', '128k'],
-  ['mistralai/magistral-small-2506',               'Magistral Small',     'A',  '45.0%', '32k'],
   ['nvidia/llama-3.3-nemotron-super-49b-v1.5',     'Nemotron Super 49B',  'A',  '49.0%', '128k'],
   ['nvidia/nemotron-3-nano-30b-a3b',               'Nemotron Nano 30B',   'A',  '43.0%', '128k'],
   ['openai/gpt-oss-20b',                           'GPT OSS 20B',         'A',  '42.0%', '128k'],
-  ['qwen/qwen2.5-coder-32b-instruct',              'Qwen2.5 Coder 32B',   'A',  '46.0%', '32k'],
-  ['meta/llama-3.1-405b-instruct',                 'Llama 3.1 405B',      'A',  '44.0%', '128k'],
   ['google/gemma-4-31b-it',                         'Gemma 4 31B',         'A',  '45.0%', '256k'],
   // ── A- tier — SWE-bench Verified 35–40% ──
   ['meta/llama-3.3-70b-instruct',                  'Llama 3.3 70B',       'A-', '39.5%', '128k'],

package/src/app.js

@@ -274,6 +274,8 @@ export async function runApp(cliArgs, config) {
       pi: cliArgs.piMode,
       rovo: cliArgs.rovoMode,
       gemini: cliArgs.geminiMode,
+      copilot: cliArgs.copilotMode,
+      forgecode: cliArgs.forgecodeMode,
     }
     return flagByMode[toolMode] === true
   })
@@ -776,33 +778,35 @@ export async function runApp(cliArgs, config) {
     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) {
-        r.hidden = false
-        return
-      }
+      const stickyFavorite = state.favoritesPinnedAndSticky && r.isFavorite
       // 📖 CLI-only tools (rovo, gemini) and Zen models don't need traditional API keys —
       // 📖 they authenticate via their own CLI login flow, so "configured only" should never hide them.
       const providerMeta = PROVIDER_METADATA[r.providerKey]
       const noKeyNeeded = providerMeta?.cliOnly || providerMeta?.zenOnly
-// 📖 E toggles "Show only configured & working models":
-// 📖 hide models where provider has no key, or where the health status is noauth/auth_error (but keep timeout and 429)
-const badHealth = r.status === 'noauth' || r.status === 'auth_error'
-const unconfiguredHide = state.hideUnconfiguredModels && !noKeyNeeded && (!getApiKey(state.config, r.providerKey) || badHealth)
-if (unconfiguredHide) {
-  r.hidden = true
-  return
-}
-// 📖 Usable only: only show models with Health UP and Verdict Perfect/Normal/Slow
-if (state.bestModeOnly) {
-  const bmVerdict = getVerdict(r)
-  const bmVerdictOk = ['Perfect', 'Normal', 'Slow'].includes(bmVerdict)
-  const bmHealthOk = r.status === 'up'
-  if (!bmHealthOk || !bmVerdictOk) {
-    r.hidden = true
-    return
-  }
-}
+      // 📖 E toggles "Show only configured & working models":
+      // 📖 hide models where provider has no key, or where the health status is noauth/auth_error (but keep timeout and 429)
+      const badHealth = r.status === 'noauth' || r.status === 'auth_error'
+      const unconfiguredHide = state.hideUnconfiguredModels && !noKeyNeeded && (!getApiKey(state.config, r.providerKey) || badHealth)
+      if (unconfiguredHide) {
+        r.hidden = true
+        return
+      }
+      // 📖 Usable only: only show models with Health UP and Verdict Perfect/Normal/Slow
+      if (state.bestModeOnly) {
+        const bmVerdict = getVerdict(r)
+        const bmVerdictOk = ['Perfect', 'Normal', 'Slow'].includes(bmVerdict)
+        const bmHealthOk = r.status === 'up'
+        if (!bmHealthOk || !bmVerdictOk) {
+          r.hidden = true
+          return
+        }
+      }
+      // 📖 Sticky-favorites mode keeps usable favorites visible regardless of
+      // 📖 tier/provider/text filters, but "Usable only" health still wins above.
+      if (stickyFavorite) {
+        r.hidden = false
+        return
+      }
       // 📖 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)
@@ -1057,12 +1061,17 @@ if (state.bestModeOnly) {
     try {
     refreshAutoPingMode()
     state.frame++
+    // 📖 Re-apply live health filters each frame so "Usable only" truly means
+    // 📖 usable right now: models enter/leave as soon as ping status changes.
+    applyTierFilter()
     // 📖 Cache visible+sorted models each frame so Enter handler always matches the display
     if (!state.settingsOpen && !state.installEndpointsOpen && !state.toolInstallPromptOpen && !state.incompatibleFallbackOpen && !state.recommendOpen && !state.changelogOpen && !state.installedModelsOpen && !state.routerDashboardOpen && !state.commandPaletteOpen) {
       const visible = state.results.filter(r => !r.hidden)
       state.visibleSorted = sortResultsWithPinnedFavorites(visible, state.sortColumn, state.sortDirection, {
         pinFavorites: state.favoritesPinnedAndSticky,
       })
+      if (state.cursor >= state.visibleSorted.length) state.cursor = Math.max(0, state.visibleSorted.length - 1)
+      adjustScrollOffset(state)
     }
     const tableTerminalRows = state.terminalRows
 

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', 'opencode-web', 'openclaw', 'kilo', 'crush', 'goose', 'pi', 'aider', 'qwen', 'openhands', 'amp', 'hermes', 'continue', 'cline', 'fcm_router']
+const INSTALL_TARGET_MODES = ['opencode', 'opencode-desktop', 'opencode-web', 'openclaw', 'kilo', 'crush', 'goose', 'pi', 'aider', 'qwen', 'openhands', 'amp', 'hermes', 'continue', 'cline', 'forgecode', 'fcm_router']
 
 function getDefaultPaths() {
   const home = homedir()
@@ -67,6 +67,7 @@ function getDefaultPaths() {
     aiderConfigPath: join(home, '.aider.conf.yml'),
     ampConfigPath: join(home, '.config', 'amp', 'settings.json'),
     qwenConfigPath: join(home, '.qwen', 'settings.json'),
+    forgeCodeConfigPath: join(home, '.forge', '.forge.toml'),
   }
 }
 
@@ -526,6 +527,65 @@ function installIntoEnvBasedTool(providerKey, models, apiKey, toolMode) {
   return { path: envFilePath, backupPath, providerId, modelCount: models.length }
 }
 
+// 📖 installIntoForgeCode: writes a managed [[providers]] block into ~/.forge/.forge.toml.
+// 📖 ForgeCode uses TOML config with [[providers]] entries for custom OpenAI-compatible endpoints.
+// 📖 Each provider gets one [[providers]] entry with the model catalog noted in comments.
+// 📖 The API key is referenced via an env var so ForgeCode picks it up at runtime.
+function installIntoForgeCode(providerKey, models, apiKey, paths) {
+  const filePath = paths.forgeCodeConfigPath
+  const providerId = getManagedProviderId(providerKey)
+  const secretEnvName = `FCM_${providerKey.toUpperCase().replace(/[^A-Z0-9]+/g, '_')}_API_KEY`
+  const baseUrl = resolveProviderBaseUrl(providerKey)
+
+  if (!baseUrl) {
+    throw new Error(`Cannot resolve base URL for ${getProviderLabel(providerKey)}`)
+  }
+
+  // 📖 Ensure the API key is in env for ForgeCode to use
+  process.env[secretEnvName] = apiKey
+
+  const completionsUrl = baseUrl.endsWith('/chat/completions') ? baseUrl : `${baseUrl}/chat/completions`
+
+  // 📖 Read existing content
+  let content = ''
+  if (existsSync(filePath)) {
+    content = readFileSync(filePath, 'utf8')
+  }
+
+  // 📖 Remove any previous FCM-managed provider block for this provider
+  const markerStart = `# >>> FCM managed provider: ${providerId}`
+  const markerEnd = `# <<< FCM managed provider: ${providerId}`
+  const markerRegex = new RegExp(
+    `\\n?${markerStart.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}[\\s\\S]*?${markerEnd.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\n?`,
+    'g'
+  )
+  content = content.replace(markerRegex, '\n')
+
+  // 📖 Build a fresh [[providers]] TOML block with model catalog comments
+  const modelComments = models.map(m => `# 📖 Model: ${m.label} (${m.modelId}) — ${m.tier}`).join('\n')
+  const providerBlock = [
+    '',
+    markerStart,
+    `# 📖 Provider: ${getManagedProviderLabel(providerKey)} (${models.length} models)`,
+    modelComments,
+    '[[providers]]',
+    `id = "${providerId}"`,
+    `url = "${completionsUrl}"`,
+    `api_key_vars = "${secretEnvName}"`,
+    'response_type = "OpenAI"',
+    'auth_methods = ["api_key"]',
+    markerEnd,
+  ].join('\n')
+
+  content = content.trimEnd() + '\n' + providerBlock + '\n'
+
+  ensureDirFor(filePath)
+  const backupPath = backupIfExists(filePath)
+  writeFileSync(filePath, content)
+
+  return { path: filePath, backupPath, providerId, modelCount: models.length }
+}
+
 // 📖 installIntoFcmRouter: adds provider endpoints to the running FCM Router daemon
 // 📖 via the /sets API so the router can use them for failover routing.
 // 📖 Uses the daemon's expected schema: { provider, model, priority } per model entry.
@@ -605,6 +665,8 @@ export function installProviderEndpoints(config, providerKey, toolMode, options
     installResult = installIntoEnvBasedTool(providerKey, models, apiKey, canonicalToolMode, paths)
   } else if (canonicalToolMode === 'fcm_router') {
     installResult = installIntoFcmRouter(providerKey, models, apiKey)
+  } else if (canonicalToolMode === 'forgecode') {
+    installResult = installIntoForgeCode(providerKey, models, apiKey, paths)
   } else {
     throw new Error(`Unsupported install target: ${toolMode}`)
   }

package/src/key-handler.js

@@ -415,7 +415,7 @@ export function createKeyHandler(ctx) {
 
   async function launchSelectedModel(selected, options = {}) {
     const { uiAlreadyStopped = false } = options
-    userSelected = { modelId: selected.modelId, label: selected.label, tier: selected.tier, providerKey: selected.providerKey }
+    userSelected = { modelId: selected.modelId, label: selected.label, tier: selected.tier, providerKey: selected.providerKey, ctx: selected.ctx }
 
     if (!uiAlreadyStopped) {
       readline.emitKeypressEvents(process.stdin)

package/src/tool-bootstrap.js

@@ -304,6 +304,28 @@ export const TOOL_BOOTSTRAP_METADATA = {
       },
     },
   },
+  copilot: {
+    binary: 'copilot',
+    docsUrl: 'https://github.com/github/copilot',
+    install: {
+      default: {
+        shellCommand: 'npm install -g @github/copilot',
+        summary: 'Install GitHub Copilot CLI globally via npm.',
+        note: 'After installation, run `copilot` to authenticate with GitHub.',
+      },
+    },
+  },
+  forgecode: {
+    binary: 'forge',
+    docsUrl: 'https://forgecode.dev',
+    install: {
+      default: {
+        shellCommand: 'npm install -g forgecode',
+        summary: 'Install ForgeCode globally via npm.',
+        note: 'After installation, run `forge` to start. Use `forge provider login` to set up credentials.',
+      },
+    },
+  },
 }
 
 export function getToolBootstrapMeta(mode) {

package/src/tool-launchers.js

@@ -20,6 +20,7 @@
  *   📖 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
+ *   📖 ForgeCode: writes [[providers]] TOML block into ~/.forge/.forge.toml + sets [session] defaults
  *
  * @functions
  *   → `resolveLauncherModelId` — choose the provider-specific id for a launch
@@ -64,6 +65,19 @@ function ensureDir(filePath) {
   if (!existsSync(dir)) mkdirSync(dir, { recursive: true })
 }
 
+// 📖 Parse a context window string (e.g. "128k", "1M", "32k") to token count number.
+function parseCtxToTokens(ctx) {
+  if (!ctx || typeof ctx !== 'string') return null
+  const match = ctx.match(/^\s*(\d+(?:\.\d+)?)\s*([kKmM]?)\s*$/)
+  if (!match) return null
+  const num = parseFloat(match[1])
+  const suffix = match[2].toLowerCase()
+  // 📖 LLM token counts use binary (1024), not decimal (1000).
+  if (suffix === 'k') return Math.round(num * 1024)
+  if (suffix === 'm') return Math.round(num * 1024 * 1024)
+  return Math.round(num)
+}
+
 function getDefaultToolPaths(homeDir = homedir()) {
   return {
     aiderConfigPath: join(homeDir, '.aider.conf.yml'),
@@ -79,6 +93,7 @@ function getDefaultToolPaths(homeDir = homedir()) {
     hermesConfigPath: join(homeDir, '.hermes', 'config.yaml'),
     continueConfigPath: join(homeDir, '.continue', 'config.yaml'),
     clineConfigPath: join(homeDir, '.cline', 'globalState.json'),
+    forgeCodeConfigPath: join(homeDir, '.forge', '.forge.toml'),
   }
 }
 
@@ -504,6 +519,86 @@ function writeHermesConfig(model, apiKey, baseUrl, paths = getDefaultToolPaths()
   return { filePath: configPath, backupPath }
 }
 
+// 📖 writeForgeCodeConfig — write a managed [[providers]] block into ~/.forge/.forge.toml.
+// 📖 ForgeCode uses TOML config with [[providers]] entries for custom OpenAI-compatible endpoints.
+// 📖 Strategy:
+// 📖   1. Read the existing .forge.toml (if any)
+// 📖   2. Strip any previous FCM-managed provider block (delimited by comments)
+// 📖   3. Append a fresh [[providers]] block with the selected model's provider details
+// 📖   4. Update or insert [session] defaults to auto-select the model on next `forge` launch
+// 📖 The provider ID uses the `fcm-{providerKey}` namespace to avoid clobbering user-defined providers.
+// 📖 The API key is referenced via an env var (FCM_{PROVIDER}_API_KEY) and also set in the process env.
+function writeForgeCodeConfig(model, apiKey, baseUrl, providerKey, paths = getDefaultToolPaths()) {
+  const filePath = paths.forgeCodeConfigPath
+  const backupPath = backupIfExists(filePath)
+  const providerId = `fcm-${providerKey}`
+  const providerLabel = PROVIDER_METADATA[providerKey]?.label || sources[providerKey]?.name || providerKey
+  const secretEnvName = `FCM_${providerKey.toUpperCase().replace(/[^A-Z0-9]+/g, '_')}_API_KEY`
+
+  // 📖 Ensure the API key is available in env for ForgeCode to pick up
+  process.env[secretEnvName] = apiKey
+
+  // 📖 Build the provider's chat completions URL
+  const completionsUrl = baseUrl
+    ? (baseUrl.endsWith('/chat/completions') ? baseUrl : `${baseUrl}/chat/completions`)
+    : ''
+
+  // 📖 Read existing TOML content (if any)
+  let content = ''
+  if (existsSync(filePath)) {
+    content = readFileSync(filePath, 'utf8')
+  }
+
+  // 📖 Remove any previous FCM-managed provider block (between marker comments)
+  const markerStart = `# >>> FCM managed provider: ${providerId}`
+  const markerEnd = `# <<< FCM managed provider: ${providerId}`
+  const markerRegex = new RegExp(
+    `\\n?${markerStart.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}[\\s\\S]*?${markerEnd.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\n?`,
+    'g'
+  )
+  content = content.replace(markerRegex, '\n')
+
+  // 📖 Build a fresh [[providers]] TOML block
+  const providerBlock = [
+    '',
+    markerStart,
+    '[[providers]]',
+    `id = "${providerId}"`,
+    `url = "${completionsUrl}"`,
+    `api_key_vars = "${secretEnvName}"`,
+    'response_type = "OpenAI"',
+    'auth_methods = ["api_key"]',
+    markerEnd,
+  ].join('\n')
+
+  content = content.trimEnd() + '\n' + providerBlock + '\n'
+
+  // 📖 Update or insert [session] defaults so ForgeCode auto-selects this model
+  const sessionProviderLine = `provider_id = "${providerId}"`
+  const sessionModelLine = `model_id = "${model.modelId}"`
+
+  if (/^\[session\]/m.test(content)) {
+    // 📖 Replace existing provider_id/model_id under [session]
+    if (/^provider_id\s*=/m.test(content)) {
+      content = content.replace(/^provider_id\s*=.*$/m, sessionProviderLine)
+    } else {
+      content = content.replace(/^\[session\]/m, `[session]\n${sessionProviderLine}`)
+    }
+    if (/^model_id\s*=/m.test(content)) {
+      content = content.replace(/^model_id\s*=.*$/m, sessionModelLine)
+    } else {
+      content = content.replace(/^\[session\]/m, `[session]\n${sessionModelLine}`)
+    }
+  } else {
+    // 📖 No [session] block — append one
+    content = content.trimEnd() + '\n\n[session]\n' + sessionProviderLine + '\n' + sessionModelLine + '\n'
+  }
+
+  ensureDir(filePath)
+  writeFileSync(filePath, content)
+  return { filePath, backupPath }
+}
+
 // 📖 restartHermesGateway — restart the Hermes messaging gateway after config changes.
 // 📖 Non-blocking: if gateway is not running, this is a no-op.
 function restartHermesGateway() {
@@ -833,6 +928,45 @@ export function prepareExternalToolLaunch(mode, model, config, options = {}) {
     }
   }
 
+  if (mode === 'copilot') {
+    // 📖 copilot: set BYOK env vars so copilot uses the selected provider/model
+    const copilotModelId = resolveLauncherModelId(model)
+    env.COPILOT_PROVIDER_BASE_URL = baseUrl
+    env.COPILOT_MODEL = copilotModelId
+    if (apiKey) env.COPILOT_PROVIDER_API_KEY = apiKey
+
+    // 📖 Set context window limits from model data
+    const promptTokens = parseCtxToTokens(model.ctx)
+    if (promptTokens) env.COPILOT_PROVIDER_MAX_PROMPT_TOKENS = String(promptTokens)
+    // 📖 16k max output as a safety cap — most S+/S tier coding models
+    // 📖 support 16-32k output. copilot falls back to built-in model
+    // 📖 catalog defaults when a model ID is recognized.
+    env.COPILOT_PROVIDER_MAX_OUTPUT_TOKENS = '16384'
+
+    return {
+      command: 'copilot',
+      args: [],
+      env,
+      apiKey,
+      baseUrl,
+      meta,
+      configArtifacts: [],
+    }
+  }
+
+  if (mode === 'forgecode') {
+    const result = writeForgeCodeConfig(model, apiKey, baseUrl, model.providerKey, paths)
+    return {
+      command: 'forge',
+      args: [],
+      env,
+      apiKey,
+      baseUrl,
+      meta,
+      configArtifacts: [{ path: result.filePath, backupPath: result.backupPath, label: 'config' }],
+    }
+  }
+
   return {
     blocked: true,
     exitCode: 1,
@@ -934,6 +1068,16 @@ export async function startExternalTool(mode, model, config) {
     return spawnCommand(resolveLaunchCommand(mode, launchPlan.command), launchPlan.args, launchPlan.env)
   }
 
+  if (mode === 'copilot') {
+    console.log(chalk.dim(`  📖 Copilot CLI configured with model: ${model.modelId}`))
+    return spawnCommand(resolveLaunchCommand(mode, launchPlan.command), launchPlan.args, launchPlan.env)
+  }
+
+  if (mode === 'forgecode') {
+    console.log(chalk.dim(`  📖 ForgeCode configured with model: ${model.modelId}`))
+    return spawnCommand(resolveLaunchCommand(mode, launchPlan.command), launchPlan.args, launchPlan.env)
+  }
+
   console.log(chalk.red(`  X Unsupported external tool mode: ${mode}`))
   return 1
 }

package/src/tool-metadata.js

@@ -46,6 +46,8 @@ export const TOOL_METADATA = {
   jcode:             { label: 'jcode',              emoji: '🪼', flag: '--jcode',             color: [255, 140, 0]  },
   xcode:             { label: 'Xcode Intelligence',emoji: '🛠️', flag: '--xcode',            color: [20, 126, 251] },
   fcm_router:        { label: 'FCM Router',        emoji: '🧭', flag: '--fcm-router',        color: [80, 200, 120] },
+  copilot:           { label: 'Copilot CLI',       emoji: '🤖', flag: '--copilot',          color: [200, 220, 255] },
+  forgecode:         { label: 'ForgeCode',         emoji: '🔥', flag: '--forgecode',        color: [255, 120, 50] },
 }
 
 // 📖 Deduplicated emoji order for the "Compatible with" column.
@@ -64,13 +66,14 @@ export const COMPAT_COLUMN_SLOTS = [
   { 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: ['cline'],                        color: [100, 220, 180] },
   { emoji: '🧭', toolKeys: ['fcm_router'],                  color: [80, 200, 120] },
   { emoji: '🦘', toolKeys: ['rovo'],                        color: [148, 163, 184] },
   { emoji: '♊', toolKeys: ['gemini'],                       color: [66, 165, 245] },
   { emoji: '🪼', toolKeys: ['jcode'],                        color: [255, 140, 0]  },
   { emoji: '🛠️', toolKeys: ['xcode'],                        color: [20, 126, 251] },
-  { emoji: '🧭', toolKeys: ['fcm_router'],                  color: [80, 200, 120] },
+  { emoji: '🤖', toolKeys: ['copilot'],                      color: [200, 220, 255] },
+  { emoji: '🔥', toolKeys: ['forgecode'],                    color: [255, 120, 50] },
 ]
 
 export const TOOL_MODE_ORDER = [
@@ -94,6 +97,8 @@ export const TOOL_MODE_ORDER = [
   'fcm_router',
   'rovo',
   'gemini',
+  'copilot',
+  'forgecode',
 ]
 
 export function getToolMeta(mode) {

package/src/utils.js

@@ -389,14 +389,16 @@ export function findBestModel(results) {
 //   - API key: first positional arg that does not look like a CLI flag (e.g., "nvapi-xxx")
 //   - Boolean flags: --best, --fiable, --opencode, --opencode-desktop, --opencode-web, --openclaw,
 //     --aider, --crush, --goose, --qwen, --kilo,
-//     --openhands, --amp, --pi, --daemon, --daemon-bg, --daemon-stop,
+//     --openhands, --amp, --pi, --rovo, --hermes, --continue, --cline,
+//     --xcode, --gemini, --jcode, --copilot, --forgecode,
+//     --daemon, --daemon-bg, --daemon-stop,
 //     --daemon-status, --no-telemetry, --json, --help/-h (case-insensitive)
 //   - Value flag: --tier <letter> (the next non-flag arg is the tier value)
 //
 // Returns:
 //   { apiKey, bestMode, fiableMode, openCodeMode, openCodeDesktopMode, openCodeWebMode, openClawMode,
 //     aiderMode, crushMode, gooseMode, qwenMode, openHandsMode, ampMode,
-//     piMode, jcodeMode, noTelemetry, jsonMode, helpMode, tierFilter }
+//     piMode, jcodeMode, copilotMode, forgecodeMode, noTelemetry, jsonMode, helpMode, tierFilter }
 //
 // 📖 Note: apiKey may be null here — the main CLI falls back to env vars and saved config.
 export function parseArgs(argv) {
@@ -471,6 +473,8 @@ export function parseArgs(argv) {
   const xcodeMode = flags.includes('--xcode')
   const geminiMode = flags.includes('--gemini')
   const jcodeMode = flags.includes('--jcode')
+  const copilotMode = flags.includes('--copilot')
+  const forgecodeMode = flags.includes('--forgecode')
   const noTelemetry = flags.includes('--no-telemetry')
   const devMode = flags.includes('--dev')
   const jsonMode = flags.includes('--json')
@@ -528,6 +532,8 @@ export function parseArgs(argv) {
     rovoMode,
     geminiMode,
     jcodeMode,
+    copilotMode,
+    forgecodeMode,
     noTelemetry,
     jsonMode,
     helpMode,