free-coding-models 0.3.42 → 0.3.44

package/CHANGELOG.md

@@ -1,12 +1,10 @@
-# Changelog
----
-
-## [0.3.42] - 2026-04-09
+## [0.3.44] - 2026-04-10
 
 ### Added
-- Added a Star History section to the README so users can quickly see project growth and adoption over time.
+- Added **jcode** external tool support, integrating a new CLI tool across the codebase with command-palette description, tool metadata (label, emoji, flag, color), bootstrap metadata (binary, docs URL, install commands), and full launch wiring via `prepareExternalToolLaunch` and `startExternalTool`. CLI flag parsing for `--jcode` (jcodeMode) is also included.
+
+### Changed
+- Provider API keys are now synced into tool launches — `openclaw` imports `getApiKey` and `syncShellEnv`, accepts an env override in `spawnOpenClawCli`, and populates the child process env with the provider API key when launching the CLI. Tool launchers now use `model.providerKey` instead of hardcoded provider IDs, and `prepareExternalToolLaunch` includes provider and API key in launch args. This enables multi-provider support and ensures launched tools can authenticate using the configured key.
 
 ### Fixed
-- Xcode Intelligence bootstrap detection now recognizes `xcodebuild`, so the launcher can detect a valid local Xcode install instead of treating the tool as missing.
-- `free-coding-models --web` now checks whether port `3333` already belongs to another app and automatically starts on the next free local port instead of sending users to a misleading `Not Found` page.
-- npm releases now build the web dashboard during `prepack`, so published installs include `web/dist` and the web UI actually loads after install instead of starting a server with no bundled frontend.
+- README now includes a "Bonus Free Stuff" section with curated resources: community awesome-lists, AI-powered IDEs with free tiers, API providers with permanent free tiers, trial credit providers, and education/developer program freebies — accessible via a new navigation link.

package/README.md

