free-coding-models 0.2.11 → 0.2.12

package/CHANGELOG.md

@@ -2,10 +2,27 @@
 
 ---
 
+## 0.2.12
+
+### Added
+- **Auto-select models for all external tools**: All 10 supported tools (Aider, Crush, Goose, Claude Code, Codex, Gemini, Qwen, OpenHands, Amp, Pi) now automatically configure and pre-select the chosen model on launch — no manual model selection needed after pressing Enter.
+- **Changelog loader utility**: New `src/changelog-loader.js` module parses CHANGELOG.md for future TUI integration to display changes directly in the app instead of opening a browser.
+
+### Fixed
+- **Infinite update loop on startup**: Disabled forced auto-update that caused the app to detect the same update repeatedly after restarting. The app now checks for updates in the background without forcing installation.
+- **Removed disruptive browser window**: The auto-update process no longer opens a browser window to show the changelog — it now shows update information in the terminal only.
+- **Update failure tracking**: If update checks fail 3+ times, the app displays a prominent red footer warning: `⚠ OUTDATED version, please update` with manual update instructions instead of crashing.
+
+### Changed
+- **OpenHands integration improved**: Now sets `LLM_MODEL` and `LLM_API_KEY` environment variables for proper model pre-selection on launch.
+- **Amp integration improved**: Now writes `amp.model` to config file with the selected model ID.
+
+---
+
 ## 0.2.11
 
 ### Added
-- **Pi Coding Agent support**: Enabled Pi (pi.dev) as a launchable mode in the Z key cycle. Select a model and press Enter to configure Pi's config file and spawn the PI coding agent CLI with the chosen model and API endpoint.
+- **Pi Coding Agent support**: Enabled Pi (pi.dev) as a launchable mode in the Z key cycle. Select a model and press Enter to auto-configure Pi's model config and settings, then spawn the PI coding agent CLI with the chosen model pre-selected as the default.
 
 ---
 

package/README.md

@@ -85,8 +85,8 @@ By Vanessa Depraute
 - **🎮 Interactive selection** — Navigate with arrow keys directly in the table, press Enter to act
 - **💻 OpenCode integration** — Auto-detects NIM setup, sets model as default, launches OpenCode
 - **🦞 OpenClaw integration** — Sets selected model as default provider in `~/.openclaw/openclaw.json`
-- **🧰 Public tool launchers** — `Enter` can auto-configure and launch `OpenCode CLI`, `OpenCode Desktop`, `OpenClaw`, `Crush`, and `Goose`
-- **🔌 Install Endpoints flow** — Press `Y` to install one configured provider directly into `OpenCode CLI`, `OpenCode Desktop`, `OpenClaw`, `Crush`, or `Goose`, either with the full provider catalog or a curated subset of models
+- **🧰 Public tool launchers** — `Enter` auto-configures and launches 10+ tools: `OpenCode CLI`, `OpenCode Desktop`, `OpenClaw`, `Crush`, `Goose`, `Aider`, `Claude Code`, `Codex`, `Gemini`, `Qwen`, `OpenHands`, `Amp`, and `Pi`. All tools auto-select the chosen model on launch.
+- **🔌 Install Endpoints flow** — Press `Y` to install one configured provider directly into `OpenCode CLI`, `OpenCode Desktop`, `OpenClaw`, `Crush`, `Goose`, `Aider`, or `Gemini`, either with the full provider catalog or a curated subset of models
 - **📝 Feature Request (J key)** — Send anonymous feedback directly to the project team
 - **🐛 Bug Report (I key)** — Send anonymous bug reports directly to the project team
  - **🎨 Clean output** — Zero scrollback pollution, interface stays open until Ctrl+C
@@ -594,6 +594,30 @@ Use **↑↓** to scroll and **Esc** or **X** to return to the main table.
 
 ---
 
