free-coding-models 0.3.6 → 0.3.11

package/CHANGELOG.md

@@ -2,6 +2,38 @@
 
 ---
 
+## 0.3.11
+
+### Fixed
+- Added early 404 response when a requested model has no registered accounts, ensuring clear error handling.
+
+### Removed
+- **Profile system**: Entire profile system removed to ensure API keys persist permanently across all sessions. No more profile switching causing API key loss.
+
+### Added
+- **`--proxy` foreground mode**: New `--proxy` flag starts FCM Proxy V2 in the current terminal with a live dashboard showing status, accounts, provider breakdown, and real-time request log. No daemon install needed — works from dev checkout too.
+
+### Fixed
+- **Claude Code proxy auth**: Proxy now accepts `x-api-key` header (used by Anthropic SDK / Claude Code) in addition to `Authorization: Bearer`
+- **Claude model fallback**: When `anthropicRouting` is all null, Claude model names now fall back to the first available account instead of returning "Model not found"
+- **Proxy sync for Claude Code**: Added `claude-code` to `PROXY_SYNCABLE_TOOLS` so the env file is properly written/updated by proxy sync
+- **Correct env var name**: Claude Code env file now exports `ANTHROPIC_API_KEY` (SDK standard) instead of `ANTHROPIC_AUTH_TOKEN`
+- **Auto-source shell profile**: Claude Code env file is now automatically sourced in `.zshrc` / `.bashrc` / `.bash_profile`
+- **Removed deleted profile functions from tests**: Cleaned up test imports after profile system removal from config.js
+
+---
+
+## 0.3.9
+
+### Improved
+- **Enhanced `--premium` flag**: Now applies strict elite-only constraints. Shows only **S/S+** tier models with perfect health (**UP**) and a good verdict (**Perfect**, **Normal**, or **Slow**). Models with 429 errors, auth failures, or poor performance are automatically hidden.
+- **Accurate Token Usage Tracking**: The "Used" column now uses the persistent `token-stats.json` file as the source of truth, providing accurate historical totals instead of only the most recent logs.
+- **Enhanced Log Transparency**: The request log page now always shows the requested model and the actual upstream model (e.g., `llama-3.1-405b → meta/llama-3.1-405b-instruct`) whenever they differ.
+- **Pretty Provider Labels**: The request log page now uses human-readable provider labels (e.g., "NVIDIA NIM", "SambaNova") instead of raw internal keys.
+- **Fixed Tier Filtering Family Logic**: Updated `--tier S` behavior to correctly include both **S** and **S+** models (matching documentation).
+
+---
+
 ## 0.3.6
 
 ### Added

package/README.md

@@ -200,6 +200,30 @@ free-coding-models
 # Explicitly target OpenCode CLI (TUI + Enter launches OpenCode CLI)
 free-coding-models --opencode
 
+## 📋 CLI Flags (expanded)
+
+The tool now supports a comprehensive set of flags to fine‑tune its behavior. All flags can be combined in any order.
+
+| Flag | Type | Description |
+|------|------|-------------|
+| `--best` | boolean | Show only top‑tier models (A+, S, S+). |
+| `--fiable` | boolean | Run a 10 s reliability analysis and output the most reliable model. |
+| `--json` | boolean | Output results as JSON for scripting/automation. |
+| `--tier <S|A|B|C>` | value | Filter models by tier family (e.g. `S` shows S+ and S). |
+| `--recommend` | boolean | Open Smart Recommend mode immediately on startup. |
+| `--sort <column>` | value | Sort by a specific column (`rank`, `tier`, `origin`, `model`, `ping`, `avg`, `swe`, `ctx`, `condition`, `verdict`, `uptime`, `stability`, `usage`). |
+| `--desc` / `--asc` | boolean | Set sort direction explicitly (descending or ascending). |
+| `--origin <provider>` | value | Filter models by provider origin (e.g. `nvidia`, `groq`). |
+| `--ping-interval <ms>` | value | Override the ping interval in milliseconds (affects live monitoring speed). |
+| `--hide-unconfigured` | boolean | Hide models whose providers have no configured API key. |
+| `--show-unconfigured` | boolean | Show all models regardless of API key configuration. |
+| `--disable-widths-warning` | boolean | Disable the terminal width warning banner. |
+| `--profile <name>` | value | Load a saved configuration profile before startup. |
+| `--no-telemetry` | boolean | Disable anonymous telemetry for this run. |
+| `--clean-proxy`, `--proxy-clean` | boolean | Remove persisted FCM proxy configuration from OpenCode. |
+| `--help`, `-h` | boolean | Print the complete help text and exit. |
+
+These flags are also reflected in the built‑in help (`free-coding-models --help`).
 # Explicitly target OpenCode Desktop (TUI + Enter sets model & opens Desktop app)
 free-coding-models --opencode-desktop
 
