free-coding-models 0.5.95 → 0.5.97

package/src/core/router-v2/tui-dashboard.js

@@ -49,6 +49,7 @@ import { discoverRouterV2Port, testModelViaRouter, testSetViaRouter } from './be
 // 📖 After the merge, the v2 engine lives in the MAIN router daemon: all
 // discovery and lifecycle calls target the historical daemon paths/ports.
 import { getRouterPidPath, getRouterPortPath, getRouterPortRange } from '../router-daemon.js'
+import { t } from '../i18n/index.js'
 
 export const ROUTER_V2_DASHBOARD_POLL_INTERVAL_MS = 2000
 export const ROUTER_V2_DASHBOARD_FETCH_TIMEOUT_MS = 1500
@@ -429,15 +430,15 @@ function formatDurationV2(seconds) {
 
 function stateBadgeV2(modelState) {
   switch (modelState) {
-    case 'CLOSED': return { text: '✅ UP', color: themeColors.success }
-    case 'DEGRADED': return { text: '🟠 DEGRADED', color: themeColors.warningBold }
-    case 'HALF_OPEN': return { text: '🔁 PROBING', color: themeColors.warning }
-    case 'OPEN': return { text: '⛔ OPEN', color: themeColors.error }
-    case 'AUTH_ERROR': return { text: '🔐 AUTH FAIL', color: themeColors.errorBold }
-    case 'QUOTA_PAUSED': return { text: '🔥 QUOTA', color: themeColors.warningBold }
-    case 'STALE': return { text: '👻 STALE', color: themeColors.dim }
-    case 'UNSUPPORTED': return { text: '🚫 UNSUPPORTED', color: themeColors.dim }
-    default: return { text: '⏳ PENDING', color: themeColors.dim }
+    case 'CLOSED': return { text: `✅ ${t('dashboard.working').toUpperCase()}`, color: themeColors.success }
+    case 'DEGRADED': return { text: `🟠 ${t('router.circuit.degraded').toUpperCase()}`, color: themeColors.warningBold }
+    case 'HALF_OPEN': return { text: `🔁 ${t('router.circuit.probing').toUpperCase()}`, color: themeColors.warning }
+    case 'OPEN': return { text: `⛔ ${t('router.circuit.down').toUpperCase()}`, color: themeColors.error }
+    case 'AUTH_ERROR': return { text: `🔐 ${t('router.circuit.authError').toUpperCase()}`, color: themeColors.errorBold }
+    case 'QUOTA_PAUSED': return { text: `🔥 ${t('router.circuit.quotaPaused').toUpperCase()}`, color: themeColors.warningBold }
+    case 'STALE': return { text: `👻 ${t('router.circuit.deprecated').toUpperCase()}`, color: themeColors.dim }
+    case 'UNSUPPORTED': return { text: `🚫 ${t('router.circuit.unsupported').toUpperCase()}`, color: themeColors.dim }
+    default: return { text: `⏳ ${t('dashboard.pending').toUpperCase()}`, color: themeColors.dim }
   }
 }
 
@@ -489,17 +490,17 @@ export function renderRouterV2Dashboard(state, deps = {}) {
   // ── Quick Setup ─────────────────────────────────────────────────────────────
   const { defaultPort } = getRouterPortRange()
   const port = state.routerV2Port || defaultPort
-  lines.push(`  ${themeColors.textBold('Quick Setup')} ${themeColors.dim('(beta)')} ${themeColors.dim('- point your coding tool at v2')}`)
+  lines.push(`  ${themeColors.textBold(t('router.quickSetup'))} ${themeColors.dim(`(${t('router.v2.beta')})`)} ${themeColors.dim(`— ${t('router.v2.pointToolAtV2')}`)}`)
   lines.push(`  ${themeColors.dim('URL')}     ${themeColors.infoBold(`http://localhost:${port}/v1`)}   ${themeColors.dim('Anthropic:')} ${themeColors.infoBold(`http://localhost:${port}`)}  ${themeColors.dim('(POST /v1/messages)')}`)
-  lines.push(`  ${themeColors.dim('Model')}   ${themeColors.infoBold('fcm')}  ${themeColors.dim('or pin one:')} ${themeColors.infoBold('fcm:@provider/model')}`)
+  lines.push(`  ${themeColors.dim(t('router.model'))}   ${themeColors.infoBold('fcm')}  ${themeColors.dim(t('router.v2.orPinOne'))} ${themeColors.infoBold('fcm:@provider/model')}`)
   lines.push(`  ${themeColors.dim('API Key')} ${themeColors.infoBold('fcm-local')}`)
   if (isRunning) {
-    lines.push(`  ${themeColors.dim('Uptime')}  ${themeColors.success(formatDurationV2(toFiniteNumber(stats?.uptimeSeconds, 0)))}  ${themeColors.dim('Routed:')} ${themeColors.info(String(toFiniteNumber(stats?.requestsRouted, 0)))}  ${themeColors.dim('Failover rate:')} ${themeColors.info(`${Math.round(toFiniteNumber(stats?.history?.failover_rate, 0) * 100)}%`)}`)
+    lines.push(`  ${themeColors.dim(t('router.uptime'))}  ${themeColors.success(formatDurationV2(toFiniteNumber(stats?.uptimeSeconds, 0)))}  ${themeColors.dim(`${t('router.requests')}:`)} ${themeColors.info(String(toFiniteNumber(stats?.requestsRouted, 0)))}  ${themeColors.dim(`${t('router.v2.failoverRate')}:`)} ${themeColors.info(`${Math.round(toFiniteNumber(stats?.history?.failover_rate, 0) * 100)}%`)}`)
   }
   lines.push(`  ${separator}`)
 
   // ── Fallback chain with live breaker states ─────────────────────────────────
-  lines.push(`  ${themeColors.textBold('Fallback Chain')} ${themeColors.dim('- routing order for the next request')}`)
+  lines.push(`  ${themeColors.textBold(t('router.v2.fallbackChain'))} ${themeColors.dim(`— ${t('router.v2.exactOrder')}`)}`)
   const routingOrder = Array.isArray(stats?.routingOrder) ? stats.routingOrder : []
   const models = Array.isArray(stats?.models) ? stats.models : []
   const healthByKey = new Map(models.map((m) => [m.key, m]))
@@ -507,11 +508,11 @@ export function renderRouterV2Dashboard(state, deps = {}) {
   const cursor = state.routerV2CursorIndex ?? 0
 
   if (!isRunning) {
-    lines.push(`  ${themeColors.dim('Start the daemon to see the live chain.')}`)
+    lines.push(`  ${themeColors.dim(t('router.v2.startToSeeChain'))}`)
   } else if (routingOrder.length === 0) {
-    lines.push(`  ${themeColors.warning('No routeable candidates right now (keys missing or all models failing).')}`)
+    lines.push(`  ${themeColors.warning(t('router.v2.emptyCandidates'))}`)
   } else {
-    lines.push(`   ${themeColors.dim(padEndDisplay('PRI', 4))} ${themeColors.dim(padEndDisplay('MODEL', 44))} ${themeColors.dim(padEndDisplay('STATE', 15))} ${themeColors.dim(padEndDisplay('UPTIME', 7))} ${themeColors.dim(padEndDisplay('V2 TEST', 12))} ${themeColors.dim('LAST ERROR')}`)
+    lines.push(`   ${themeColors.dim(padEndDisplay('PRI', 4))} ${themeColors.dim(padEndDisplay(t('router.model'), 44))} ${themeColors.dim(padEndDisplay(t('router.state'), 15))} ${themeColors.dim(padEndDisplay(t('router.uptime'), 7))} ${themeColors.dim(padEndDisplay('V2 ' + t('router.v2.testViaRouter'), 12))} ${themeColors.dim(t('router.v2.lastError'))}`)
     const maxRows = Math.max(1, routingOrder.length)
     routingOrder.forEach((entry, i) => {
       const health = healthByKey.get(entry.key)
@@ -535,21 +536,21 @@ export function renderRouterV2Dashboard(state, deps = {}) {
 
   // ── Recent requests WITH fallback chains (the v1 gap) ───────────────────────
   lines.push('')
-  lines.push(`  ${themeColors.textBold('Request Chains')} ${themeColors.dim('- every attempt, skips and the winner')}`)
+  lines.push(`  ${themeColors.textBold(t('router.v2.requestChains'))} ${themeColors.dim(`— ${t('router.v2.attemptsHint')}`)}`)
   const historyEntries = Array.isArray(state.routerV2History?.entries) ? state.routerV2History.entries : []
   if (!isRunning) {
-    lines.push(`  ${themeColors.dim('No history (daemon stopped).')}`)
+    lines.push(`  ${themeColors.dim(t('router.v2.noHistory'))}`)
   } else if (historyEntries.length === 0) {
-    lines.push(`  ${themeColors.dim('No requests routed yet')}`)
+    lines.push(`  ${themeColors.dim(t('router.noRequests'))}`)
   } else {
     for (const entry of historyEntries.slice(0, 6)) {
       const atMs = Date.parse(entry.at)
       const time = Number.isFinite(atMs) ? new Date(atMs).toLocaleTimeString() : '-'
       const outcome = entry.outcome === 'served'
-        ? themeColors.success('served')
+        ? themeColors.success(t('router.v2.outcome.served'))
         : entry.outcome === 'client_aborted'
-          ? themeColors.dim('aborted')
-          : themeColors.error(entry.outcome || 'failed')
+          ? themeColors.dim(t('router.v2.outcome.aborted'))
+          : themeColors.error(t('router.v2.outcome.failed'))
       const chain = attemptChainLabel(entry)
       const skips = Array.isArray(entry.skipped) && entry.skipped.length > 0
         ? ` ${themeColors.dim(`[skips: ${entry.skipped.map((s) => s.reason).join(', ')}]`)}`
@@ -572,7 +573,7 @@ export function renderRouterV2Dashboard(state, deps = {}) {
       `🔐 auth ${stateCounts.AUTH_ERROR ?? 0}`,
       `🔥 quota ${stateCounts.QUOTA_PAUSED ?? 0}`,
     ]
-    lines.push(`  ${themeColors.textBold('Models:')} ${chips.map((c) => themeColors.dim(c)).join('  ')}`)
+    lines.push(`  ${themeColors.textBold(`${t('router.models')}:`)} ${chips.map((c) => themeColors.dim(c)).join('  ')}`)
     const pauses = Array.isArray(stats?.quotaPauses) ? stats.quotaPauses : []
     if (pauses.length > 0) {
       for (const pause of pauses.slice(0, 3)) {
@@ -592,7 +593,7 @@ export function renderRouterV2Dashboard(state, deps = {}) {
   const isStopped = !isRunning && !isLoading
   const cursorBase = Math.max(1, routingOrder.length)
   const startBtnCursor = cursorBase
-  const startBtnText = isStopped ? '▶ Start Router Daemon (v2 engine)' : '⏹ Stop Router Daemon (v2 engine)'
+  const startBtnText = isStopped ? `▶ ${t('router.start')} (v2)` : `⏹ ${t('router.stop')} (v2)`
   const startBtnRow = `  [ ${startBtnText} ]`
   lines.push(cursor === startBtnCursor
     ? themeColors.bgCursor(startBtnRow + ' '.repeat(Math.max(0, width - displayWidth(startBtnRow) - 3)))
@@ -616,7 +617,7 @@ export function renderRouterV2Dashboard(state, deps = {}) {
   lines.push('')
   lines.push(`  ${separator}`)
   const probeMode = stats?.probeMode || 'balanced'
-  lines.push(`  ${themeColors.hotkey('↑↓')} ${themeColors.dim('Navigate')}  ${themeColors.dim('•')}  ${themeColors.hotkey('T')} ${themeColors.dim('Test via router')}  ${themeColors.dim('•')}  ${themeColors.hotkey('S')} ${themeColors.dim(isStopped ? 'Start' : 'Stop')}  ${themeColors.dim('•')}  ${themeColors.hotkey('I')} ${themeColors.dim(`Probes: ${probeMode}`)}  ${themeColors.dim('•')}  ${themeColors.hotkey('C')} ${themeColors.dim('Clear history')}  ${themeColors.dim('•')}  ${themeColors.hotkey('Esc')} ${themeColors.dim('Back')}`)
+  lines.push(`  ${themeColors.hotkey('↑↓')} ${themeColors.dim(t('settings.navigate'))}  ${themeColors.dim('•')}  ${themeColors.hotkey('T')} ${themeColors.dim(t('router.v2.testViaRouter'))}  ${themeColors.dim('•')}  ${themeColors.hotkey('S')} ${themeColors.dim(isStopped ? t('router.start') : t('router.stop'))}  ${themeColors.dim('•')}  ${themeColors.hotkey('I')} ${themeColors.dim(`${t('router.v2.probes')}: ${probeMode}`)}  ${themeColors.dim('•')}  ${themeColors.hotkey('C')} ${themeColors.dim(t('router.clearHistory'))}  ${themeColors.dim('•')}  ${themeColors.hotkey('Esc')} ${themeColors.dim(t('common.back'))}`)
   lines.push(`  ${themeColors.dim('BETA: the v2 engine now powers the main router daemon. Ctrl+T tests the selected table model, Ctrl+Shift+T tests all visible models through the router.')}`)
 
   const { visible, offset } = sliceOverlayLines(lines, state.routerV2ScrollOffset || 0, state.terminalRows || 24)
@@ -628,5 +629,5 @@ export function renderRouterV2Dashboard(state, deps = {}) {
 function compactTextV2(value, width) {
   const text = String(value ?? '')
   if (displayWidth(text) <= width) return themeColors.dim(text)
-  return themeColors.dim(`${text.slice(0, Math.max(1, width - 1))}…`)
+  return themeColors.dim(truncateAnsiWidth(text, width, { ellipsis: '…' }))
 }

package/src/core/shell-env.js

@@ -41,6 +41,7 @@ import { join } from 'node:path'
 import * as readline from 'node:readline'
 import chalk from 'chalk'
 import { ENV_VAR_NAMES } from './provider-metadata.js'
+import { isPureEnvPlaceholder } from './utils.js'
 import { saveConfig } from './config.js'
 
 // 📖 Unique marker used to identify the source line we inject into shell rc files.
@@ -126,6 +127,11 @@ export function buildEnvContent(config, shell) {
     const value = Array.isArray(rawValue) ? rawValue[0] : rawValue
     if (!value || typeof value !== 'string') continue
 
+    // 📖 Issue #196: a config value of "${MY_KEY}" means the key comes from the
+    // 📖 user's own environment. Never export the literal placeholder into the
+    // 📖 rc/env file, it would clobber the real variable on every shell start.
+    if (isPureEnvPlaceholder(value)) continue
+
     const safeValue = value.replace(/'/g, "'\\''")
 
     if (isFish) {

package/src/core/utils.js

@@ -1168,3 +1168,25 @@ export function formatResultsAsJSON(results, sortBy = 'avg', limit = 0) {
 
   return JSON.stringify(formatted, null, 2)
 }
+
+// 📖 Issue #196: ${VAR} placeholder support inside config apiKeys values.
+// 📖 The config file on disk keeps the literal placeholder, so saveConfig never
+// 📖 writes the resolved secret back; expansion happens only in memory, at the
+// 📖 moment a consumer reads the key (getApiKey, tool env sync). Only the
+// 📖 explicit ${NAME} form is recognized, so a literal key containing a bare
+// 📖 "$" is never mangled. An unset variable leaves the placeholder untouched:
+// 📖 probes will fail auth, which is the honest signal that something is off.
+export function resolveEnvPlaceholderValue(value) {
+  if (typeof value !== 'string') return value
+  return value.replace(/\$\{([A-Za-z_][A-Za-z0-9_]*)\}/g, (placeholder, name) => {
+    const resolved = process.env[name]
+    return typeof resolved === 'string' ? resolved : placeholder
+  })
+}
+
+// 📖 True when the value is nothing but one ${VAR} reference. Used by the
+// 📖 shell rc/env generator to skip entries the user's own environment already
+// 📖 provides (exporting the literal placeholder would clobber the real var).
+export function isPureEnvPlaceholder(value) {
+  return typeof value === 'string' && /^\$\{[A-Za-z_][A-Za-z0-9_]*\}$/.test(value.trim())
+}

package/src/tui/app.js

@@ -95,6 +95,7 @@ import { randomUUID } from 'crypto'
 import { MODELS, sources } from '../../sources.js'
 import { getAvg, getVerdict, getUptime, getP95, getJitter, getStabilityScore, sortResults, filterByTier, parseArgs, TIER_ORDER, VERDICT_ORDER, TIER_LETTER_MAP, scoreModelForTask, getTopRecommendations, TASK_TYPES, PRIORITY_TYPES, CONTEXT_BUDGETS, formatResultsAsJSON } from '../core/utils.js'
 import { loadConfig, saveConfig, getApiKey, resolveApiKeys, addApiKey, removeApiKey, isProviderEnabled, persistApiKeysForProvider } from '../core/config.js'
+import { setLocale } from '../core/i18n/index.js'
 import { buildMergedModels } from '../core/model-merger.js'
 import { loadOpenCodeConfig, saveOpenCodeConfig } from '../core/opencode-config.js'
 import { usageForRow as _usageForRow } from '../core/usage-reader.js'
@@ -256,6 +257,7 @@ const LOCAL_VERSION = pkg.version
 // 📖 OpenCode helpers are imported from ../src/opencode.js
 
 export async function runApp(cliArgs, config, startupOptions = {}) {
+  setLocale(config.settings?.language || 'en')
   // 📖 t4: prime the sync extended-benchmark stats so the footer chip is
   // 📖 accurate on the first render (no async, no network — just a sync read).
   ensureBenchStatsLoaded()

package/src/tui/cli-help.js

@@ -19,6 +19,7 @@
  */
 
 import { getToolModeOrder, getToolMeta } from '../core/tool-metadata.js'
+import { t } from '../core/i18n/index.js'
 
 const ANALYSIS_FLAGS = [
   { flag: '--best', description: 'Show only top tiers (A+, S, S+)' },
@@ -71,6 +72,29 @@ const EXAMPLES = [
   "free-coding-models --json | jq '.[0]'",
 ]
 
+const FLAG_DESCRIPTION_KEYS = Object.freeze({
+  '--best': 'cli.flag.best', '--fiable': 'cli.flag.fiable', '--json': 'cli.flag.json',
+  '--tier <S|A|B|C>': 'cli.flag.tier', '--recommend': 'cli.flag.recommend',
+  '--premium': 'cli.flag.premium', '--sort <column>': 'cli.flag.sort',
+  '--desc | --asc': 'cli.flag.direction', '--origin <provider>': 'cli.flag.origin',
+  '--ping-interval <ms>': 'cli.flag.pingInterval', '--hide-unconfigured': 'cli.flag.hideUnconfigured',
+  '--show-unconfigured': 'cli.flag.showUnconfigured', '--reprobe, --no-cache': 'cli.flag.reprobe',
+  '--probe-ttl <ms>': 'cli.flag.probeTtl', '--show-broken': 'cli.flag.showBroken',
+  '--check-drift': 'cli.flag.checkDrift', '--drift-threshold <N>': 'cli.flag.driftThreshold',
+  'web | --web | --gui': 'cli.flag.web', 'playground | --playground': 'cli.flag.playground',
+  '--daemon': 'cli.flag.daemon', '--daemon-bg': 'cli.flag.daemonBg', '--daemon-status': 'cli.flag.daemonStatus',
+  '--daemon-stop': 'cli.flag.daemonStop', '--router-v2': 'cli.flag.routerV2', '--router-v2-bg': 'cli.flag.routerV2Bg',
+  '--router-v2-status': 'cli.flag.routerV2Status', '--router-v2-stop': 'cli.flag.routerV2Stop',
+  '--sync-set [name]': 'cli.flag.syncSet', '--config-dir <dir>': 'cli.flag.configDir',
+  '--fix-permissions, --yes, -y': 'cli.flag.fixPermissions', '--no-telemetry': 'cli.flag.noTelemetry',
+  '--help, -h': 'cli.flag.help',
+})
+
+function entryDescription(entry) {
+  const key = FLAG_DESCRIPTION_KEYS[entry.flag]
+  return key ? t(key) : entry.description
+}
+
 /**
  * 📖 buildHowTheRouterWorks — a single-source explanation of the router
  * 📖 internals (circuit breaker, probe mechanism, pre-prompt) that the
@@ -83,10 +107,10 @@ export function buildHowTheRouterWorksLines({ chalk = null, indent = '' } = {})
   const body = (text) => `${indent}${paint(chalk, chalk?.dim, text)}`
   const bullet = (text) => `${indent}  • ${text}`
 
-  lines.push(header('How the FCM Router Works'))
+  lines.push(header(t('cli.routerHowItWorks')))
   lines.push('')
 
-  lines.push(header('1. The smart router daemon'))
+  lines.push(header(`1. ${t('cli.routerDaemon')}`))
   lines.push(body('Point any OpenAI-compatible client at http://localhost:19280/v1'))
   lines.push(body('with model: "fcm". The daemon picks the healthiest model in'))
   lines.push(body('your active set and forwards the request — with automatic'))
@@ -95,14 +119,14 @@ export function buildHowTheRouterWorksLines({ chalk = null, indent = '' } = {})
   lines.push(body('Family failover on the Router Dashboard) before switching family.'))
   lines.push('')
 
-  lines.push(header('2. The pre-prompt (system message)'))
+  lines.push(header(`2. ${t('cli.prePrompt')}`))
   lines.push(body('A first-class system message is injected on every proxied'))
   lines.push(body('request. The default text introduces the assistant as the FCM'))
   lines.push(body('routing agent and points the user to the dashboard URL.'))
   lines.push(body('You can edit it from Settings (Settings → Pre-prompt).'))
   lines.push('')
 
-  lines.push(header('3. The probe mechanism (every 10s/30s/120s)'))
+  lines.push(header(`3. ${t('cli.probeMechanism')}`))
   lines.push(body('The daemon sends a 1-token chat-completion ping to every model'))
   lines.push(body('in the active set. The probe measures latency + status code, not'))
   lines.push(body('just URL reachability — so a wrong API key is caught and the'))
@@ -112,7 +136,7 @@ export function buildHowTheRouterWorksLines({ chalk = null, indent = '' } = {})
   lines.push(bullet('aggressive: probe every 10s (uses more quota)'))
   lines.push('')
 
-  lines.push(header('4. The circuit breaker (per-model state)'))
+  lines.push(header(`4. ${t('cli.circuitBreaker')}`))
   lines.push(body('Each model has a tiny disjoncteur that flips between 3 states.'))
   lines.push(body('The raw jargon is hidden in the UI — here is what the colors mean:'))
   lines.push(bullet('Healthy (green)  — last probe returned 2xx, route here freely'))
@@ -125,21 +149,21 @@ export function buildHowTheRouterWorksLines({ chalk = null, indent = '' } = {})
   lines.push(body('then falls through to any provider.'))
   lines.push('')
 
-  lines.push(header('5. Failover order'))
+  lines.push(header(`5. ${t('cli.failoverOrder')}`))
   lines.push(body('Models in the active set are tried in priority order. A model'))
   lines.push(body('in Recovering/Down/Auth error is skipped — the request goes to'))
   lines.push(body('the next healthy one. If ALL models fail, you get a 503 with the'))
   lines.push(body('"models_tried" list in the error body — useful for debugging.'))
   lines.push('')
 
-  lines.push(header('6. Auto-heal (default behavior)'))
+  lines.push(header(`6. ${t('cli.autoHeal')}`))
   lines.push(body('On daemon start, the active set is checked. Any model in Auth'))
   lines.push(body('error or Deprecated is swapped for a working alternative. The'))
   lines.push(body('first time you add/remove/reorder a model, auto-heal switches off'))
   lines.push(body('and your manual choices are preserved.'))
   lines.push('')
 
-  lines.push(header('7. Rate limits (RPD / RPM / TPM)'))
+  lines.push(header(`7. ${t('cli.rateLimits')}`))
   lines.push(body('Each provider has its own quota. Common free-tier limits:'))
   lines.push(bullet('Groq on-demand: 14 400 RPD, 30 RPM per model'))
   lines.push(bullet('Mistral La Plateforme: 1 RPS, 1B TPM (experiment plan)'))
@@ -164,35 +188,35 @@ function formatEntry(label, description, { chalk = null, indent = '', labelWidth
   return `${indent}${coloredLabel} ${coloredDescription}`
 }
 
-export function buildCliHelpLines({ chalk = null, indent = '', title = 'CLI Help' } = {}) {
+export function buildCliHelpLines({ chalk = null, indent = '', title = null } = {}) {
   const lines = []
   const launchFlags = getToolModeOrder()
     .map((mode) => getToolMeta(mode))
     .filter((meta) => meta.flag)
-    .map((meta) => ({ flag: meta.flag, description: `${meta.label} mode` }))
+    .map((meta) => ({ flag: meta.flag, description: `${meta.label} ${t('cli.mode')}` }))
 
-  lines.push(`${indent}${paint(chalk, chalk?.bold, title)}`)
-  lines.push(`${indent}${paint(chalk, chalk?.dim, 'Usage: free-coding-models [apiKey] [options]')}`)
+  lines.push(`${indent}${paint(chalk, chalk?.bold, title || t('cli.helpTitle'))}`)
+  lines.push(`${indent}${paint(chalk, chalk?.dim, `${t('cli.usage')}: free-coding-models [apiKey] [options]`)}`)
   lines.push('')
-  lines.push(`${indent}${paint(chalk, chalk?.bold, 'Tool Flags')}`)
+  lines.push(`${indent}${paint(chalk, chalk?.bold, t('cli.toolFlags'))}`)
   for (const entry of launchFlags) {
-    lines.push(formatEntry(entry.flag, entry.description, { chalk, indent }))
+    lines.push(formatEntry(entry.flag, entryDescription(entry), { chalk, indent }))
   }
   lines.push('')
-  lines.push(`${indent}${paint(chalk, chalk?.bold, 'Analysis Flags')}`)
+  lines.push(`${indent}${paint(chalk, chalk?.bold, t('cli.analysisFlags'))}`)
   for (const entry of ANALYSIS_FLAGS) {
-    lines.push(formatEntry(entry.flag, entry.description, { chalk, indent }))
+    lines.push(formatEntry(entry.flag, entryDescription(entry), { chalk, indent }))
   }
   lines.push('')
-  lines.push(`${indent}${paint(chalk, chalk?.bold, 'Config & Maintenance')}`)
+  lines.push(`${indent}${paint(chalk, chalk?.bold, t('cli.configMaintenance'))}`)
   for (const entry of CONFIG_FLAGS) {
-    lines.push(formatEntry(entry.flag, entry.description, { chalk, indent }))
+    lines.push(formatEntry(entry.flag, entryDescription(entry), { chalk, indent }))
   }
   lines.push('')
-  lines.push(`${indent}${paint(chalk, chalk?.dim, 'Default launcher with no tool flag: OpenCode CLI')}`)
-  lines.push(`${indent}${paint(chalk, chalk?.dim, 'Flags can be combined: --openclaw --tier S --json')}`)
+  lines.push(`${indent}${paint(chalk, chalk?.dim, t('cli.defaultLauncher'))}`)
+  lines.push(`${indent}${paint(chalk, chalk?.dim, t('cli.combineFlags'))}`)
   lines.push('')
-  lines.push(`${indent}${paint(chalk, chalk?.bold, 'Examples')}`)
+  lines.push(`${indent}${paint(chalk, chalk?.bold, t('cli.examples'))}`)
   for (const example of EXAMPLES) {
     lines.push(`${indent}${paint(chalk, chalk?.cyan, example)}`)
   }

package/src/tui/command-palette.js

@@ -18,6 +18,7 @@
 import { TOOL_METADATA, TOOL_MODE_ORDER } from '../core/tool-metadata.js'
 import { sources } from '../../sources.js'
 import { sanitizePingInterval } from './tui-state.js'
+import { getLocale, hasTranslation, t } from '../core/i18n/index.js'
 
 // 📖 Max result rows the palette renders (overlays.js slices to this). The
 // 📖 cursor must never point past the rendered slice, so key-handler clamps
@@ -284,7 +285,24 @@ export function buildCommandPaletteTree(visibleModels = [], config = null) {
     }
   }
   
-  return tree
+  const localize = (nodes) => nodes.map((node) => {
+    const labelKey = `palette.command.${node.id}`
+    const descriptionKey = `palette.description.${node.id}`
+    const isProviderModelsDescription = node.id.startsWith('filter-provider-')
+      && node.id !== 'filter-provider-cycle'
+      && node.id !== 'filter-provider-all'
+    const effectiveDescriptionKey = isProviderModelsDescription
+      ? 'palette.description.providerModels'
+      : descriptionKey
+    if (hasTranslation(getLocale(), labelKey)) node.label = t(labelKey)
+    if (hasTranslation(getLocale(), effectiveDescriptionKey)) {
+      const provider = isProviderModelsDescription ? node.description?.replace(/ models$/, '') : undefined
+      node.description = t(effectiveDescriptionKey, { provider })
+    }
+    if (Array.isArray(node.children)) node.children = localize(node.children)
+    return node
+  })
+  return localize(tree)
 }
 
 /**

package/src/tui/key-handler.js

@@ -23,6 +23,7 @@
 
 import { getToolMeta, isModelCompatibleWithTool, getCompatibleTools, findSimilarCompatibleModels } from '../core/tool-metadata.js'
 import { loadConfig, saveConfig, replaceConfigContents, getApiKey } from '../core/config.js'
+import { setLocale } from '../core/i18n/index.js'
 import { sources } from '../../sources.js'
 import { join, dirname } from 'node:path'
 import { fileURLToPath } from 'node:url'
@@ -606,6 +607,14 @@ export function createKeyHandler(ctx) {
     applyThemeSetting(cycleThemeSetting(currentTheme))
   }
 
+  function cycleLanguage() {
+    if (!state.config.settings || typeof state.config.settings !== 'object') state.config.settings = {}
+    const nextLanguage = state.config.settings.language === 'zh-CN' ? 'en' : 'zh-CN'
+    state.config.settings.language = nextLanguage
+    setLocale(nextLanguage)
+    saveConfig(state.config)
+  }
+
   function toggleStartupAiSpeedScan() {
     if (!state.config.settings || typeof state.config.settings !== 'object') state.config.settings = {}
     state.config.settings.runAiSpeedTestOnStartup = state.config.settings.runAiSpeedTestOnStartup !== true
@@ -2607,7 +2616,8 @@ export function createKeyHandler(ctx) {
       const providerKeys = Object.keys(sources)
       const updateRowIdx = providerKeys.length
       const themeRowIdx = updateRowIdx + 1
-      const favoritesModeRowIdx = themeRowIdx + 1
+      const languageRowIdx = themeRowIdx + 1
+      const favoritesModeRowIdx = languageRowIdx + 1
       const startupAiSpeedScanRowIdx = favoritesModeRowIdx + 1
       const autoHideBrokenModelsRowIdx = startupAiSpeedScanRowIdx + 1
       const cleanupLegacyProxyRowIdx = autoHideBrokenModelsRowIdx + 1
@@ -2763,6 +2773,11 @@ export function createKeyHandler(ctx) {
           return
         }
 
+        if (state.settingsCursor === languageRowIdx) {
+          cycleLanguage()
+          return
+        }
+
         if (state.settingsCursor === favoritesModeRowIdx) {
           toggleFavoritesDisplayMode()
           return
@@ -2828,6 +2843,10 @@ export function createKeyHandler(ctx) {
           cycleGlobalTheme()
           return
         }
+        if (state.settingsCursor === languageRowIdx) {
+          cycleLanguage()
+          return
+        }
         if (state.settingsCursor === favoritesModeRowIdx) {
           toggleFavoritesDisplayMode()
           return
@@ -2856,6 +2875,7 @@ export function createKeyHandler(ctx) {
         if (
           state.settingsCursor === updateRowIdx
           || state.settingsCursor === themeRowIdx
+          || state.settingsCursor === languageRowIdx
           || state.settingsCursor === favoritesModeRowIdx
           || state.settingsCursor === startupAiSpeedScanRowIdx
           || state.settingsCursor === autoHideBrokenModelsRowIdx