+## 🧰 Supported Tool Launchers
+
+You can use `free-coding-models` with 12+ AI coding tools. When you select a model and press Enter, the tool automatically configures and pre-selects your chosen model:
+
+| Tool | Flag | Auto-Config |
+|------|------|------------|
+| OpenCode CLI | `--opencode` | ~/.config/opencode/opencode.json |
+| OpenCode Desktop | `--opencode-desktop` | Opens Desktop app |
+| OpenClaw | `--openclaw` | ~/.openclaw/openclaw.json |
+| Crush | `--crush` | ~/.config/crush/crush.json |
+| Goose | `--goose` | Environment variables |
+| **Aider** | `--aider` | ~/.aider.conf.yml |
+| **Claude Code** | `--claude-code` | CLI flag |
+| **Codex** | `--codex` | CLI flag |
+| **Gemini** | `--gemini` | ~/.gemini/settings.json |
+| **Qwen** | `--qwen` | ~/.qwen/settings.json |
+| **OpenHands** | `--openhands` | LLM_MODEL env var |
+| **Amp** | `--amp` | ~/.config/amp/settings.json |
+| **Pi** | `--pi` | ~/.pi/agent/settings.json |
+
+Press **Z** to cycle through different tool modes in the TUI, or use flags to start in your preferred mode.
+
+---
+
 ## 🔌 OpenCode Integration
 
 **The easiest way** — let `free-coding-models` do everything:
@@ -604,7 +628,7 @@ Use **↑↓** to scroll and **Esc** or **X** to return to the main table.
 4. **Press Enter** — tool automatically:
    - Detects if NVIDIA NIM is configured in OpenCode
    - Sets your selected model as default in `~/.config/opencode/opencode.json`
-   - Launches OpenCode with the model ready to use
+   - Launches OpenCode with the model pre-selected and ready to use
 
 ### tmux sub-agent panes
 

package/bin/free-coding-models.js

@@ -261,47 +261,26 @@ async function main() {
     ts: new Date().toISOString(),
   })
 
-  // 📖 Check for updates in the background
+  // 📖 Check for updates in the background (non-blocking, non-forced)
+  // 📖 The old auto-update on startup caused infinite loops, so we've moved to:
+  // 📖 1. Optional prompt when a new version is available (user chooses to update or not)
+  // 📖 2. Display "OUTDATED" in TUI footer if update check fails repeatedly
   let latestVersion = null