@@ -920,6 +944,25 @@ This script:
 
 ## 📋 API Reference
 
+### 🎁 Premium Flag
+
+The `--premium` flag provides a quick view of only the elite **S/S+ tier** models with perfect health (**UP**) and a good verdict (**Perfect**, **Normal**, or **Slow**). This is useful when you want to focus exclusively on the highest‑quality, most reliable models that are currently available.
+
+```bash
+free-coding-models --premium
+```
+
+What it does under the hood:
+- Sets `tierFilter` to `S` (showing only S+ and S tier models).
+- Filters out any model that is not currently **UP** (hides 429, 410, auth fail, timeouts, etc.).
+- Filters out models with poor verdicts (hides **Spiky**, **Very Slow**, **Overloaded**, **Unstable**, etc.).
+- Forces the sort column to `verdict` with ascending order, so the best‑rated models appear at the top.
+- Leaves other settings untouched, so you can still combine it with flags like `--json` for scripting.
+
+You can combine `--premium` with other flags (e.g., `--json --hide-unconfigured`) to further tailor the output.
+
+---
+
 **Environment variables (override config file):**
 
 | Variable | Description |

package/bin/free-coding-models.js

@@ -99,7 +99,7 @@ import { homedir } from 'os'
 import { join, dirname } from 'path'
 import { MODELS, sources } from '../sources.js'
 import { getAvg, getVerdict, getUptime, getP95, getJitter, getStabilityScore, sortResults, filterByTier, findBestModel, parseArgs, TIER_ORDER, VERDICT_ORDER, TIER_LETTER_MAP, scoreModelForTask, getTopRecommendations, TASK_TYPES, PRIORITY_TYPES, CONTEXT_BUDGETS, formatCtxWindow, labelFromId, getProxyStatusInfo, formatResultsAsJSON } from '../src/utils.js'
-import { loadConfig, saveConfig, getApiKey, getProxySettings, resolveApiKeys, addApiKey, removeApiKey, isProviderEnabled, saveAsProfile, loadProfile, listProfiles, deleteProfile, getActiveProfileName, setActiveProfile, _emptyProfileSettings, persistApiKeysForProvider } from '../src/config.js'
+import { loadConfig, saveConfig, getApiKey, getProxySettings, resolveApiKeys, addApiKey, removeApiKey, isProviderEnabled, persistApiKeysForProvider } from '../src/config.js'
 import { buildMergedModels } from '../src/model-merger.js'
 import { ProxyServer } from '../src/proxy-server.js'
 import { loadOpenCodeConfig, saveOpenCodeConfig, syncToOpenCode, restoreOpenCodeBackup, cleanupOpenCodeProxyConfig } from '../src/opencode-sync.js'
@@ -126,6 +126,7 @@ import { createOverlayRenderers } from '../src/overlays.js'
 import { createKeyHandler } from '../src/key-handler.js'
 import { getToolModeOrder, getToolMeta } from '../src/tool-metadata.js'
 import { startExternalTool } from '../src/tool-launchers.js'
+import { startForegroundProxy } from '../src/proxy-foreground.js'
 import { getConfiguredInstallableProviders, installProviderEndpoints, refreshInstalledEndpoints, getInstallTargetModes, getProviderCatalogModels, CONNECTION_MODES } from '../src/endpoint-installer.js'
 import { loadCache, saveCache, clearCache, getCacheAge } from '../src/cache.js'
 import { checkConfigSecurity } from '../src/security.js'
@@ -203,6 +204,22 @@ async function main() {
     // 📖 User declined auto-fix or it failed — continue anyway, just warned
   }
 
