free-coding-models 0.1.65 → 0.1.66

package/README.md

@@ -2,8 +2,8 @@
   <img src="https://img.shields.io/npm/v/free-coding-models?color=76b900&label=npm&logo=npm" alt="npm version">
   <img src="https://img.shields.io/node/v/free-coding-models?color=76b900&logo=node.js" alt="node version">
   <img src="https://img.shields.io/npm/l/free-coding-models?color=76b900" alt="license">
-  <img src="https://img.shields.io/badge/models-111-76b900?logo=nvidia" alt="models count">
-  <img src="https://img.shields.io/badge/providers-13-blue" alt="providers count">
+  <img src="https://img.shields.io/badge/models-134-76b900?logo=nvidia" alt="models count">
+  <img src="https://img.shields.io/badge/providers-17-blue" alt="providers count">
 </p>
 
 <h1 align="center">free-coding-models</h1>
@@ -24,7 +24,7 @@
 
 <p align="center">
   <strong>Find the fastest coding LLM models in seconds</strong><br>
-  <sub>Ping free coding models from 13 providers in real-time — pick the best one for OpenCode, OpenClaw, or any AI coding assistant</sub>
+  <sub>Ping free coding models from 17 providers in real-time — pick the best one for OpenCode, OpenClaw, or any AI coding assistant</sub>
 </p>
 
 <p align="center">
@@ -47,7 +47,7 @@
 ## ✨ Features
 
 - **🎯 Coding-focused** — Only LLM models optimized for code generation, not chat or vision
-- **🌐 Multi-provider** — 111 models from NVIDIA NIM, Groq, Cerebras, SambaNova, OpenRouter, Hugging Face Inference, Replicate, DeepInfra, Fireworks AI, Codestral, Hyperbolic, Scaleway, and Google AI — all free to use
+- **🌐 Multi-provider** — 134 models from NVIDIA NIM, Groq, Cerebras, SambaNova, OpenRouter, Hugging Face Inference, Replicate, DeepInfra, Fireworks AI, Codestral, Hyperbolic, Scaleway, Google AI, SiliconFlow, Together AI, Cloudflare Workers AI, and Perplexity API
 - **⚙️ Settings screen** — Press `P` to manage provider API keys, enable/disable providers, test keys live, and manually check/install updates
 - **🚀 Parallel pings** — All models tested simultaneously via native `fetch`
 - **📊 Real-time animation** — Watch latency appear live in alternate screen buffer