+  let isOutdated = false
   try {
     latestVersion = await checkForUpdate()
-  } catch {
-    // Silently fail - don't block the app if npm registry is unreachable
-  }
-
-  // 📖 Auto-update system: force updates and handle changelog automatically
-  // 📖 Skip when running from source (dev mode) — .git means we're in a repo checkout,
-  // 📖 not a global npm install. Auto-update would overwrite the global copy but restart
-  // 📖 the local one, causing an infinite update loop since LOCAL_VERSION never changes.
-  const isDevMode = existsSync(join(dirname(new URL(import.meta.url).pathname.replace(/^\/([A-Z]:)/, '$1')), '..', '.git'))
-  if (latestVersion && !isDevMode) {
-    console.log()
-    console.log(chalk.bold.red('  ⚠ AUTO-UPDATE AVAILABLE'))
-    console.log(chalk.red(`  Version ${latestVersion} will be installed automatically`))
-    console.log(chalk.dim('  Opening changelog in browser...'))
-    console.log()
-    
-    // 📖 Open changelog automatically
-    const { execSync } = require('child_process')
-    const changelogUrl = 'https://github.com/vava-nessa/free-coding-models/releases'
-    try {
-      if (isMac) {
-        execSync(`open "${changelogUrl}"`, { stdio: 'ignore' })
-      } else if (isWindows) {
-        execSync(`start "" "${changelogUrl}"`, { stdio: 'ignore' })
-      } else {
-        execSync(`xdg-open "${changelogUrl}"`, { stdio: 'ignore' })
-      }
-      console.log(chalk.green('  ✅ Changelog opened in browser'))
-    } catch {
-      console.log(chalk.yellow('  ⚠ Could not open browser automatically'))
-      console.log(chalk.dim(`  Visit manually: ${changelogUrl}`))
+    // 📖 Track update check failures - if it fails 3+ times, mark as outdated
+    if (!latestVersion && config.settings?.updateCheckFailures >= 3) {
+      isOutdated = true
     }
-    
-    // 📖 Force update immediately
-    console.log(chalk.cyan('  🚀 Starting auto-update...'))
-    runUpdate(latestVersion)
-    return // runUpdate will restart the process
+  } catch (err) {
+    // 📖 Silently fail - don't block the app if npm registry is unreachable
+    // 📖 But track the failure for outdated detection
+    const failures = (config.settings?.updateCheckFailures || 0) + 1
+    if (!config.settings) config.settings = {}
+    config.settings.updateCheckFailures = Math.min(failures, 3)
+    if (failures >= 3) isOutdated = true
+    saveConfig(config)
   }
 
   // 📖 Dynamic OpenRouter free model discovery — fetch live free models from API
@@ -392,6 +371,8 @@ async function main() {
     lastPingTime: now,            // 📖 Track when last ping cycle started
     lastUserActivityAt: now,      // 📖 Any keypress refreshes this timer; inactivity can force slow mode.
     resumeSpeedOnActivity: false, // 📖 Set after idle slowdown so the next activity restarts a 60s speed burst.
+    latestVersion,                // 📖 Latest npm version available (null if none or check failed)
+    isOutdated,                   // 📖 Set to true if update check failed 3+ times (show red "OUTDATED" footer)
     mode,                         // 📖 'opencode' or 'openclaw' — controls Enter action
     tierFilterMode: 0,            // 📖 Index into TIER_CYCLE (0=All, 1=S+, 2=S, ...)
     originFilterMode: 0,          // 📖 Index into ORIGIN_CYCLE (0=All, then providers)
@@ -813,7 +794,7 @@ async function main() {
                 ? overlays.renderHelp()
               : state.logVisible
                 ? overlays.renderLog()
-                : renderTable(state.results, state.pendingPings, state.frame, state.cursor, state.sortColumn, state.sortDirection, state.pingInterval, state.lastPingTime, state.mode, state.tierFilterMode, state.scrollOffset, state.terminalRows, state.terminalCols, state.originFilterMode, state.activeProfile, state.profileSaveMode, state.profileSaveBuffer, state.proxyStartupStatus, state.pingMode, state.pingModeSource, state.hideUnconfiguredModels, state.widthWarningStartedAt, state.widthWarningDismissed, state.settingsUpdateState, state.settingsUpdateLatestVersion, getProxySettings(state.config).enabled === true)
+                : renderTable(state.results, state.pendingPings, state.frame, state.cursor, state.sortColumn, state.sortDirection, state.pingInterval, state.lastPingTime, state.mode, state.tierFilterMode, state.scrollOffset, state.terminalRows, state.terminalCols, state.originFilterMode, state.activeProfile, state.profileSaveMode, state.profileSaveBuffer, state.proxyStartupStatus, state.pingMode, state.pingModeSource, state.hideUnconfiguredModels, state.widthWarningStartedAt, state.widthWarningDismissed, state.settingsUpdateState, state.settingsUpdateLatestVersion, getProxySettings(state.config).enabled === true, state.isOutdated, state.latestVersion)
     process.stdout.write(ALT_HOME + content)
   }, Math.round(1000 / FPS))
 
@@ -821,7 +802,7 @@ async function main() {
   const initialVisible = state.results.filter(r => !r.hidden)
   state.visibleSorted = sortResultsWithPinnedFavorites(initialVisible, state.sortColumn, state.sortDirection)
 
-  process.stdout.write(ALT_HOME + renderTable(state.results, state.pendingPings, state.frame, state.cursor, state.sortColumn, state.sortDirection, state.pingInterval, state.lastPingTime, state.mode, state.tierFilterMode, state.scrollOffset, state.terminalRows, state.terminalCols, state.originFilterMode, state.activeProfile, state.profileSaveMode, state.profileSaveBuffer, state.proxyStartupStatus, state.pingMode, state.pingModeSource, state.hideUnconfiguredModels, state.widthWarningStartedAt, state.widthWarningDismissed, state.settingsUpdateState, state.settingsUpdateLatestVersion, getProxySettings(state.config).enabled === true))
+  process.stdout.write(ALT_HOME + renderTable(state.results, state.pendingPings, state.frame, state.cursor, state.sortColumn, state.sortDirection, state.pingInterval, state.lastPingTime, state.mode, state.tierFilterMode, state.scrollOffset, state.terminalRows, state.terminalCols, state.originFilterMode, state.activeProfile, state.profileSaveMode, state.profileSaveBuffer, state.proxyStartupStatus, state.pingMode, state.pingModeSource, state.hideUnconfiguredModels, state.widthWarningStartedAt, state.widthWarningDismissed, state.settingsUpdateState, state.settingsUpdateLatestVersion, getProxySettings(state.config).enabled === true, state.isOutdated, state.latestVersion))
 
   // 📖 If --recommend was passed, auto-open the Smart Recommend overlay on start
   if (cliArgs.recommendMode) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "free-coding-models",
-  "version": "0.2.11",
+  "version": "0.2.12",
   "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",

package/src/changelog-loader.js

@@ -0,0 +1,118 @@
+/**
+ * @file changelog-loader.js
+ * @description Load and parse CHANGELOG.md for display in the TUI
+ *
+ * @functions
+ *   → loadChangelog() — Read and parse CHANGELOG.md into structured format
+ *   → getLatestChanges(version) — Return changelog for a specific version
+ *   → formatChangelogForDisplay(version) — Format for TUI rendering
+ *
+ * @exports loadChangelog, getLatestChanges, formatChangelogForDisplay
+ */
+
+import { readFileSync, existsSync } from 'fs'
+import { dirname, join } from 'path'
+import { fileURLToPath } from 'url'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+const CHANGELOG_PATH = join(__dirname, '..', 'CHANGELOG.md')
+
+/**
+ * 📖 loadChangelog: Read and parse CHANGELOG.md
+ * @returns {Object} { versions: { '0.2.11': { added: [], fixed: [], changed: [] }, ... } }
+ */
+export function loadChangelog() {
+  if (!existsSync(CHANGELOG_PATH)) return { versions: {} }
+
+  const content = readFileSync(CHANGELOG_PATH, 'utf8')
+  const versions = {}
+  const lines = content.split('\n')
+  let currentVersion = null
+  let currentSection = null
+  let currentItems = []
+
+  for (const line of lines) {
+    // 📖 Match version headers: ## 0.2.11
+    const versionMatch = line.match(/^## ([\d.]+)/)
+    if (versionMatch) {
+      if (currentVersion && currentSection && currentItems.length > 0) {
+        if (!versions[currentVersion]) versions[currentVersion] = {}
+        versions[currentVersion][currentSection] = currentItems
+      }
+      currentVersion = versionMatch[1]
+      currentSection = null
+      currentItems = []
+      continue
+    }
+
+    // 📖 Match section headers: ### Added, ### Fixed, ### Changed
+    const sectionMatch = line.match(/^### (Added|Fixed|Changed|Updated)/)
+    if (sectionMatch) {
+      if (currentVersion && currentSection && currentItems.length > 0) {
+        if (!versions[currentVersion]) versions[currentVersion] = {}
+        versions[currentVersion][currentSection.toLowerCase()] = currentItems
+      }
+      currentSection = sectionMatch[1].toLowerCase()
+      currentItems = []
+      continue
+    }
+
+    // 📖 Match bullet points: - **text**: description
+    if (line.match(/^- /) && currentVersion && currentSection) {
+      currentItems.push(line.replace(/^- /, ''))
+    }
+  }
+
+  // 📖 Save the last section
+  if (currentVersion && currentSection && currentItems.length > 0) {
+    if (!versions[currentVersion]) versions[currentVersion] = {}
+    versions[currentVersion][currentSection] = currentItems
+  }
+
+  return { versions }
+}
+
+/**
+ * 📖 getLatestChanges: Return changelog for a specific version
+ * @param {string} version (e.g. '0.2.11')
+ * @returns {Object|null}
+ */
+export function getLatestChanges(version) {
+  const { versions } = loadChangelog()
+  return versions[version] || null
+}
+
+/**
+ * 📖 formatChangelogForDisplay: Format changelog section as array of strings for TUI
+ * @param {string} version
+ * @returns {string[]} formatted lines
+ */
+export function formatChangelogForDisplay(version) {
+  const changes = getLatestChanges(version)
+  if (!changes) return []
+
+  const lines = [
+    `📋 Changelog for v${version}`,
+    '',
+  ]
+
+  const sections = { added: 'Added', fixed: 'Fixed', changed: 'Changed', updated: 'Updated' }
+  for (const [key, label] of Object.entries(sections)) {
+    if (changes[key] && changes[key].length > 0) {
+      lines.push(`✨ ${label}:`)
+      for (const item of changes[key]) {
+        // 📖 Wrap long lines for display
+        const maxWidth = 70
+        let item_text = item.replace(/\*\*([^*]+)\*\*/g, '$1').replace(/`([^`]+)`/g, '$1')
+        if (item_text.length > maxWidth) {
+          item_text = item_text.substring(0, maxWidth - 3) + '...'
+        }
+        lines.push(`  • ${item_text}`)
+      }
+      lines.push('')
+    }
+  }
+
+  return lines
+}

package/src/render-table.js

@@ -92,7 +92,7 @@ export function setActiveProxy(proxyInstance) {
 }
 
 // ─── renderTable: mode param controls footer hint text (opencode vs openclaw) ─────────
-export function renderTable(results, pendingPings, frame, cursor = null, sortColumn = 'avg', sortDirection = 'asc', pingInterval = PING_INTERVAL, lastPingTime = Date.now(), mode = 'opencode', tierFilterMode = 0, scrollOffset = 0, terminalRows = 0, terminalCols = 0, originFilterMode = 0, activeProfile = null, profileSaveMode = false, profileSaveBuffer = '', proxyStartupStatus = null, pingMode = 'normal', pingModeSource = 'auto', hideUnconfiguredModels = false, widthWarningStartedAt = null, widthWarningDismissed = false, settingsUpdateState = 'idle', settingsUpdateLatestVersion = null, proxyEnabled = false) {
+export function renderTable(results, pendingPings, frame, cursor = null, sortColumn = 'avg', sortDirection = 'asc', pingInterval = PING_INTERVAL, lastPingTime = Date.now(), mode = 'opencode', tierFilterMode = 0, scrollOffset = 0, terminalRows = 0, terminalCols = 0, originFilterMode = 0, activeProfile = null, profileSaveMode = false, profileSaveBuffer = '', proxyStartupStatus = null, pingMode = 'normal', pingModeSource = 'auto', hideUnconfiguredModels = false, widthWarningStartedAt = null, widthWarningDismissed = false, settingsUpdateState = 'idle', settingsUpdateLatestVersion = null, proxyEnabled = false, isOutdated = false, latestVersion = null) {
   // 📖 Filter out hidden models for display
   const visibleResults = results.filter(r => !r.hidden)
 
@@ -648,25 +648,33 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
     const latestLabel = chalk.redBright(` local v${LOCAL_VERSION} · latest v${versionStatus.latestVersion}`)
     lines.push(`  ${outdatedBadge}${latestLabel}`)
   }
-  lines.push(
-    chalk.rgb(255, 150, 200)('  Made with 💖 & ☕ by \x1b]8;;https://github.com/vava-nessa\x1b\\vava-nessa\x1b]8;;\x1b\\') +
-    chalk.dim('  •  ') +
-    '⭐ ' +
-    chalk.yellow('\x1b]8;;https://github.com/vava-nessa/free-coding-models\x1b\\Star on GitHub\x1b]8;;\x1b\\') +
-    chalk.dim('  •  ') +
-    '🤝 ' +
-    chalk.rgb(255, 165, 0)('\x1b]8;;https://github.com/vava-nessa/free-coding-models/graphs/contributors\x1b\\Contributors\x1b]8;;\x1b\\') +
-    chalk.dim('  •  ') +
-    '☕ ' +
-    chalk.rgb(255, 200, 100)('\x1b]8;;https://buymeacoffee.com/vavanessadev\x1b\\Buy me a coffee\x1b]8;;\x1b\\') +
-    chalk.dim('  •  ') +
-    '💬 ' +
-    chalk.rgb(200, 150, 255)('\x1b]8;;https://discord.gg/ZTNFHvvCkU\x1b\\Discord\x1b]8;;\x1b\\') +
-    chalk.dim(' → ') +
-    chalk.rgb(200, 150, 255)('https://discord.gg/ZTNFHvvCkU') +
-    chalk.dim('  •  ') +
-    chalk.dim('Ctrl+C Exit')
-  )
+
+  // 📖 Build footer line, with OUTDATED warning if isOutdated is true
+  let footerLine = ''
+  if (isOutdated) {
+    // 📖 Show OUTDATED in red background, high contrast warning
+    footerLine = chalk.bgRed.bold.white('  ⚠ OUTDATED version, please update with "npm i -g free-coding-models@latest"  ')
+  } else {
+    footerLine =
+      chalk.rgb(255, 150, 200)('  Made with 💖 & ☕ by \x1b]8;;https://github.com/vava-nessa\x1b\\vava-nessa\x1b]8;;\x1b\\') +
+      chalk.dim('  •  ') +
+      '⭐ ' +
+      chalk.yellow('\x1b]8;;https://github.com/vava-nessa/free-coding-models\x1b\\Star on GitHub\x1b]8;;\x1b\\') +
+      chalk.dim('  •  ') +
+      '🤝 ' +
+      chalk.rgb(255, 165, 0)('\x1b]8;;https://github.com/vava-nessa/free-coding-models/graphs/contributors\x1b\\Contributors\x1b]8;;\x1b\\') +
+      chalk.dim('  •  ') +
+      '☕ ' +
+      chalk.rgb(255, 200, 100)('\x1b]8;;https://buymeacoffee.com/vavanessadev\x1b\\Buy me a coffee\x1b]8;;\x1b\\') +
+      chalk.dim('  •  ') +
+      '💬 ' +
+      chalk.rgb(200, 150, 255)('\x1b]8;;https://discord.gg/ZTNFHvvCkU\x1b\\Discord\x1b]8;;\x1b\\') +
+      chalk.dim(' → ') +
+      chalk.rgb(200, 150, 255)('https://discord.gg/ZTNFHvvCkU') +
+      chalk.dim('  •  ') +
+      chalk.dim('Ctrl+C Exit')
+  }
+  lines.push(footerLine)
 
   // 📖 Append \x1b[K (erase to EOL) to each line so leftover chars from previous
   // 📖 frames are cleared. Then pad with blank cleared lines to fill the terminal,

package/src/tool-launchers.js

@@ -228,25 +228,36 @@ function writeQwenConfig(model, providerKey, apiKey, baseUrl) {
 }
 
 function writePiConfig(model, apiKey, baseUrl) {
-  const filePath = join(homedir(), '.pi', 'agent', 'models.json')
-  const backupPath = backupIfExists(filePath)
-  const config = readJson(filePath, { providers: {} })
-  if (!config.providers || typeof config.providers !== 'object') config.providers = {}
-  config.providers.freeCodingModels = {
+  // 📖 Write models.json with the selected provider config
+  const modelsFilePath = join(homedir(), '.pi', 'agent', 'models.json')
+  const modelsBackupPath = backupIfExists(modelsFilePath)
+  const modelsConfig = readJson(modelsFilePath, { providers: {} })
+  if (!modelsConfig.providers || typeof modelsConfig.providers !== 'object') modelsConfig.providers = {}
+  modelsConfig.providers.freeCodingModels = {
     baseUrl,
     api: 'openai-completions',
     apiKey,
     models: [{ id: model.modelId, name: model.label }],
   }
-  writeJson(filePath, config)
-  return { filePath, backupPath }
+  writeJson(modelsFilePath, modelsConfig)
+
+  // 📖 Write settings.json to set the model as default on next launch
+  const settingsFilePath = join(homedir(), '.pi', 'agent', 'settings.json')
+  const settingsBackupPath = backupIfExists(settingsFilePath)
+  const settingsConfig = readJson(settingsFilePath, {})
+  settingsConfig.defaultProvider = 'freeCodingModels'
+  settingsConfig.defaultModel = model.modelId
+  writeJson(settingsFilePath, settingsConfig)
+
+  return { filePath: modelsFilePath, backupPath: modelsBackupPath, settingsFilePath, settingsBackupPath }
 }
 
-function writeAmpConfig(baseUrl) {
+function writeAmpConfig(model, baseUrl) {
   const filePath = join(homedir(), '.config', 'amp', 'settings.json')
   const backupPath = backupIfExists(filePath)
   const config = readJson(filePath, {})
   config['amp.url'] = baseUrl
+  config['amp.model'] = model.modelId
   writeJson(filePath, config)
   return { filePath, backupPath }
 }
@@ -346,19 +357,24 @@ export async function startExternalTool(mode, model, config) {
   }
 
   if (mode === 'openhands') {
-    console.log(chalk.dim('  📖 OpenHands is launched with --override-with-envs so the selected model applies immediately.'))
+    // 📖 OpenHands supports LLM_MODEL env var to set the default model
+    env.LLM_MODEL = model.modelId
+    env.LLM_API_KEY = apiKey || env.LLM_API_KEY
+    if (baseUrl) env.LLM_BASE_URL = baseUrl
+    console.log(chalk.dim(`  📖 OpenHands launched with model: ${model.modelId}`))
     return spawnCommand('openhands', ['--override-with-envs'], env)
   }
 
   if (mode === 'amp') {
-    printConfigResult(meta.label, writeAmpConfig(baseUrl))
-    console.log(chalk.yellow('  ⚠ Amp does not officially expose arbitrary model switching like the other CLIs.'))
-    console.log(chalk.dim('  The proxy URL is written, then Amp is launched so you can reuse the current endpoint.'))
+    printConfigResult(meta.label, writeAmpConfig(model, baseUrl))
+    console.log(chalk.dim(`  📖 Amp config updated with model: ${model.modelId}`))
     return spawnCommand('amp', [], env)
   }
 
   if (mode === 'pi') {
-    printConfigResult(meta.label, writePiConfig(model, apiKey, baseUrl))
+    const piResult = writePiConfig(model, apiKey, baseUrl)
+    printConfigResult(meta.label, { filePath: piResult.filePath, backupPath: piResult.backupPath })
+    printConfigResult(meta.label, { filePath: piResult.settingsFilePath, backupPath: piResult.settingsBackupPath })
     return spawnCommand('pi', [], env)
   }