+  // 📖 Apply CLI overrides for settings
+  if (cliArgs.sortColumn) config.settings.sortColumn = cliArgs.sortColumn
+  if (cliArgs.sortDirection) config.settings.sortAsc = cliArgs.sortDirection === 'asc'
+  if (cliArgs.originFilter) config.settings.originFilter = cliArgs.originFilter
+  if (cliArgs.pingInterval) config.settings.pingInterval = cliArgs.pingInterval
+  if (cliArgs.hideUnconfigured) config.settings.hideUnconfiguredModels = true
+  if (cliArgs.showUnconfigured) config.settings.hideUnconfiguredModels = false
+  if (cliArgs.disableWidthsWarning) config.settings.disableWidthsWarning = true
+
+  // 📖 Apply premium mode: show only S‑tier models sorted by verdict
+  if (cliArgs.premiumMode) {
+    config.settings.tierFilter = 'S'
+    config.settings.sortColumn = 'verdict'
+    config.settings.sortAsc = true
+  }
+
   if (cliArgs.cleanProxyMode) {
     const cleaned = cleanupOpenCodeProxyConfig()
     console.log()
@@ -213,6 +230,12 @@ async function main() {
     process.exit(0)
   }
 
+  // 📖 Foreground proxy mode — starts the proxy in the current terminal with live dashboard
+  if (cliArgs.proxyForegroundMode) {
+    await startForegroundProxy(config, chalk)
+    return // 📖 startForegroundProxy keeps the process alive via signal handlers
+  }
+
   // 📖 CLI subcommand: free-coding-models daemon <action>
   const daemonSubcmd = process.argv[2] === 'daemon' ? (process.argv[3] || 'status') : null
   if (daemonSubcmd) {
@@ -299,19 +322,7 @@ async function main() {
     process.exit(1)
   }
 
-  // 📖 If --profile <name> was passed, load that profile into the live config
-  let startupProfileSettings = null
-  if (cliArgs.profileName) {
-    startupProfileSettings = loadProfile(config, cliArgs.profileName)
-    if (!startupProfileSettings) {
-      console.error(chalk.red(`  Unknown profile "${cliArgs.profileName}". Available: ${listProfiles(config).join(', ') || '(none)'}`))
-      process.exit(1)
-    }
-    saveConfig(config, {
-      replaceApiKeys: true,
-      replaceFavorites: true,
-    })
-  }
+  // 📖 Profile system removed - API keys now persist permanently across all sessions
 
   // 📖 Check if any provider has a key — if not, run the first-time setup wizard
   const hasAnyKey = Object.keys(sources).some(pk => !!getApiKey(config, pk))
@@ -478,15 +489,15 @@ async function main() {
     return 'normal'
   }
 
-  // 📖 tierFilter: current tier filter letter (null = all, 'S' = S+/S, 'A' = A+/A/A-, etc.)
+   // 📖 tierFilter: current tier filter letter (null = all, 'S' = S+/S, 'A' = A+/A/A-, etc.)
   const state = {
     results,
     pendingPings: 0,
     frame: 0,
     cursor: 0,
     selectedModel: null,
-    sortColumn: startupProfileSettings?.sortColumn ?? config.settings?.sortColumn ?? 'avg',
-    sortDirection: (startupProfileSettings?.sortAsc ?? config.settings?.sortAsc ?? true) ? 'asc' : 'desc',
+    sortColumn: config.settings?.sortColumn ?? 'avg',
+    sortDirection: (config.settings?.sortAsc ?? true) ? 'asc' : 'desc',
     pingInterval: PING_MODE_INTERVALS.speed, // 📖 Effective live interval derived from the active ping mode.
     pingMode: 'speed',            // 📖 Current ping mode: speed | normal | slow | forced.
     pingModeSource: 'startup',    // 📖 Why this mode is active: startup | manual | auto | idle | activity.
@@ -499,8 +510,9 @@ async function main() {
     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)
-hideUnconfiguredModels: startupProfileSettings?.hideUnconfiguredModels === true || config.settings?.hideUnconfiguredModels === true, // 📖 Hide providers with no configured API key when true.
-      disableWidthsWarning: config.settings?.disableWidthsWarning ?? false, // 📖 Disable widths warning toggle (default off)
+    premiumMode: cliArgs.premiumMode, // 📖 Special elite-only mode: S/S+ only, Health UP only, Perfect/Normal/Slow verdict only.
+    hideUnconfiguredModels: config.settings?.hideUnconfiguredModels === true, // 📖 Hide providers with no configured API key when true.
+    disableWidthsWarning: config.settings?.disableWidthsWarning ?? false, // 📖 Disable widths warning toggle (default off)
       scrollOffset: 0,              // 📖 First visible model index in viewport
       terminalRows: process.stdout.rows || 24,  // 📖 Current terminal height
       terminalCols: process.stdout.columns || 80, // 📖 Current terminal width
@@ -557,10 +569,6 @@ hideUnconfiguredModels: startupProfileSettings?.hideUnconfiguredModels === true
     recommendAnalysisTimer: null, // 📖 setInterval handle for the 10s analysis phase
     recommendPingTimer: null,     // 📖 setInterval handle for 2 pings/sec during analysis
     recommendedKeys: new Set(),   // 📖 Set of "providerKey/modelId" for recommended models (shown in main table)
-    // 📖 Config Profiles state
-    activeProfile: getActiveProfileName(config), // 📖 Currently loaded profile name (or null)
-    profileSaveMode: false,       // 📖 Whether the inline "Save profile" name input is active
-    profileSaveBuffer: '',        // 📖 Typed characters for the profile name being saved
     // 📖 Feedback state (J/I keys open it)
     feedbackOpen: false,          // 📖 Whether the feedback overlay is active
     bugReportBuffer: '',          // 📖 Typed characters for the feedback message
@@ -756,6 +764,17 @@ hideUnconfiguredModels: startupProfileSettings?.hideUnconfiguredModels === true
       outputResults = outputResults.filter(r => ['S+', 'S', 'A+'].includes(r.tier))
     }
 
+    // 📖 Apply premium mode filter if specified: elite-only (S/S+, UP, Good Verdict)
+    if (cliArgs.premiumMode) {
+      outputResults = outputResults.filter(r => {
+        const isEliteTier = r.tier === 'S' || r.tier === 'S+'
+        const isHealthUp = r.status === 'up'
+        const verdict = getVerdict(r)
+        const isGoodVerdict = ['Perfect', 'Normal', 'Slow'].includes(verdict)
+        return isEliteTier && isHealthUp && isGoodVerdict
+      })
+    }
+
     // 📖 Sort by avg ping (ascending)
     outputResults = sortResults(outputResults, 'avg', 'asc')
 
@@ -770,6 +789,9 @@ hideUnconfiguredModels: startupProfileSettings?.hideUnconfiguredModels === true
 
   // 📖 Enter alternate screen — animation runs here, zero scrollback pollution
   process.stdout.write(ALT_ENTER)
+  if (process.stdout.isTTY) {
+    process.stdout.flush && process.stdout.flush()
+  }
 
   // 📖 Ensure we always leave alt screen cleanly (Ctrl+C, crash, normal exit)
   const exit = (code = 0) => {
@@ -778,6 +800,9 @@ hideUnconfiguredModels: startupProfileSettings?.hideUnconfiguredModels === true
     clearInterval(ticker)
     clearTimeout(state.pingIntervalObj)
     process.stdout.write(ALT_LEAVE)
+    if (process.stdout.isTTY) {
+      process.stdout.flush && process.stdout.flush()
+    }
     process.exit(code)
   }
   process.on('SIGINT',  () => exit(0))
@@ -785,7 +810,7 @@ hideUnconfiguredModels: startupProfileSettings?.hideUnconfiguredModels === true
 
   // 📖 originFilterMode: index into ORIGIN_CYCLE, 0=All, then each provider key in order
   const ORIGIN_CYCLE = [null, ...Object.keys(sources)]
-  const resolvedTierFilter = startupProfileSettings?.tierFilter ?? config.settings?.tierFilter
+  const resolvedTierFilter = config.settings?.tierFilter
   state.tierFilterMode = resolvedTierFilter ? Math.max(0, TIER_CYCLE.indexOf(resolvedTierFilter)) : 0
   const resolvedOriginFilter = config.settings?.originFilter
   state.originFilterMode = resolvedOriginFilter ? Math.max(0, ORIGIN_CYCLE.indexOf(resolvedOriginFilter)) : 0
@@ -805,9 +830,23 @@ hideUnconfiguredModels: startupProfileSettings?.hideUnconfiguredModels === true
         return
       }
       // 📖 Apply both tier and origin filters — model is hidden if it fails either
-      const tierHide = activeTier !== null && r.tier !== activeTier
+      // 📖 TIER_LETTER_MAP is used so --tier S also includes S+ models (tier family behavior).
+      const allowedTiers = (activeTier && TIER_LETTER_MAP[activeTier]) ? TIER_LETTER_MAP[activeTier] : [activeTier]
+      const tierHide = activeTier !== null && !allowedTiers.includes(r.tier)
       const originHide = activeOrigin !== null && r.providerKey !== activeOrigin
       r.hidden = tierHide || originHide
+
+      // 📖 Premium Mode: elite-only constraints (Health UP, Good Verdict, S/S+ only)
+      if (state.premiumMode && !r.hidden) {
+        const isEliteTier = r.tier === 'S' || r.tier === 'S+'
+        const isHealthUp = r.status === 'up'
+        const verdict = getVerdict(r)
+        const isGoodVerdict = ['Perfect', 'Normal', 'Slow'].includes(verdict)
+
+        if (!isEliteTier || !isHealthUp || !isGoodVerdict) {
+          r.hidden = true
+        }
+      }
     })
     return state.results
   }