@@ -88,10 +88,14 @@ Before using `free-coding-models`, make sure you have:
    - **Hyperbolic** — [app.hyperbolic.ai/settings](https://app.hyperbolic.ai/settings) → API Keys ($1 free trial)
    - **Scaleway** — [console.scaleway.com/iam/api-keys](https://console.scaleway.com/iam/api-keys) → IAM → API Keys (1M free tokens)
    - **Google AI Studio** — [aistudio.google.com/apikey](https://aistudio.google.com/apikey) → Get API key (free Gemma models, 14.4K req/day)
+   - **SiliconFlow** — [cloud.siliconflow.cn/account/ak](https://cloud.siliconflow.cn/account/ak) → API Keys (free-model quotas vary by model)
+   - **Together AI** — [api.together.ai/settings/api-keys](https://api.together.ai/settings/api-keys) → API Keys (credits/promotions vary)
+   - **Cloudflare Workers AI** — [dash.cloudflare.com](https://dash.cloudflare.com) → Create API token + set `CLOUDFLARE_ACCOUNT_ID` (Free: 10k neurons/day)
+   - **Perplexity API** — [perplexity.ai/settings/api](https://www.perplexity.ai/settings/api) → API Key (tiered limits by spend)
 3. **OpenCode** *(optional)* — [Install OpenCode](https://github.com/opencode-ai/opencode) to use the OpenCode integration
 4. **OpenClaw** *(optional)* — [Install OpenClaw](https://openclaw.ai) to use the OpenClaw integration
 
-> 💡 **Tip:** You don't need all thirteen providers. One key is enough to get started. Add more later via the Settings screen (`P` key). Models without a key still show real latency (`🔑 NO KEY`) so you can evaluate providers before signing up.
+> 💡 **Tip:** You don't need all seventeen providers. One key is enough to get started. Add more later via the Settings screen (`P` key). Models without a key still show real latency (`🔑 NO KEY`) so you can evaluate providers before signing up.
 
 ---
 
@@ -172,13 +176,13 @@ When you run `free-coding-models` without `--opencode` or `--openclaw`, you get
 Use `↑↓` arrows to select, `Enter` to confirm. Then the TUI launches with your chosen mode shown in the header badge.
 
 **How it works:**
-1. **Ping phase** — All enabled models are pinged in parallel (up to 111 across 13 providers)
+1. **Ping phase** — All enabled models are pinged in parallel (up to 134 across 17 providers)
 2. **Continuous monitoring** — Models are re-pinged every 2 seconds forever
 3. **Real-time updates** — Watch "Latest", "Avg", and "Up%" columns update live
 4. **Select anytime** — Use ↑↓ arrows to navigate, press Enter on a model to act
 5. **Smart detection** — Automatically detects if NVIDIA NIM is configured in OpenCode or OpenClaw
 
-Setup wizard (first run — walks through all 13 providers):
+Setup wizard (first run — walks through all 17 providers):
 
 ```
   🔑 First-time setup — API keys
@@ -208,7 +212,7 @@ Setup wizard (first run — walks through all 13 providers):
   You can add or change keys anytime with the P key in the TUI.
 ```
 
-You don't need all thirteen — skip any provider by pressing Enter. At least one key is required.
+You don't need all seventeen — skip any provider by pressing Enter. At least one key is required.
 
 ### Adding or changing keys later
 
@@ -257,6 +261,10 @@ HUGGINGFACE_API_KEY=hf_xxx free-coding-models
 REPLICATE_API_TOKEN=r8_xxx free-coding-models
 DEEPINFRA_API_KEY=di_xxx free-coding-models
 FIREWORKS_API_KEY=fw_xxx free-coding-models
+SILICONFLOW_API_KEY=sk_xxx free-coding-models
+TOGETHER_API_KEY=together_xxx free-coding-models
+CLOUDFLARE_API_TOKEN=cf_xxx CLOUDFLARE_ACCOUNT_ID=your_account_id free-coding-models
+PERPLEXITY_API_KEY=pplx_xxx free-coding-models
 FREE_CODING_MODELS_TELEMETRY=0 free-coding-models
 ```
 
@@ -306,13 +314,46 @@ When enabled, telemetry events include: event name, app version, selected mode,
 1. Sign up at [fireworks.ai](https://fireworks.ai)
 2. Open Settings → Access Tokens and create a token
 
+**Mistral Codestral**:
+1. Sign up at [codestral.mistral.ai](https://codestral.mistral.ai)
+2. Go to API Keys → Create
+
+**Hyperbolic**:
+1. Sign up at [app.hyperbolic.ai/settings](https://app.hyperbolic.ai/settings)
+2. Create an API key in Settings
+
+**Scaleway**:
+1. Sign up at [console.scaleway.com/iam/api-keys](https://console.scaleway.com/iam/api-keys)
+2. Go to IAM → API Keys
+
+**Google AI Studio**:
+1. Sign up at [aistudio.google.com/apikey](https://aistudio.google.com/apikey)
+2. Create an API key for Gemini/Gemma endpoints
+
+**SiliconFlow**:
+1. Sign up at [cloud.siliconflow.cn/account/ak](https://cloud.siliconflow.cn/account/ak)
+2. Create API key in Account → API Keys
+
+**Together AI**:
+1. Sign up at [api.together.ai/settings/api-keys](https://api.together.ai/settings/api-keys)
+2. Create an API key in Settings
+
+**Cloudflare Workers AI**:
+1. Sign up at [dash.cloudflare.com](https://dash.cloudflare.com)
+2. Create an API token with Workers AI permissions
+3. Export both `CLOUDFLARE_API_TOKEN` and `CLOUDFLARE_ACCOUNT_ID`
+
+**Perplexity API**:
+1. Sign up at [perplexity.ai/settings/api](https://www.perplexity.ai/settings/api)
+2. Create API key (`PERPLEXITY_API_KEY`)
+
 > 💡 **Free tiers** — each provider exposes a dev/free tier with its own quotas.
 
 ---
 
 ## 🤖 Coding Models
 
-**111 coding models** across 13 providers and 8 tiers, ranked by [SWE-bench Verified](https://www.swebench.com) — the industry-standard benchmark measuring real GitHub issue resolution. Scores are self-reported by providers unless noted.
+**134 coding models** across 17 providers and 8 tiers, ranked by [SWE-bench Verified](https://www.swebench.com) — the industry-standard benchmark measuring real GitHub issue resolution. Scores are self-reported by providers unless noted.
 
 ### NVIDIA NIM (44 models)
 
@@ -327,7 +368,7 @@ When enabled, telemetry events include: event name, app version, selected mode,
 | **B** 20–30% | R1 Distill 8B (28.2%), R1 Distill 7B (22.6%) |
 | **C** <20% | Gemma 2 9B (18.0%), Phi 4 Mini (14.0%), Phi 3.5 Mini (12.0%) |
 
-### Groq (6 models)
+### Groq (10 models)
 
 | Tier | SWE-bench | Model |
 |------|-----------|-------|
@@ -336,7 +377,7 @@ When enabled, telemetry events include: event name, app version, selected mode,
 | **A** 40–50% | Llama 4 Scout (44.0%), R1 Distill 70B (43.9%) |
 | **A-** 35–40% | Llama 3.3 70B (39.5%) |
 
-### Cerebras (3 models)
+### Cerebras (7 models)
 
 | Tier | SWE-bench | Model |
 |------|-----------|-------|
@@ -582,6 +623,11 @@ This script:
 | `HYPERBOLIC_API_KEY` | Hyperbolic key |
 | `SCALEWAY_API_KEY` | Scaleway key |
 | `GOOGLE_API_KEY` | Google AI Studio key |
+| `SILICONFLOW_API_KEY` | SiliconFlow key |
+| `TOGETHER_API_KEY` | Together AI key |
+| `CLOUDFLARE_API_TOKEN` / `CLOUDFLARE_API_KEY` | Cloudflare Workers AI token/key |
+| `CLOUDFLARE_ACCOUNT_ID` | Cloudflare account ID (required for Workers AI endpoint URL) |
+| `PERPLEXITY_API_KEY` / `PPLX_API_KEY` | Perplexity API key |
 | `FREE_CODING_MODELS_TELEMETRY` | `0` disables analytics, `1` enables analytics |
 | `FREE_CODING_MODELS_POSTHOG_KEY` | PostHog project API key used for anonymous event capture |
 | `FREE_CODING_MODELS_POSTHOG_HOST` | Optional PostHog ingest host (`https://eu.i.posthog.com` default) |
@@ -597,7 +643,11 @@ This script:
     "openrouter": "sk-or-xxx",
     "huggingface": "hf_xxx",
     "replicate": "r8_xxx",
-    "deepinfra": "di_xxx"
+    "deepinfra": "di_xxx",
+    "siliconflow": "sk_xxx",
+    "together": "together_xxx",
+    "cloudflare": "cf_xxx",
+    "perplexity": "pplx_xxx"
   },
   "providers": {
     "nvidia":   { "enabled": true },
@@ -606,7 +656,11 @@ This script:
     "openrouter": { "enabled": true },
     "huggingface": { "enabled": true },
     "replicate": { "enabled": true },
-    "deepinfra": { "enabled": true }
+    "deepinfra": { "enabled": true },
+    "siliconflow": { "enabled": true },
+    "together": { "enabled": true },
+    "cloudflare": { "enabled": true },
+    "perplexity": { "enabled": true }
   },
   "favorites": [
     "nvidia/deepseek-ai/deepseek-v3.2"

package/bin/free-coding-models.js

@@ -60,7 +60,8 @@
  *   ⚙️ Configuration:
  *   - API keys stored per-provider in ~/.free-coding-models.json (0600 perms)
  *   - Old ~/.free-coding-models plain-text auto-migrated as nvidia key on first run
- *   - Env vars override config: NVIDIA_API_KEY, GROQ_API_KEY, CEREBRAS_API_KEY, OPENROUTER_API_KEY, HUGGINGFACE_API_KEY/HF_TOKEN, REPLICATE_API_TOKEN, DEEPINFRA_API_KEY/DEEPINFRA_TOKEN, FIREWORKS_API_KEY, etc.
+ *   - Env vars override config: NVIDIA_API_KEY, GROQ_API_KEY, CEREBRAS_API_KEY, OPENROUTER_API_KEY, HUGGINGFACE_API_KEY/HF_TOKEN, REPLICATE_API_TOKEN, DEEPINFRA_API_KEY/DEEPINFRA_TOKEN, FIREWORKS_API_KEY, SILICONFLOW_API_KEY, TOGETHER_API_KEY, PERPLEXITY_API_KEY, etc.
+ *   - Cloudflare Workers AI requires both CLOUDFLARE_API_TOKEN (or CLOUDFLARE_API_KEY) and CLOUDFLARE_ACCOUNT_ID
  *   - Models loaded from sources.js — all provider/model definitions are centralized there
  *   - OpenCode config: ~/.config/opencode/opencode.json
  *   - OpenClaw config: ~/.openclaw/openclaw.json
@@ -755,6 +756,52 @@ const FRAMES = ['⠋','⠙','⠹','⠸','⠼','⠴','⠦','⠧','⠇','⠏']
 // 📖 Spinner cell: braille (1-wide) + padding to fill CELL_W visual chars
 const spinCell = (f, o = 0) => chalk.dim.yellow(FRAMES[(f + o) % FRAMES.length].padEnd(CELL_W))
 
+// 📖 Overlay-specific backgrounds so Settings (P) and Help (K) are visually distinct
+// 📖 from the main table and from each other.
+const SETTINGS_OVERLAY_BG = chalk.bgRgb(14, 20, 30)
+const HELP_OVERLAY_BG = chalk.bgRgb(24, 16, 32)
+const OVERLAY_PANEL_WIDTH = 116
+
+// 📖 Strip ANSI color/control sequences to estimate visible text width before padding.
+function stripAnsi(input) {
+  return String(input).replace(/\x1b\[[0-9;]*m/g, '').replace(/\x1b\][^\x1b]*\x1b\\/g, '')
+}
+
+// 📖 Tint overlay lines with a fixed dark panel width so the background is clearly visible.
+function tintOverlayLines(lines, bgColor) {
+  return lines.map((line) => {
+    const text = String(line)
+    const visibleWidth = stripAnsi(text).length
+    const padding = ' '.repeat(Math.max(0, OVERLAY_PANEL_WIDTH - visibleWidth))
+    return bgColor(text + padding)
+  })
+}
+
+// 📖 Clamp overlay scroll to valid bounds for the current terminal height.
+function clampOverlayOffset(offset, totalLines, terminalRows) {
+  const viewportRows = Math.max(1, terminalRows || 1)
+  const maxOffset = Math.max(0, totalLines - viewportRows)
+  return Math.max(0, Math.min(maxOffset, offset))
+}
+
+// 📖 Ensure a target line is visible inside overlay viewport (used by Settings cursor).
+function keepOverlayTargetVisible(offset, targetLine, totalLines, terminalRows) {
+  const viewportRows = Math.max(1, terminalRows || 1)
+  let next = clampOverlayOffset(offset, totalLines, terminalRows)
+  if (targetLine < next) next = targetLine
+  else if (targetLine >= next + viewportRows) next = targetLine - viewportRows + 1
+  return clampOverlayOffset(next, totalLines, terminalRows)
+}
+
+// 📖 Slice overlay lines to terminal viewport and pad with blanks to avoid stale frames.
+function sliceOverlayLines(lines, offset, terminalRows) {
+  const viewportRows = Math.max(1, terminalRows || 1)
+  const nextOffset = clampOverlayOffset(offset, lines.length, terminalRows)
+  const visible = lines.slice(nextOffset, nextOffset + viewportRows)
+  while (visible.length < viewportRows) visible.push('')
+  return { visible, offset: nextOffset }
+}
+
 // ─── Table renderer ───────────────────────────────────────────────────────────
 
 // 📖 Core logic functions (getAvg, getVerdict, getUptime, sortResults, etc.)
@@ -1139,6 +1186,15 @@ function renderTable(results, pendingPings, frame, cursor = null, sortColumn = '
 // 📖 providerKey and url determine provider-specific request format.
 // 📖 apiKey can be null — in that case no Authorization header is sent.
 // 📖 A 401 response still tells us the server is UP and gives us real latency.
+function resolveCloudflareUrl(url) {
+  // 📖 Cloudflare's OpenAI-compatible endpoint is account-scoped.
+  // 📖 We resolve {account_id} from env so provider setup can stay simple in config.
+  const accountId = (process.env.CLOUDFLARE_ACCOUNT_ID || '').trim()
+  if (!url.includes('{account_id}')) return url
+  if (!accountId) return url.replace('{account_id}', 'missing-account-id')
+  return url.replace('{account_id}', encodeURIComponent(accountId))
+}
+
 function buildPingRequest(apiKey, modelId, providerKey, url) {
   if (providerKey === 'replicate') {
     // 📖 Replicate uses /v1/predictions with a different payload than OpenAI chat-completions.
@@ -1151,6 +1207,17 @@ function buildPingRequest(apiKey, modelId, providerKey, url) {
     }
   }
 
+  if (providerKey === 'cloudflare') {
+    // 📖 Cloudflare Workers AI uses OpenAI-compatible payload but needs account_id in URL.
+    const headers = { 'Content-Type': 'application/json' }
+    if (apiKey) headers.Authorization = `Bearer ${apiKey}`
+    return {
+      url: resolveCloudflareUrl(url),
+      headers,
+      body: { model: modelId, messages: [{ role: 'user', content: 'hi' }], max_tokens: 1 },
+    }
+  }
+
   const headers = { 'Content-Type': 'application/json' }
   if (apiKey) headers.Authorization = `Bearer ${apiKey}`
   if (providerKey === 'openrouter') {
@@ -1228,6 +1295,10 @@ const ENV_VAR_NAMES = {
   hyperbolic: 'HYPERBOLIC_API_KEY',
   scaleway:   'SCALEWAY_API_KEY',
   googleai:   'GOOGLE_API_KEY',
+  siliconflow:'SILICONFLOW_API_KEY',
+  together:   'TOGETHER_API_KEY',
+  cloudflare: 'CLOUDFLARE_API_TOKEN',
+  perplexity: 'PERPLEXITY_API_KEY',
 }
 
 // 📖 Provider metadata used by the setup wizard and Settings details panel.
@@ -1324,6 +1395,34 @@ const PROVIDER_METADATA = {
     signupHint: 'Get API key',
     rateLimits: '14.4K req/day, 30/min',
   },
+  siliconflow: {
+    label: 'SiliconFlow',
+    color: chalk.rgb(255, 120, 30),
+    signupUrl: 'https://cloud.siliconflow.cn/account/ak',
+    signupHint: 'API Keys → Create',
+    rateLimits: 'Free models: usually 100 RPM, varies by model',
+  },
+  together: {
+    label: 'Together AI',
+    color: chalk.rgb(0, 180, 255),
+    signupUrl: 'https://api.together.ai/settings/api-keys',
+    signupHint: 'Settings → API keys',
+    rateLimits: 'Credits/promos vary by account (check console)',
+  },
+  cloudflare: {
+    label: 'Cloudflare Workers AI',
+    color: chalk.rgb(242, 119, 36),
+    signupUrl: 'https://dash.cloudflare.com',
+    signupHint: 'Create AI API token + set CLOUDFLARE_ACCOUNT_ID',
+    rateLimits: 'Free: 10k neurons/day, text-gen 300 RPM',
+  },
+  perplexity: {
+    label: 'Perplexity API',
+    color: chalk.rgb(0, 210, 190),
+    signupUrl: 'https://www.perplexity.ai/settings/api',
+    signupHint: 'Generate API key (billing may be required)',
+    rateLimits: 'Tiered limits by spend (default ~50 RPM)',
+  },
 }
 
 // 📖 OpenCode config location varies by platform
@@ -1692,6 +1791,53 @@ After installation, you can use: opencode --model ${modelRef}`
           },
           models: {}
         }
+      } else if (providerKey === 'siliconflow') {
+        config.provider.siliconflow = {
+          npm: '@ai-sdk/openai-compatible',
+          name: 'SiliconFlow',
+          options: {
+            baseURL: 'https://api.siliconflow.com/v1',
+            apiKey: '{env:SILICONFLOW_API_KEY}'
+          },
+          models: {}
+        }
+      } else if (providerKey === 'together') {
+        config.provider.together = {
+          npm: '@ai-sdk/openai-compatible',
+          name: 'Together AI',
+          options: {
+            baseURL: 'https://api.together.xyz/v1',
+            apiKey: '{env:TOGETHER_API_KEY}'
+          },
+          models: {}
+        }
+      } else if (providerKey === 'cloudflare') {
+        const cloudflareAccountId = (process.env.CLOUDFLARE_ACCOUNT_ID || '').trim()
+        if (!cloudflareAccountId) {
+          console.log(chalk.yellow('  ⚠ Cloudflare Workers AI requires CLOUDFLARE_ACCOUNT_ID for OpenCode integration.'))
+          console.log(chalk.dim('    Export CLOUDFLARE_ACCOUNT_ID and retry this selection.'))
+          console.log()
+          return
+        }
+        config.provider.cloudflare = {
+          npm: '@ai-sdk/openai-compatible',
+          name: 'Cloudflare Workers AI',
+          options: {
+            baseURL: `https://api.cloudflare.com/client/v4/accounts/${cloudflareAccountId}/ai/v1`,
+            apiKey: '{env:CLOUDFLARE_API_TOKEN}'
+          },
+          models: {}
+        }
+      } else if (providerKey === 'perplexity') {
+        config.provider.perplexity = {
+          npm: '@ai-sdk/openai-compatible',
+          name: 'Perplexity API',
+          options: {
+            baseURL: 'https://api.perplexity.ai',
+            apiKey: '{env:PERPLEXITY_API_KEY}'
+          },
+          models: {}
+        }
       }
     }
 
@@ -2302,7 +2448,9 @@ async function main() {
       st.scrollOffset = st.cursor - modelSlots + 1
     }
     // Final clamp
-    const maxOffset = Math.max(0, total - maxSlots)
+    // 📖 Keep one extra scroll step when top indicator is visible,
+    // 📖 otherwise the last rows become unreachable at the bottom.
+    const maxOffset = Math.max(0, total - maxSlots + 1)
     if (st.scrollOffset > maxOffset) st.scrollOffset = maxOffset
     if (st.scrollOffset < 0) st.scrollOffset = 0
   }
@@ -2337,6 +2485,8 @@ async function main() {
     config,                       // 📖 Live reference to the config object (updated on save)
     visibleSorted: [],            // 📖 Cached visible+sorted models — shared between render loop and key handlers
     helpVisible: false,           // 📖 Whether the help overlay (K key) is active
+    settingsScrollOffset: 0,      // 📖 Vertical scroll offset for Settings overlay viewport
+    helpScrollOffset: 0,          // 📖 Vertical scroll offset for Help overlay viewport
   }
 
   // 📖 Re-clamp viewport on terminal resize
@@ -2395,6 +2545,7 @@ async function main() {
     const updateRowIdx = providerKeys.length + 1
     const EL = '\x1b[K'
     const lines = []
+    const cursorLineByRow = {}
 
     lines.push('')
     lines.push(`  ${chalk.bold('⚙  Settings')}  ${chalk.dim('— free-coding-models v' + LOCAL_VERSION)}`)
@@ -2437,6 +2588,7 @@ async function main() {
       const bullet = isCursor ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
 
       const row = `${bullet}[ ${enabledBadge} ] ${providerName}  ${keyDisplay.padEnd(30)}  ${testBadge}  ${rateSummary}`
+      cursorLineByRow[i] = lines.length
       lines.push(isCursor ? chalk.bgRgb(30, 30, 60)(row) : row)
     }
 
@@ -2451,6 +2603,11 @@ async function main() {
       lines.push(chalk.dim(`  1) Create a ${selectedMeta.label || selectedSource.name} account: ${selectedMeta.signupUrl || 'signup link missing'}`))
       lines.push(chalk.dim(`  2) ${selectedMeta.signupHint || 'Generate an API key and paste it with Enter on this row'}`))
       lines.push(chalk.dim(`  3) Press ${chalk.yellow('T')} to test your key. Status: ${setupStatus}`))
+      if (selectedProviderKey === 'cloudflare') {
+        const hasAccountId = Boolean((process.env.CLOUDFLARE_ACCOUNT_ID || '').trim())
+        const accountIdStatus = hasAccountId ? chalk.green('CLOUDFLARE_ACCOUNT_ID detected ✅') : chalk.yellow('Set CLOUDFLARE_ACCOUNT_ID ⚠')
+        lines.push(chalk.dim(`  4) Export ${chalk.yellow('CLOUDFLARE_ACCOUNT_ID')} in your shell. Status: ${accountIdStatus}`))
+      }
       lines.push('')
     }
 
@@ -2467,6 +2624,7 @@ async function main() {
       ? chalk.dim('[Config]')
       : chalk.yellow('[Env override]')
     const telemetryRow = `${telemetryRowBullet}${chalk.bold('Anonymous usage analytics').padEnd(44)} ${telemetryStatus}  ${telemetrySource}`
+    cursorLineByRow[telemetryRowIdx] = lines.length
     lines.push(telemetryCursor ? chalk.bgRgb(30, 30, 60)(telemetryRow) : telemetryRow)
 
     lines.push('')
@@ -2488,6 +2646,7 @@ async function main() {
     if (updateState === 'error') updateStatus = chalk.red('Check failed (press U to retry)')
     if (updateState === 'installing') updateStatus = chalk.cyan('Installing update…')
     const updateRow = `${updateBullet}${chalk.bold(updateActionLabel).padEnd(44)} ${updateStatus}`
+    cursorLineByRow[updateRowIdx] = lines.length
     lines.push(updateCursor ? chalk.bgRgb(30, 30, 60)(updateRow) : updateRow)
     if (updateState === 'error' && state.settingsUpdateError) {
       lines.push(chalk.red(`      ${state.settingsUpdateError}`))
@@ -2501,9 +2660,19 @@ async function main() {
     }
     lines.push('')
 
-    const cleared = lines.map(l => l + EL)
-    const remaining = state.terminalRows > 0 ? Math.max(0, state.terminalRows - cleared.length) : 0
-    for (let i = 0; i < remaining; i++) cleared.push(EL)
+    // 📖 Keep selected Settings row visible on small terminals by scrolling the overlay viewport.
+    const targetLine = cursorLineByRow[state.settingsCursor] ?? 0
+    state.settingsScrollOffset = keepOverlayTargetVisible(
+      state.settingsScrollOffset,
+      targetLine,
+      lines.length,
+      state.terminalRows
+    )
+    const { visible, offset } = sliceOverlayLines(lines, state.settingsScrollOffset, state.terminalRows)
+    state.settingsScrollOffset = offset
+
+    const tintedLines = tintOverlayLines(visible, SETTINGS_OVERLAY_BG)
+    const cleared = tintedLines.map(l => l + EL)
     return cleared.join('\n')
   }
 
@@ -2514,7 +2683,7 @@ async function main() {
     const EL = '\x1b[K'
     const lines = []
     lines.push('')
-    lines.push(`  ${chalk.bold('❓ Keyboard Shortcuts')}  ${chalk.dim('— press K or Esc to close')}`)
+    lines.push(`  ${chalk.bold('❓ Keyboard Shortcuts')}  ${chalk.dim('— ↑↓ / PgUp / PgDn / Home / End scroll • K or Esc close')}`)
     lines.push('')
     lines.push(`  ${chalk.bold('Main TUI')}`)
     lines.push(`  ${chalk.bold('Navigation')}`)
@@ -2541,6 +2710,8 @@ async function main() {
     lines.push('')
     lines.push(`  ${chalk.bold('Settings (P)')}`)
     lines.push(`  ${chalk.yellow('↑↓')}           Navigate rows`)
+    lines.push(`  ${chalk.yellow('PgUp/PgDn')}    Jump by page`)
+    lines.push(`  ${chalk.yellow('Home/End')}     Jump first/last row`)
     lines.push(`  ${chalk.yellow('Enter')}        Edit key / toggle analytics / check-install update`)
     lines.push(`  ${chalk.yellow('Space')}        Toggle provider enable/disable`)
     lines.push(`  ${chalk.yellow('T')}            Test selected provider key`)
@@ -2558,9 +2729,11 @@ async function main() {
     lines.push(`  ${chalk.cyan('free-coding-models --no-telemetry')}       ${chalk.dim('Disable telemetry for this run')}`)
     lines.push(`  ${chalk.dim('Flags can be combined: --openclaw --tier S')}`)
     lines.push('')
-    const cleared = lines.map(l => l + EL)
-    const remaining = state.terminalRows > 0 ? Math.max(0, state.terminalRows - cleared.length) : 0
-    for (let i = 0; i < remaining; i++) cleared.push(EL)
+    // 📖 Help overlay can be longer than viewport, so keep a dedicated scroll offset.
+    const { visible, offset } = sliceOverlayLines(lines, state.helpScrollOffset, state.terminalRows)
+    state.helpScrollOffset = offset
+    const tintedLines = tintOverlayLines(visible, HELP_OVERLAY_BG)
+    const cleared = tintedLines.map(l => l + EL)
     return cleared.join('\n')
   }
 
@@ -2635,9 +2808,20 @@ async function main() {
   const onKeyPress = async (str, key) => {
     if (!key) return
 
-    // 📖 Help overlay: Esc or K closes it — handle before everything else so Esc isn't swallowed elsewhere
-    if (state.helpVisible && (key.name === 'escape' || key.name === 'k')) {
-      state.helpVisible = false
+    // 📖 Help overlay: full keyboard navigation + key swallowing while overlay is open.
+    if (state.helpVisible) {
+      const pageStep = Math.max(1, (state.terminalRows || 1) - 2)
+      if (key.name === 'escape' || key.name === 'k') {
+        state.helpVisible = false
+        return
+      }
+      if (key.name === 'up') { state.helpScrollOffset = Math.max(0, state.helpScrollOffset - 1); return }
+      if (key.name === 'down') { state.helpScrollOffset += 1; return }
+      if (key.name === 'pageup') { state.helpScrollOffset = Math.max(0, state.helpScrollOffset - pageStep); return }
+      if (key.name === 'pagedown') { state.helpScrollOffset += pageStep; return }
+      if (key.name === 'home') { state.helpScrollOffset = 0; return }
+      if (key.name === 'end') { state.helpScrollOffset = Number.MAX_SAFE_INTEGER; return }
+      if (key.ctrl && key.name === 'c') { exit(0); return }
       return
     }
 
@@ -2717,6 +2901,28 @@ async function main() {
         return
       }
 
+      if (key.name === 'pageup') {
+        const pageStep = Math.max(1, (state.terminalRows || 1) - 2)
+        state.settingsCursor = Math.max(0, state.settingsCursor - pageStep)
+        return
+      }
+
+      if (key.name === 'pagedown') {
+        const pageStep = Math.max(1, (state.terminalRows || 1) - 2)
+        state.settingsCursor = Math.min(updateRowIdx, state.settingsCursor + pageStep)
+        return
+      }
+
+      if (key.name === 'home') {
+        state.settingsCursor = 0
+        return
+      }
+
+      if (key.name === 'end') {
+        state.settingsCursor = updateRowIdx
+        return
+      }
+
       if (key.name === 'return') {
         if (state.settingsCursor === telemetryRowIdx) {
           ensureTelemetryConfig(state.config)
@@ -2784,6 +2990,7 @@ async function main() {
       state.settingsCursor = 0
       state.settingsEditMode = false
       state.settingsEditBuffer = ''
+      state.settingsScrollOffset = 0
       return
     }
 
@@ -2816,12 +3023,21 @@ async function main() {
     if (key.name === 'f') {
       const selected = state.visibleSorted[state.cursor]
       if (!selected) return
+      const wasFavorite = selected.isFavorite
       toggleFavoriteModel(state.config, selected.providerKey, selected.modelId)
       syncFavoriteFlags(state.results, state.config)
       applyTierFilter()
-      const selectedKey = toFavoriteKey(selected.providerKey, selected.modelId)
       const visible = state.results.filter(r => !r.hidden)
       state.visibleSorted = sortResultsWithPinnedFavorites(visible, state.sortColumn, state.sortDirection)
+
+      // 📖 UX rule: when unpinning a favorite, jump back to the top of the list.
+      if (wasFavorite) {
+        state.cursor = 0
+        state.scrollOffset = 0
+        return
+      }
+
+      const selectedKey = toFavoriteKey(selected.providerKey, selected.modelId)
       const newCursor = state.visibleSorted.findIndex(r => toFavoriteKey(r.providerKey, r.modelId) === selectedKey)
       if (newCursor >= 0) state.cursor = newCursor
       else if (state.cursor >= state.visibleSorted.length) state.cursor = Math.max(0, state.visibleSorted.length - 1)
@@ -2864,6 +3080,7 @@ async function main() {
     // 📖 Help overlay key: K = toggle help overlay
     if (key.name === 'k') {
       state.helpVisible = !state.helpVisible
+      if (state.helpVisible) state.helpScrollOffset = 0
       return
     }
 
@@ -2882,18 +3099,20 @@ async function main() {
     }
 
     if (key.name === 'up') {
-      if (state.cursor > 0) {
-        state.cursor--
-        adjustScrollOffset(state)
-      }
+      // 📖 Main list wrap navigation: top -> bottom on Up.
+      const count = state.visibleSorted.length
+      if (count === 0) return
+      state.cursor = state.cursor > 0 ? state.cursor - 1 : count - 1
+      adjustScrollOffset(state)
       return
     }
 
     if (key.name === 'down') {
-      if (state.cursor < state.visibleSorted.length - 1) {
-        state.cursor++
-        adjustScrollOffset(state)
-      }
+      // 📖 Main list wrap navigation: bottom -> top on Down.
+      const count = state.visibleSorted.length
+      if (count === 0) return
+      state.cursor = state.cursor < count - 1 ? state.cursor + 1 : 0
+      adjustScrollOffset(state)
       return
     }
 

package/lib/config.js

@@ -24,7 +24,11 @@
  *       "codestral":  "csk-xxx",
  *       "hyperbolic": "eyJ...",
  *       "scaleway":   "scw-xxx",
- *       "googleai":   "AIza..."
+ *       "googleai":   "AIza...",
+ *       "siliconflow":"sk-xxx",
+ *       "together":   "together-xxx",
+ *       "cloudflare": "cf-xxx",
+ *       "perplexity": "pplx-xxx"
  *     },
  *     "providers": {
  *       "nvidia":     { "enabled": true },
@@ -39,7 +43,11 @@
  *       "codestral":  { "enabled": true },
  *       "hyperbolic": { "enabled": true },
  *       "scaleway":   { "enabled": true },
- *       "googleai":   { "enabled": true }
+ *       "googleai":   { "enabled": true },
+ *       "siliconflow":{ "enabled": true },
+ *       "together":   { "enabled": true },
+ *       "cloudflare": { "enabled": true },
+ *       "perplexity": { "enabled": true }
  *     },
  *     "favorites": [
  *       "nvidia/deepseek-ai/deepseek-v3.2"
@@ -94,6 +102,10 @@ const ENV_VARS = {
   hyperbolic: 'HYPERBOLIC_API_KEY',
   scaleway:   'SCALEWAY_API_KEY',
   googleai:   'GOOGLE_API_KEY',
+  siliconflow:'SILICONFLOW_API_KEY',
+  together:   'TOGETHER_API_KEY',
+  cloudflare: ['CLOUDFLARE_API_TOKEN', 'CLOUDFLARE_API_KEY'],
+  perplexity: ['PERPLEXITY_API_KEY', 'PPLX_API_KEY'],
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "free-coding-models",
-  "version": "0.1.65",
+  "version": "0.1.66",
   "description": "Find the fastest coding LLM models in seconds — ping free models from multiple providers, pick the best one for OpenCode, Cursor, or any AI coding assistant.",
   "keywords": [
     "nvidia",

package/sources.js

@@ -27,8 +27,8 @@
  *   📖 Secondary: https://swe-rebench.com (independent evals, scores are lower)
  *   📖 Leaderboard tracker: https://www.marc0.dev/en/leaderboard
  *
- *   @exports nvidiaNim, groq, cerebras, sambanova, openrouter, huggingface, replicate, deepinfra, fireworks, codestral, hyperbolic, scaleway, googleai — model arrays per provider
- *   @exports sources — map of { nvidia, groq, cerebras, sambanova, openrouter, huggingface, replicate, deepinfra, fireworks, codestral, hyperbolic, scaleway, googleai } each with { name, url, models }
+ *   @exports nvidiaNim, groq, cerebras, sambanova, openrouter, huggingface, replicate, deepinfra, fireworks, codestral, hyperbolic, scaleway, googleai, siliconflow, together, cloudflare, perplexity — model arrays per provider
+ *   @exports sources — map of { nvidia, groq, cerebras, sambanova, openrouter, huggingface, replicate, deepinfra, fireworks, codestral, hyperbolic, scaleway, googleai, siliconflow, together, cloudflare, perplexity } each with { name, url, models }
  *   @exports MODELS — flat array of [modelId, label, tier, sweScore, ctx, providerKey]
  *
  *   📖 MODELS now includes providerKey as 6th element so ping() knows which
@@ -230,6 +230,54 @@ export const googleai = [
   ['gemma-3-4b-it',                            'Gemma 3 4B',         'C',  '10.0%', '128k'],
 ]
 
+// 📖 SiliconFlow source - https://cloud.siliconflow.cn
+// 📖 OpenAI-compatible endpoint: https://api.siliconflow.com/v1/chat/completions
+// 📖 Free model quotas vary by model and can change over time.
+export const siliconflow = [
+  ['Qwen/Qwen3-Coder-480B-A35B-Instruct',      'Qwen3 Coder 480B',   'S+', '70.6%', '256k'],
+  ['deepseek-ai/DeepSeek-V3.2',                'DeepSeek V3.2',      'S+', '73.1%', '128k'],
+  ['Qwen/Qwen3-235B-A22B',                     'Qwen3 235B',         'S+', '70.0%', '128k'],
+  ['deepseek-ai/DeepSeek-R1',                  'DeepSeek R1',        'S',  '61.0%', '128k'],
+  ['Qwen/Qwen3-Coder-30B-A3B-Instruct',        'Qwen3 Coder 30B',    'A+', '55.0%', '32k'],
+  ['Qwen/Qwen2.5-Coder-32B-Instruct',          'Qwen2.5 Coder 32B',  'A',  '46.0%', '32k'],
+]
+
+// 📖 Together AI source - https://api.together.ai
+// 📖 OpenAI-compatible endpoint: https://api.together.xyz/v1/chat/completions
+// 📖 Credits/promotions vary by account and region; verify current quota in console.
+export const together = [
+  ['moonshotai/Kimi-K2.5',                     'Kimi K2.5',          'S+', '76.8%', '128k'],
+  ['Qwen/Qwen3-Coder-480B-A35B-Instruct-FP8',  'Qwen3 Coder 480B',   'S+', '70.6%', '256k'],
+  ['deepseek-ai/DeepSeek-V3.1',                'DeepSeek V3.1',      'S',  '62.0%', '128k'],
+  ['deepseek-ai/DeepSeek-R1',                  'DeepSeek R1',        'S',  '61.0%', '128k'],
+  ['openai/gpt-oss-120b',                      'GPT OSS 120B',       'S',  '60.0%', '128k'],
+  ['openai/gpt-oss-20b',                       'GPT OSS 20B',        'A',  '42.0%', '128k'],
+  ['meta-llama/Llama-3.3-70B-Instruct-Turbo',  'Llama 3.3 70B',      'A-', '39.5%', '128k'],
+]
+
+// 📖 Cloudflare Workers AI source - https://developers.cloudflare.com/workers-ai
+// 📖 OpenAI-compatible endpoint requires account id:
+// 📖 https://api.cloudflare.com/client/v4/accounts/{account_id}/ai/v1/chat/completions
+// 📖 Free plan includes daily neuron quota and provider-level request limits.
+export const cloudflare = [
+  ['@cf/openai/gpt-oss-120b',                  'GPT OSS 120B',       'S',  '60.0%', '128k'],
+  ['@cf/qwen/qwen2.5-coder-32b-instruct',      'Qwen2.5 Coder 32B',  'A',  '46.0%', '32k'],
+  ['@cf/deepseek-ai/deepseek-r1-distill-qwen-32b', 'R1 Distill 32B', 'A',  '43.9%', '128k'],
+  ['@cf/openai/gpt-oss-20b',                   'GPT OSS 20B',        'A',  '42.0%', '128k'],
+  ['@cf/meta/llama-3.3-70b-instruct-fp8-fast', 'Llama 3.3 70B',      'A-', '39.5%', '128k'],
+  ['@cf/meta/llama-3.1-8b-instruct',           'Llama 3.1 8B',       'B',  '28.8%', '128k'],
+]
+
+// 📖 Perplexity source - https://docs.perplexity.ai
+// 📖 Chat Completions endpoint: https://api.perplexity.ai/chat/completions
+// 📖 Sonar models focus on search/reasoning and have tiered API rate limits.
+export const perplexity = [
+  ['sonar-reasoning-pro',                      'Sonar Reasoning Pro', 'A+', '50.0%', '128k'],
+  ['sonar-reasoning',                          'Sonar Reasoning',     'A',  '45.0%', '128k'],
+  ['sonar-pro',                                'Sonar Pro',           'B+', '32.0%', '128k'],
+  ['sonar',                                    'Sonar',               'B',  '25.0%', '128k'],
+]
+
 // 📖 All sources combined - used by the main script
 // 📖 Each source has: name (display), url (API endpoint), models (array of model tuples)
 export const sources = {
@@ -298,6 +346,26 @@ export const sources = {
     url: 'https://generativelanguage.googleapis.com/v1beta/openai/chat/completions',
     models: googleai,
   },
+  siliconflow: {
+    name: 'SiliconFlow',
+    url: 'https://api.siliconflow.com/v1/chat/completions',
+    models: siliconflow,
+  },
+  together: {
+    name: 'Together AI',
+    url: 'https://api.together.xyz/v1/chat/completions',
+    models: together,
+  },
+  cloudflare: {
+    name: 'Cloudflare AI',
+    url: 'https://api.cloudflare.com/client/v4/accounts/{account_id}/ai/v1/chat/completions',
+    models: cloudflare,
+  },
+  perplexity: {
+    name: 'Perplexity',
+    url: 'https://api.perplexity.ai/chat/completions',
+    models: perplexity,
+  },
 }
 
 // 📖 Flatten all models from all sources — each entry includes providerKey as 6th element