@@ -34,11 +34,13 @@ create a free account on one of the [providers](#-list-of-free-ai-providers)
   <a href="#-why-this-tool">💡 Why</a> •
   <a href="#-quick-start">⚡ Quick Start</a> •
   <a href="#-list-of-free-ai-providers">🟢 Providers</a> •
+  <a href="#-bonus-free-stuff">🎁 Bonus Free Stuff</a> •
   <a href="#-usage">🚀 Usage</a> •
   <a href="#-tui-keys">⌨️ TUI Keys</a> •
   <a href="#-features">✨ Features</a> •
   <a href="#-contributing">📋 Contributing</a> •
   <a href="#️-model-licensing--commercial-use">⚖️ Licensing</a> •
+  <a href="#-telemetry">📊 Telemetry</a> •
   <a href="#️-security--trust">🛡️ Security</a> •
   <a href="#-support">📧 Support</a> •
   <a href="#-license">📄 License</a>
@@ -102,6 +104,84 @@ Create a free account on one provider below to get started:
 
 > 💡 One key is enough. Add more at any time with **`P`** inside the TUI.
 
+---
+
+## 🎁 Bonus Free Stuff
+
+**Everything free that isn't in the CLI** — IDE extensions, coding agents, GitHub lists, trial credits, and more.
+
+### 📚 Awesome Lists (curated by the community)
+
+| Resource | What it is |
+|----------|------------|
+| [cheahjs/free-llm-api-resources](https://github.com/cheahjs/free-llm-api-resources) (18.4k ⭐) | Comprehensive list of free LLM API providers with rate limits |
+| [mnfst/awesome-free-llm-apis](https://github.com/mnfst/awesome-free-llm-apis) (2.1k ⭐) | Permanent free LLM API tiers organized by provider |
+| [inmve/free-ai-coding](https://github.com/inmve/free-ai-coding) (648 ⭐) | Pro-grade AI coding tools side-by-side — limits, models, CC requirements |
+| [amardeeplakshkar/awesome-free-llm-apis](https://github.com/amardeeplakshkar/awesome-free-llm-apis) | Additional free LLM API resources |
+
+### 🖥️ AI-Powered IDEs with Free Tiers
+
+| IDE | Free tier | Credit card |
+|-----|-----------|-------------|
+| [Qwen Code](https://github.com/QwenLM/qwen-code) | 2,000 requests/day | No |
+| [Rovo Dev CLI](https://www.atlassian.com/rovo) | 5M tokens/day (beta) | No |
+| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | 100–250 requests/day | No |
+| [Jules](https://jules.google/) | 15 tasks/day | No |
+| [AWS Kiro](https://kiro.dev/) | 50 credits/month | No |
+| [Trae](https://trae.ai/) | 10 fast + 50 slow requests/month | No |
+| [Codeium](https://codeium.com/) | Unlimited forever, basic models | No |
+| [JetBrains AI Assistant](https://www.jetbrains.com/ai/) | Unlimited completions + local models | No |
+| [Continue.dev](https://www.continue.dev/) | Free VS Code/JetBrains extension, local models via Ollama | No |
+| [Warp](https://warp.dev/) | 150 credits/month (first 2 months), then 75/month | No |
+| [Amazon Q Developer](https://aws.amazon.com/q/developer/) | 50 agentic requests/month | Required |
+| [Windsurf](https://windsurf.com/) | 25 prompt credits/month | Required |
+| [Kilo Code](https://kilocode.ai/) | Up to $25 signup credits (one-time) | Required |
+| [Tabnine](https://www.tabnine.com/) | Basic completions + chat (limited) | Required |
+| [SuperMaven](https://supermaven.com/) | Basic suggestions, 1M token context | Required |
+
+### 🔑 API Providers with Permanent Free Tiers
+
+| Provider | Free limits | Notable models |
+|----------|-------------|----------------|
+| [OpenRouter](https://openrouter.ai/keys) | 50 req/day, 1K/day with $10 purchase | Qwen3-Coder, Llama 3.3 70B, Gemma 3 |
+| [Google AI Studio](https://aistudio.google.com/apikey) | 5–500 req/day (varies by model) | Gemini 2.5 Flash, Gemma 3 |
+| [NVIDIA NIM](https://build.nvidia.com) | 40 RPM | Llama 3.3 70B, Mistral Large, Qwen3 235B |
+| [Groq](https://console.groq.com/keys) | 1K–14.4K req/day (model-dependent) | Llama 3.3 70B, Llama 4 Scout, Kimi K2 |
+| [Cerebras](https://cloud.cerebras.ai/) | 30 RPM, 1M tokens/day | Qwen3-235B, Llama 3.1 70B, GPT-OSS 120B |
+| [Cohere](https://cohere.com/) | 20 RPM, 1K/month | Command R+, Aya Expanse 32B |
+| [Mistral La Plateforme](https://console.mistral.ai/) | 1 req/s, 1B tokens/month | Mistral Large 3, Small 3.1 |
+| [Cloudflare Workers AI](https://dash.cloudflare.com) | 10K neurons/day | Llama 3.3 70B, QwQ 32B, 47+ models |
+| [GitHub Models](https://github.com/marketplace/models) | Depends on Copilot tier | GPT-4o, DeepSeek-R1, Llama 3.3 |
+| [SiliconFlow](https://cloud.siliconflow.cn/account/ak) | 1K RPM, 50K TPM | Qwen3-8B, DeepSeek-R1, GLM-4.1V |
+| [HuggingFace](https://huggingface.com/settings/tokens) | ~$0.10/month credits | Llama 3.3 70B, Qwen2.5 72B |
+
+### 💰 Providers with Trial Credits
+
+| Provider | Credits | Duration |
+|----------|---------|----------|
+| [Hyperbolic](https://app.hyperbolic.ai/) | $1 free | Permanent |
+| [Fireworks](https://fireworks.ai/) | $1 | Permanent |
+| [Nebius](https://tokenfactory.nebius.com/) | $1 | Permanent |
+| [SambaNova Cloud](https://cloud.sambanova.ai/) | $5 | 3 months |
+| [AI21](https://studio.ai21.com/) | $10 | 3 months |
+| [Upstage](https://console.upstage.ai/) | $10 | 3 months |
+| [NLP Cloud](https://nlpcloud.com/home) | $15 | Permanent |
+| [Alibaba DashScope](https://bailian.console.alibabacloud.com/) | 1M tokens/model | 90 days |
+| [Scaleway](https://console.scaleway.com/generative-api/models) | 1M tokens | Permanent |
+| [Modal](https://modal.com) | $5/month | Monthly |
+| [Inference.net](https://inference.net) | $1 (+ $25 on survey) | Permanent |
+| [Novita](https://novita.ai/) | $0.5 | 1 year |
+
+### 🎓 Free with Education/Developer Programs
+
+| Program | What you get |
+|---------|--------------|
+| [GitHub Student Pack](https://education.github.com/pack) | Free Copilot Pro for students (verify with .edu email) |
+| [GitHub Copilot Free](https://code.visualstudio.com/blogs/2024/12/18/free-github-copilot) | 50 chat + 2,000 completions/month in VS Code |
+| [Copilot Pro for teachers/maintainers](https://docs.github.com/en/copilot/how-tos/manage-your-account/get-free-access-to-copilot-pro) | Free Copilot Pro for open source maintainers & educators |
+
+---
+
 ### Tier scale
 
 | Tier | SWE-bench | Best for |
@@ -369,6 +449,21 @@ For every model in this tool, **you own the generated output** — code, text, o
 
 ---
 
+## 📊 Telemetry
+
+`free-coding-models` collects anonymous usage telemetry to help understand how the CLI is used and improve the product. No personal information, API keys, prompts, source code, file paths, or secrets are ever collected.
+
+The telemetry payload is limited to anonymous product analytics such as the app version, selected tool mode, operating system, terminal family, and a random anonymous install ID stored locally on your machine. When a model is launched, telemetry can also include the selected tool, provider, model ID, model label, model tier, launch result, and a few product actions such as installing provider catalogs, saving/removing API keys, or toggling shell environment export.
+
+Telemetry is enabled by default and can be disabled with any of the following:
+
+| Method | How |
+|--------|-----|
+| CLI flag | Run `free-coding-models --no-telemetry` |
+| Environment variable | Set `FREE_CODING_MODELS_TELEMETRY=0` (also supports `false` or `off`) |
+
+---
+
 ## 🛡️ Security & Trust
 
 ### Supply Chain

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "free-coding-models",
-  "version": "0.3.42",
+  "version": "0.3.44",
   "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/app.js

@@ -32,7 +32,7 @@
  *   - `getTelemetryDistinctId`: Generate/reuse a stable anonymous ID for telemetry
  *   - `getTelemetryTerminal`: Infer terminal family (Terminal.app, iTerm2, kitty, etc.)
  *   - `isTelemetryDebugEnabled` / `telemetryDebug`: Optional runtime telemetry diagnostics via env
- *   - `sendUsageTelemetry`: Fire-and-forget anonymous app-start event
+ *   - `sendUsageTelemetry`: Fire-and-forget anonymous app-start, launch, and action events
  *   - `ensureFavoritesConfig` / `toggleFavoriteModel`: Persist and toggle pinned favorites
  *   - `promptApiKey`: Interactive wizard for first-time multi-provider API key setup
  *   - `buildPingRequest` / `ping`: Build provider-specific probe requests and measure latency
@@ -271,6 +271,8 @@ export async function runApp(cliArgs, config) {
   })
   if (requestedMode) mode = requestedMode
 
+  const sessionId = `session_${randomUUID()}`
+
   // 📖 Track app opening early so fast exits are still counted.
   // 📖 Must run before update checks because npm registry lookups can add startup delay.
   void sendUsageTelemetry(config, cliArgs, {
@@ -278,6 +280,10 @@ export async function runApp(cliArgs, config) {
     version: LOCAL_VERSION,
     mode,
     ts: new Date().toISOString(),
+    properties: {
+      session_id: sessionId,
+      event_version: 1,
+    },
   })
 
   // 📖 Auto-update detection: check npm registry for new versions at startup.
@@ -419,6 +425,7 @@ export async function runApp(cliArgs, config) {
     originFilterMode: 0,          // 📖 Index into ORIGIN_CYCLE (0=All, then providers)
     hideUnconfiguredModels: config.settings?.hideUnconfiguredModels === true, // 📖 Hide providers with no configured API key when true.
     favoritesPinnedAndSticky: config.settings?.favoritesPinnedAndSticky === true, // 📖 false by default: favorites follow normal sort/filter rules until Y enables pinned+sticky mode.
+    footerHidden: config.settings?.footerHidden === true, // 📖 true = footer is collapsed to a single toggle hint
       scrollOffset: 0,              // 📖 First visible model index in viewport
       terminalRows: process.stdout.rows || 24,  // 📖 Current terminal height
       terminalCols: process.stdout.columns || 80, // 📖 Current terminal width
@@ -438,6 +445,7 @@ export async function runApp(cliArgs, config) {
     settingsUpdateLatestVersion: null, // 📖 Latest npm version discovered from manual check
     settingsUpdateError: null,    // 📖 Last update-check error message for maintenance row
     config,                       // 📖 Live reference to the config object (updated on save)
+    sessionId,                    // 📖 Per-process analytics link between app_start and later app_use/app_action events.
     visibleSorted: [],            // 📖 Cached visible+sorted models — shared between render loop and key handlers
     commandPaletteOpen: false,    // 📖 Whether the Ctrl+P command palette overlay is active.
     commandPaletteQuery: '',      // 📖 Current command palette search query.
@@ -863,6 +871,7 @@ export async function runApp(cliArgs, config) {
     getToolInstallPlan,
     isToolInstalled,
     installToolWithPlan,
+    sendUsageTelemetry,
     startRecommendAnalysis: overlays.startRecommendAnalysis,
     stopRecommendAnalysis: overlays.stopRecommendAnalysis,
     sendBugReport,
@@ -1112,7 +1121,7 @@ export async function runApp(cliArgs, config) {
     pinFavorites: state.favoritesPinnedAndSticky,
   })
 
-      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, null, state.pingMode, state.pingModeSource, state.hideUnconfiguredModels, state.widthWarningStartedAt, state.widthWarningDismissed, state.widthWarningShowCount, state.settingsUpdateState, state.settingsUpdateLatestVersion, false, state.startupLatestVersion, state.versionAlertsEnabled, state.favoritesPinnedAndSticky, state.customTextFilter, state.lastReleaseDate))
+      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, null, state.pingMode, state.pingModeSource, state.hideUnconfiguredModels, state.widthWarningStartedAt, state.widthWarningDismissed, state.widthWarningShowCount, state.settingsUpdateState, state.settingsUpdateLatestVersion, false, state.startupLatestVersion, state.versionAlertsEnabled, state.favoritesPinnedAndSticky, state.customTextFilter, state.lastReleaseDate, state.footerHidden))
   if (process.stdout.isTTY) {
     process.stdout.flush && process.stdout.flush()
   }

package/src/command-palette.js

@@ -33,6 +33,7 @@ const TOOL_MODE_DESCRIPTIONS = {
   cline: 'Launch Cline CLI with the selected model.',
   rovo: 'Rovo Dev CLI model (launch with Rovo tool only).',
   gemini: 'Gemini CLI model (launch with Gemini tool only).',
+  jcode: 'Launch jcode coding agent with the selected model.',
 }
 
 const TOOL_MODE_COMMANDS = TOOL_MODE_ORDER.map((toolMode) => {

package/src/config.js

@@ -212,6 +212,7 @@ function normalizeSettingsSection(settings) {
     hideUnconfiguredModels: typeof safeSettings.hideUnconfiguredModels === 'boolean' ? safeSettings.hideUnconfiguredModels : true,
     favoritesPinnedAndSticky: typeof safeSettings.favoritesPinnedAndSticky === 'boolean' ? safeSettings.favoritesPinnedAndSticky : false,
     theme: ['dark', 'light', 'auto'].includes(safeSettings.theme) ? safeSettings.theme : 'auto',
+    footerHidden: typeof safeSettings.footerHidden === 'boolean' ? safeSettings.footerHidden : false,
   }
 }
 
@@ -839,7 +840,7 @@ export function isProviderEnabled(config, providerKey) {
 /**
  * 📖 _emptyProfileSettings: Default TUI settings.
  *
- * @returns {{ tierFilter: string|null, sortColumn: string, sortAsc: boolean, pingInterval: number, hideUnconfiguredModels: boolean, favoritesPinnedAndSticky: boolean, preferredToolMode: string }}
+ * @returns {{ tierFilter: string|null, sortColumn: string, sortAsc: boolean, pingInterval: number, hideUnconfiguredModels: boolean, favoritesPinnedAndSticky: boolean, preferredToolMode: string, theme: string, footerHidden: boolean }}
  */
 export function _emptyProfileSettings() {
   return {
@@ -851,6 +852,7 @@ export function _emptyProfileSettings() {
     favoritesPinnedAndSticky: false, // 📖 default mode keeps favorites as normal starred rows; press Y to pin+stick them.
     preferredToolMode: 'opencode', // 📖 remember the last Z-selected launcher across app restarts
     theme: 'auto',        // 📖 'auto' follows the terminal/OS theme, override with 'dark' or 'light' if needed
+    footerHidden: false,  // 📖 false = full footer shown; true = collapsed to a single "(W) Toggle Footer" hint
   }
 }
 

package/src/key-handler.js

@@ -11,6 +11,10 @@
  *   📖 Key I opens the unified "Feedback, bugs & requests" overlay.
  *
  *   It also owns the "test key" model selection used by the Settings overlay.
+ *   Anonymous telemetry hooks for model launches and a few high-signal settings
+ *   actions live here too, because this module already sees the final effective
+ *   tool mode, provider, and selected model right before the app hands control
+ *   to an external CLI.
  *   Some providers expose models in `/v1/models` that are not actually callable
  *   on the chat-completions endpoint. To avoid false negatives when a user
  *   presses `T` in Settings, the helpers below discover candidate model IDs,
@@ -195,6 +199,7 @@ export function createKeyHandler(ctx) {
     getToolInstallPlan,
     isToolInstalled,
     installToolWithPlan,
+    sendUsageTelemetry,
     startRecommendAnalysis,
     stopRecommendAnalysis,
     sendBugReport,
@@ -232,6 +237,56 @@ export function createKeyHandler(ctx) {
     return mode !== 'opencode-desktop'
   }
 
+  function getModelTelemetryFamily(providerKey) {
+    if (providerKey === 'rovo' || providerKey === 'gemini' || providerKey === 'opencode-zen') return providerKey
+    return 'standard'
+  }
+
+  function trackTelemetryEvent(event, properties = {}) {
+    if (typeof sendUsageTelemetry !== 'function') return
+    void sendUsageTelemetry(state.config, cliArgs, {
+      event,
+      mode: state.mode,
+      ts: new Date().toISOString(),
+      properties: {
+        session_id: state.sessionId,
+        event_version: 1,
+        ...properties,
+      },
+    })
+  }
+
+  function buildModelLaunchTelemetry(selected, extra = {}) {
+    return {
+      action_type: 'launch_model',
+      tool_mode: state.mode,
+      provider_key: selected.providerKey,
+      model_id: selected.modelId,
+      model_label: selected.label,
+      model_tier: selected.tier,
+      model_family: getModelTelemetryFamily(selected.providerKey),
+      ...extra,
+    }
+  }
+
+  function trackAppUse(selected, extra = {}) {
+    trackTelemetryEvent('app_use', buildModelLaunchTelemetry(selected, extra))
+  }
+
+  function trackAppUseResult(selected, launchResult, extra = {}) {
+    trackTelemetryEvent('app_use_result', buildModelLaunchTelemetry(selected, {
+      launch_result: launchResult,
+      ...extra,
+    }))
+  }
+
+  function trackAppAction(actionType, properties = {}) {
+    trackTelemetryEvent('app_action', {
+      action_type: actionType,
+      ...properties,
+    })
+  }
+
   async function launchSelectedModel(selected, options = {}) {
     const { uiAlreadyStopped = false } = options
     userSelected = { modelId: selected.modelId, label: selected.label, tier: selected.tier, providerKey: selected.providerKey }
@@ -264,6 +319,9 @@ export function createKeyHandler(ctx) {
 
     // 📖 Case A: User is in Rovo/Gemini mode but selected a model from a different provider
     if (isActiveModeCliOnly && !modelBelongsToActiveMode) {
+      trackAppUseResult(selected, 'blocked_incompatible_model', {
+        blocked_by_tool_mode: state.mode,
+      })
       const availableModels = MODELS.filter(m => m[5] === state.mode)
       console.log(chalk.yellow(`  ⚠ ${activeMeta.label} can only launch its own models.`))
       console.log(chalk.yellow(`  "${selected.label}" is not a ${activeMeta.label} model.`))
@@ -331,6 +389,9 @@ export function createKeyHandler(ctx) {
 
         const installResult = await installToolWithPlan(installPlan)
         if (!installResult.ok) {
+          trackAppUseResult(selected, 'blocked_missing_tool', {
+            required_tool_mode: toolModeForProvider,
+          })
           console.log(chalk.red(`  X Tool installation failed with exit code ${installResult.exitCode}.`))
           if (installPlan.docsUrl) console.log(chalk.dim(`  Docs: ${installPlan.docsUrl}`))
           console.log()
@@ -339,6 +400,9 @@ export function createKeyHandler(ctx) {
 
         // 📖 Verify tool is now installed
         if (!isToolInstalled(toolModeForProvider)) {
+          trackAppUseResult(selected, 'blocked_missing_tool', {
+            required_tool_mode: toolModeForProvider,
+          })
           console.log(chalk.yellow('  ⚠ The installer finished, but the tool is still not reachable from this terminal session.'))
           console.log(chalk.dim('  Restart your shell or add the tool bin directory to PATH, then retry the launch.'))
           if (installPlan.docsUrl) console.log(chalk.dim(`  Docs: ${installPlan.docsUrl}`))
@@ -351,6 +415,10 @@ export function createKeyHandler(ctx) {
       }
     }
 
+    const launchSource = uiAlreadyStopped ? 'tool_install_retry' : 'tui_enter'
+    trackAppUse(selected, { launch_source: launchSource })
+    trackAppUseResult(selected, 'started', { launch_source: launchSource })
+
     let exitCode = 0
     if (state.mode === 'openclaw') {
       exitCode = await startOpenClaw(userSelected, state.config, { launchCli: true })
@@ -377,6 +445,9 @@ export function createKeyHandler(ctx) {
 
     const installResult = await installToolWithPlan(currentPlan)
     if (!installResult.ok) {
+      trackAppUseResult(selected, 'blocked_missing_tool', {
+        required_tool_mode: state.mode,
+      })
       console.log(chalk.red(`  X Tool installation failed with exit code ${installResult.exitCode}.`))
       if (currentPlan?.docsUrl) console.log(chalk.dim(`  Docs: ${currentPlan.docsUrl}`))
       console.log()
@@ -384,6 +455,9 @@ export function createKeyHandler(ctx) {
     }
 
     if (shouldCheckMissingTool(state.mode) && !isToolInstalled(state.mode)) {
+      trackAppUseResult(selected, 'blocked_missing_tool', {
+        required_tool_mode: state.mode,
+      })
       console.log(chalk.yellow('  ⚠ The installer finished, but the tool is still not reachable from this terminal session.'))
       console.log(chalk.dim('  Restart your shell or add the tool bin directory to PATH, then retry the launch.'))
       if (currentPlan?.docsUrl) console.log(chalk.dim(`  Docs: ${currentPlan.docsUrl}`))
@@ -565,6 +639,9 @@ export function createKeyHandler(ctx) {
     } else {
       removeShellEnv()
     }
+    trackAppAction('shell_env_export_toggled', {
+      enabled: state.config.settings.shellEnvEnabled === true,
+    })
   }
 
   function resetInstallEndpointsOverlay() {
@@ -605,6 +682,14 @@ export function createKeyHandler(ctx) {
         ...(result.extraPath ? [chalk.bold(`Secrets:`) + ` ${result.extraPath}`] : []),
       ],
     }
+    trackAppAction('install_provider_endpoints', {
+      provider_key: result.providerKey,
+      tool_mode: result.toolMode,
+      install_scope: result.scope,
+      connection_mode: state.installEndpointsConnectionMode || 'direct',
+      model_count: result.modelCount,
+      selected_model_count: selectedModelIds.length,
+    })
     state.installEndpointsPhase = 'result'
     state.installEndpointsCursor = 0
     state.installEndpointsScrollOffset = 0
@@ -1880,6 +1965,11 @@ export function createKeyHandler(ctx) {
             if (!saveResult.success) {
               state.settingsErrorMsg = `⚠️  Failed to persist ${pk} API key: ${saveResult.error || 'Unknown error'}`
               setTimeout(() => { state.settingsErrorMsg = null }, 4000)
+            } else {
+              trackAppAction('api_key_saved', {
+                provider_key: pk,
+                key_action: state.settingsAddKeyMode ? 'add' : 'replace',
+              })
             }
           }
           state.settingsEditMode = false
@@ -2111,6 +2201,10 @@ export function createKeyHandler(ctx) {
             ? `✅ Removed one key for ${pk} (${remaining} remaining)`
             : `✅ Removed last API key for ${pk}`
           state.settingsSyncStatus = { type: 'success', msg }
+          trackAppAction('api_key_removed', {
+            provider_key: pk,
+            remaining_key_count: remaining,
+          })
         }
         return
       }
@@ -2191,10 +2285,20 @@ export function createKeyHandler(ctx) {
     // 📖 W cycles the supported ping modes:
     // 📖 speed (2s) → normal (10s) → slow (30s) → forced (4s) → speed.
     // 📖 forced ignores auto speed/slow transitions until the user leaves it manually.
-    if (key.name === 'w') {
+    if (key.name === 'w' && !key.alt && !key.ctrl && !key.meta) {
       const currentIdx = PING_MODE_CYCLE.indexOf(state.pingMode)
       const nextIdx = currentIdx >= 0 ? (currentIdx + 1) % PING_MODE_CYCLE.length : 0
       setPingMode(PING_MODE_CYCLE[nextIdx], 'manual')
+      return
+    }
+
+    // 📖 Alt+W: toggle footer visibility (collapse to single hint when hidden)
+    if (key.name === 'w' && key.alt && !key.ctrl && !key.meta) {
+      state.footerHidden = !state.footerHidden
+      if (!state.config.settings || typeof state.config.settings !== 'object') state.config.settings = {}
+      state.config.settings.footerHidden = state.footerHidden
+      saveConfig(state.config)
+      return
     }
 
     // 📖 E toggles hiding models whose provider has no configured API key.

package/src/openclaw.js

@@ -33,6 +33,8 @@ import { installProviderEndpoints } from './endpoint-installer.js'
 import { ENV_VAR_NAMES } from './provider-metadata.js'
 import { PROVIDER_COLOR } from './render-table.js'
 import { resolveToolBinaryPath } from './tool-bootstrap.js'
+import { getApiKey } from './config.js'
+import { syncShellEnv } from './shell-env.js'
 
 const OPENCLAW_CONFIG = join(homedir(), '.openclaw', 'openclaw.json')
 
@@ -56,7 +58,14 @@ export function saveOpenClawConfig(config, options = {}) {
   writeFileSync(filePath, JSON.stringify(config, null, 2))
 }
 
-function spawnOpenClawCli() {
+/**
+ * 📖 Spawn OpenClaw CLI with proper environment including API key.
+ * OpenClaw reads API keys from environment variables at runtime, not just config file.
+ *
+ * @param {NodeJS.ProcessEnv} env - Environment variables including API key
+ * @returns {Promise<number>} Exit code
+ */
+function spawnOpenClawCli(env = process.env) {
   return new Promise(async (resolve, reject) => {
     const { spawn } = await import('child_process')
     const command = resolveToolBinaryPath('openclaw') || 'openclaw'
@@ -64,7 +73,7 @@ function spawnOpenClawCli() {
       stdio: 'inherit',
       shell: false,
       detached: false,
-      env: process.env,
+      env,
     })
 
     child.on('exit', (code) => resolve(typeof code === 'number' ? code : 0))
@@ -107,16 +116,29 @@ export async function startOpenClaw(model, config, options = {}) {
     })
 
     const providerEnvName = ENV_VAR_NAMES[model.providerKey]
+    const apiKey = getApiKey(config, model.providerKey)
     console.log(chalk.rgb(255, 140, 0)(`  ✓ Default model set to: ${result.primaryModelRef || `${result.providerId}/${model.modelId}`}`))
     console.log()
     console.log(chalk.dim(`  📄 Config updated: ${result.path}`))
     if (result.backupPath) console.log(chalk.dim(`  💾 Backup: ${result.backupPath}`))
     if (providerEnvName) console.log(chalk.dim(`  🔑 API key synced under config env.${providerEnvName}`))
     console.log()
+
     if (options.launchCli) {
+      // 📖 Sync shell env so API key is available as environment variable
+      if (config.settings?.shellEnvEnabled !== false) {
+        syncShellEnv(config)
+      }
+
+      // 📖 Build env with API key so OpenClaw can authenticate
+      const launchEnv = { ...process.env }
+      if (apiKey && providerEnvName) {
+        launchEnv[providerEnvName] = apiKey
+      }
+
       console.log(chalk.dim('  Starting OpenClaw...'))
       console.log()
-      await spawnOpenClawCli()
+      await spawnOpenClawCli(launchEnv)
     } else {
       console.log(chalk.dim('  💡 OpenClaw will reload config automatically when it notices the file change.'))
       console.log(chalk.dim(`     To apply manually: openclaw models set ${result.primaryModelRef || `${result.providerId}/${model.modelId}`}`))

package/src/opencode.js

@@ -465,6 +465,20 @@ export async function startOpenCode(model, fcmConfig) {
         options: { baseURL: 'https://apis.iflow.cn/v1', apiKey: '{env:IFLOW_API_KEY}' },
         models: {}
       }
+    } else if (providerKey === 'chutes') {
+      config.provider.chutes = {
+        npm: '@ai-sdk/openai-compatible',
+        name: 'Chutes AI',
+        options: { baseURL: 'https://chutes.ai/v1', apiKey: '{env:CHUTES_API_KEY}' },
+        models: {}
+      }
+    } else if (providerKey === 'ovhcloud') {
+      config.provider.ovhcloud = {
+        npm: '@ai-sdk/openai-compatible',
+        name: 'OVHcloud AI',
+        options: { baseURL: 'https://oai.endpoints.kepler.ai.cloud.ovh.net/v1', apiKey: '{env:OVH_AI_ENDPOINTS_ACCESS_TOKEN}' },
+        models: {}
+      }
     }
   }
 
@@ -724,6 +738,20 @@ export async function startOpenCodeDesktop(model, fcmConfig) {
         options: { baseURL: 'https://apis.iflow.cn/v1', apiKey: '{env:IFLOW_API_KEY}' },
         models: {}
       }
+    } else if (providerKey === 'chutes') {
+      config.provider.chutes = {
+        npm: '@ai-sdk/openai-compatible',
+        name: 'Chutes AI',
+        options: { baseURL: 'https://chutes.ai/v1', apiKey: '{env:CHUTES_API_KEY}' },
+        models: {}
+      }
+    } else if (providerKey === 'ovhcloud') {
+      config.provider.ovhcloud = {
+        npm: '@ai-sdk/openai-compatible',
+        name: 'OVHcloud AI',
+        options: { baseURL: 'https://oai.endpoints.kepler.ai.cloud.ovh.net/v1', apiKey: '{env:OVH_AI_ENDPOINTS_ACCESS_TOKEN}' },
+        models: {}
+      }
     }
   }
 

package/src/render-table.js

@@ -104,7 +104,7 @@ export const PROVIDER_COLOR = new Proxy({}, {
 })
 
 // ─── 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, legacyStatus = null, pingMode = 'normal', pingModeSource = 'auto', hideUnconfiguredModels = false, widthWarningStartedAt = null, widthWarningDismissed = false, widthWarningShowCount = 0, settingsUpdateState = 'idle', settingsUpdateLatestVersion = null, legacyFlag = false, startupLatestVersion = null, versionAlertsEnabled = true, favoritesPinnedAndSticky = false, customTextFilter = null, lastReleaseDate = null) {
+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, legacyStatus = null, pingMode = 'normal', pingModeSource = 'auto', hideUnconfiguredModels = false, widthWarningStartedAt = null, widthWarningDismissed = false, widthWarningShowCount = 0, settingsUpdateState = 'idle', settingsUpdateLatestVersion = null, legacyFlag = false, startupLatestVersion = null, versionAlertsEnabled = true, favoritesPinnedAndSticky = false, customTextFilter = null, lastReleaseDate = null, footerHidden = false) {
   // 📖 Filter out hidden models for display
   const visibleResults = results.filter(r => !r.hidden)
 
@@ -780,7 +780,7 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
 
   // 📖 Line 2: command palette, recommend, feedback, theme
   {
-    const cpText = ' NEW ! CTRL+P ⚡️ Command Palette '
+    const cpText = ' CTRL+P ⚡️ Command Palette '
     const parts = [
       { text: '  ', key: null },
       { text: cpText, key: 'ctrl+p' },
@@ -802,7 +802,7 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
 
   // 📖 Line 2: command palette (highlighted as new), recommend, feedback, and extended hints.
   // 📖 CTRL+P ⚡️ Command Palette uses neon-green-on-dark-green background to highlight the feature.
-  const paletteLabel = chalk.bgRgb(0, 60, 0).rgb(57, 255, 20).bold(' NEW ! CTRL+P ⚡️ Command Palette ')
+  const paletteLabel = chalk.bgRgb(0, 60, 0).rgb(57, 255, 20).bold(' CTRL+P ⚡️ Command Palette ')
   lines.push(
     '  ' + paletteLabel + themeColors.dim(`  •  `) +
     hotkey('Q', ' Smart Recommend') + themeColors.dim(`  •  `) +
@@ -878,27 +878,35 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
 
   _lastLayout.footerHotkeys = footerHotkeys
 
-  const releaseLabel = lastReleaseDate
-    ? chalk.rgb(255, 182, 193)(`Last release: ${lastReleaseDate}`)
-    : ''
-
-  lines.push(
-    '  ' + themeColors.hotkey('N') + themeColors.dim(' Changelog') +
-    (filterBadge
-      ? themeColors.dim('  •  ') + filterBadge
-      : '') +
-    themeColors.dim('  •  ') +
-    themeColors.dim('Ctrl+C Exit') +
-    (releaseLabel ? themeColors.dim('  •  ') + releaseLabel : '')
-  )
-
-  // 📖 Discord link at the very bottom of the TUI
-  lines.push(
-    '  💬 ' +
-    themeColors.footerDiscord('\x1b]8;;https://discord.gg/ZTNFHvvCkU\x1b\\Join the Discord\x1b]8;;\x1b\\') +
-    themeColors.dim(' → ') +
-    themeColors.footerDiscord('https://discord.gg/ZTNFHvvCkU')
-  )
+  if (footerHidden) {
+    // 📖 Collapsed footer: single line with toggle hint
+    lines.push(
+      '  ' + themeColors.hotkey('Alt+W') + themeColors.dim(' Toggle Footer') +
+      themeColors.dim('  •  Ctrl+C Exit')
+    )
+  } else {
+    const releaseLabel = lastReleaseDate
+      ? chalk.rgb(255, 182, 193)(`Last release: ${lastReleaseDate}`)
+      : ''
+
+    lines.push(
+      '  ' + themeColors.hotkey('N') + themeColors.dim(' Changelog') +
+      (filterBadge
+        ? themeColors.dim('  •  ') + filterBadge
+        : '') +
+      themeColors.dim('  •  ') +
+      themeColors.dim('Ctrl+C Exit') +
+      (releaseLabel ? themeColors.dim('  •  ') + releaseLabel : '')
+    )
+
+    // 📖 Discord link at the very bottom of the TUI
+    lines.push(
+      '  💬 ' +
+      themeColors.footerDiscord('\x1b]8;;https://discord.gg/ZTNFHvvCkU\x1b\\Join the Discord\x1b]8;;\x1b\\') +
+      themeColors.dim(' → ') +
+      themeColors.footerDiscord('https://discord.gg/ZTNFHvvCkU')
+    )
+  }
 
   // 📖 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,