@@ -823,6 +862,9 @@ hideUnconfiguredModels: startupProfileSettings?.hideUnconfiguredModels === true
     if (process.stdin.isTTY && resetRawMode) process.stdin.setRawMode(false)
     process.stdin.pause()
     process.stdout.write(ALT_LEAVE)
+    if (process.stdout.isTTY) {
+      process.stdout.flush && process.stdout.flush()
+    }
   }
 
   const overlays = createOverlayRenderers(state, {
@@ -835,7 +877,6 @@ hideUnconfiguredModels: startupProfileSettings?.hideUnconfiguredModels === true
     getProxySettings,
     resolveApiKeys,
     isProviderEnabled,
-    listProfiles,
     TIER_CYCLE,
     SETTINGS_OVERLAY_BG,
     HELP_OVERLAY_BG,
@@ -877,11 +918,6 @@ hideUnconfiguredModels: startupProfileSettings?.hideUnconfiguredModels === true
     removeApiKey,
     persistApiKeysForProvider,
     isProviderEnabled,
-    listProfiles,
-    loadProfile,
-    deleteProfile,
-    saveAsProfile,
-    setActiveProfile,
     saveConfig,
     getConfiguredInstallableProviders,
     getInstallTargetModes,
@@ -980,15 +1016,21 @@ hideUnconfiguredModels: startupProfileSettings?.hideUnconfiguredModels === true
                 ? overlays.renderLog()
               : state.changelogOpen
                 ? overlays.renderChangelog()
-                : 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.widthWarningShowCount, state.settingsUpdateState, state.settingsUpdateLatestVersion, getProxySettings(state.config).enabled === true, state.startupLatestVersion, state.versionAlertsEnabled)
+                 : 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.proxyStartupStatus, state.pingMode, state.pingModeSource, state.hideUnconfiguredModels, state.widthWarningStartedAt, state.widthWarningDismissed, state.widthWarningShowCount, state.settingsUpdateState, state.settingsUpdateLatestVersion, getProxySettings(state.config).enabled === true, state.startupLatestVersion, state.versionAlertsEnabled)
     process.stdout.write(ALT_HOME + content)
+    if (process.stdout.isTTY) {
+      process.stdout.flush && process.stdout.flush()
+    }
   }, Math.round(1000 / FPS))
 
   // 📖 Populate visibleSorted before the first frame so Enter works immediately
   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.widthWarningShowCount, state.settingsUpdateState, state.settingsUpdateLatestVersion, getProxySettings(state.config).enabled === true, state.startupLatestVersion, state.versionAlertsEnabled))
+  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.proxyStartupStatus, state.pingMode, state.pingModeSource, state.hideUnconfiguredModels, state.widthWarningStartedAt, state.widthWarningDismissed, state.widthWarningShowCount, state.settingsUpdateState, state.settingsUpdateLatestVersion, getProxySettings(state.config).enabled === true, state.startupLatestVersion, state.versionAlertsEnabled))
+  if (process.stdout.isTTY) {
+    process.stdout.flush && process.stdout.flush()
+  }
 
   // 📖 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.3.6",
+  "version": "0.3.11",
   "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/cli-help.js

@@ -26,10 +26,18 @@ const ANALYSIS_FLAGS = [
   { flag: '--json', description: 'Output results as JSON for scripts/automation' },
   { flag: '--tier <S|A|B|C>', description: 'Filter models by tier family' },
   { flag: '--recommend', description: 'Open Smart Recommend immediately on startup' },
+  { flag: '--premium', description: 'Show only S/S+ models with perfect health and good verdict' },
+  { flag: '--sort <column>', description: 'Sort by column (rank, tier, origin, model, ping, avg, swe, ctx, condition, verdict, uptime, stability, usage)' },
+  { flag: '--desc | --asc', description: 'Set sort direction (descending or ascending)' },
+  { flag: '--origin <provider>', description: 'Filter models by provider origin' },
+  { flag: '--ping-interval <ms>', description: 'Override ping interval in milliseconds' },
+  { flag: '--hide-unconfigured', description: 'Hide models without configured API keys' },
+  { flag: '--show-unconfigured', description: 'Show all models regardless of API key config' },
+  { flag: '--disable-widths-warning', description: 'Disable terminal width warning' },
 ]
 
 const CONFIG_FLAGS = [
-  { flag: '--profile <name>', description: 'Load a saved config profile before startup' },
+  { flag: '--proxy', description: 'Start FCM Proxy V2 in foreground with live dashboard (no daemon)' },
   { flag: '--no-telemetry', description: 'Disable anonymous telemetry for this run' },
   { flag: '--clean-proxy, --proxy-clean', description: 'Remove persisted fcm-proxy config from OpenCode' },
   { flag: '--help, -h', description: 'Print this help and exit' },