free-coding-models 0.3.55 → 0.3.56

package/src/analysis.js

@@ -138,32 +138,45 @@ export function filterByTierOrExit(results, tierLetter) {
 const OPENROUTER_TIER_MAP = {
   'qwen/qwen3-coder':                         ['S+', '70.6%'],
   'mistralai/devstral-2':                      ['S+', '72.2%'],
-  'stepfun/step-3.5-flash':                    ['S+', '74.4%'],
-  'deepseek/deepseek-r1-0528':                 ['S',  '61.0%'],
+  'minimax/minimax-m2.5':                      ['S+', '74.0%'],
+  'z-ai/glm-4.5-air':                          ['S+', '72.0%'],
+  'tencent/hy3-preview':                       ['S+', '70.0%'],
+  'poolside/laguna-m.1':                       ['S+', '70.0%'],
+  'poolside/laguna-xs.2':                      ['S+', '70.0%'],
   'qwen/qwen3-next-80b-a3b-instruct':          ['S',  '65.0%'],
   'openai/gpt-oss-120b':                       ['S',  '60.0%'],
+  'inclusionai/ling-2.6-1t':                   ['S',  '60.0%'],
+  'nvidia/nemotron-3-super-120b-a12b':         ['A+', '56.0%'],
+  'nvidia/nemotron-3-nano-omni-30b-a3b-reasoning': ['A+', '52.0%'],
   'openai/gpt-oss-20b':                        ['A',  '42.0%'],
   'nvidia/nemotron-3-nano-30b-a3b':            ['A',  '43.0%'],
   'meta-llama/llama-3.3-70b-instruct':         ['A-', '39.5%'],
-  'mimo-v2-flash':                             ['A',  '45.0%'],
+  'google/gemma-4-31b-it':                     ['A',  '45.0%'],
+  'google/gemma-4-26b-a4b-it':                 ['A-', '38.0%'],
   'google/gemma-3-27b-it':                     ['A-', '36.0%'],
   'google/gemma-3-12b-it':                     ['B+', '30.0%'],
   'google/gemma-3-4b-it':                      ['B',  '22.0%'],
   'google/gemma-3n-e4b-it':                    ['B',  '22.0%'],
   'google/gemma-3n-e2b-it':                    ['B',  '18.0%'],
   'meta-llama/llama-3.2-3b-instruct':          ['B',  '20.0%'],
-  'mistralai/mistral-small-3.1-24b-instruct':  ['A-', '35.0%'],
-  'qwen/qwen3-4b':                             ['B',  '22.0%'],
   'nousresearch/hermes-3-llama-3.1-405b':      ['A',  '40.0%'],
   'nvidia/nemotron-nano-9b-v2':                ['B+', '28.0%'],
   'nvidia/nemotron-nano-12b-v2-vl':            ['B+', '30.0%'],
-  'z-ai/glm-4.5-air':                          ['A-', '38.0%'],
-  'arcee-ai/trinity-large-preview':             ['A',  '40.0%'],
-  'arcee-ai/trinity-mini':                      ['B+', '28.0%'],
-  'upstage/solar-pro-3':                       ['A-', '35.0%'],
   'cognitivecomputations/dolphin-mistral-24b-venice-edition': ['B+', '28.0%'],
   'liquid/lfm-2.5-1.2b-thinking':              ['B',  '18.0%'],
   'liquid/lfm-2.5-1.2b-instruct':              ['B',  '18.0%'],
+  'openrouter/free':                           ['B',  '25.0%'],
+  'openrouter/owl-alpha':                      ['A+', '50.0%'],
+}
+
+function isOpenRouterFreeModel(model) {
+  if (!model?.id) return false
+  if (model.id.endsWith(':free')) return true
+  const promptPrice = Number(model.pricing?.prompt)
+  const completionPrice = Number(model.pricing?.completion)
+  return Number.isFinite(promptPrice) && Number.isFinite(completionPrice)
+    && promptPrice === 0
+    && completionPrice === 0
 }
 
 // 📖 fetchOpenRouterFreeModels: Fetch live free models from OpenRouter API.
@@ -186,7 +199,7 @@ export async function fetchOpenRouterFreeModels() {
     const json = await res.json()
     if (!json.data || !Array.isArray(json.data)) return null
 
-    const freeModels = json.data.filter(m => m.id && m.id.endsWith(':free'))
+    const freeModels = json.data.filter(isOpenRouterFreeModel)
 
     return freeModels.map(m => {
       const baseId = m.id.replace(/:free$/, '')

package/src/app.js

@@ -19,7 +19,7 @@
  *   - Direct mode flags plus an in-app Z-cycle for the public launcher set
  *   - Automatic config detection and model setup for both tools
  *   - JSON config stored in ~/.free-coding-models.json (auto-migrates from old plain-text)
- *   - Multi-provider support via sources.js (NIM/Groq/Cerebras/OpenRouter/Hugging Face/Replicate/DeepInfra/... — extensible)
+ *   - Multi-provider support via sources.js (NIM/Groq/Cerebras/GitHub Models/Mistral/OpenRouter/... — extensible)
  *   - Settings screen (P key) to manage API keys, provider toggles, manual updates, and provider-key diagnostics
  *   - Install Endpoints flow (Settings / Command Palette) to push provider catalogs into OpenCode, OpenClaw, Crush, and Goose
  *   - Favorites system: toggle with F, switch pinning mode with Y, persist between sessions
@@ -59,7 +59,7 @@
  *   ⚙️ 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, SILICONFLOW_API_KEY, TOGETHER_API_KEY, PERPLEXITY_API_KEY, ZAI_API_KEY, etc.
+ *   - Env vars override config: NVIDIA_API_KEY, GROQ_API_KEY, CEREBRAS_API_KEY, OPENROUTER_API_KEY, GITHUB_TOKEN, MISTRAL_API_KEY, SCALEWAY_API_KEY, GOOGLE_API_KEY, CLOUDFLARE_API_TOKEN, DASHSCOPE_API_KEY, ZAI_API_KEY, etc.
  *   - ZAI (z.ai) uses a non-standard base path; cloudflare needs CLOUDFLARE_ACCOUNT_ID in env.
  *   - 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
@@ -111,7 +111,7 @@ import { resolveCloudflareUrl, buildPingRequest, ping, extractQuotaPercent, getP
 import { runFiableMode, filterByTierOrExit, fetchOpenRouterFreeModels } from '../src/analysis.js'
 import { PROVIDER_METADATA, ENV_VAR_NAMES, isWindows, isMac } from '../src/provider-metadata.js'
 import { parseTelemetryEnv, isTelemetryDebugEnabled, telemetryDebug, ensureTelemetryConfig, getTelemetryDistinctId, getTelemetrySystem, getTelemetryTerminal, isTelemetryEnabled, sendUsageTelemetry, sendBugReport } from '../src/telemetry.js'
-import { ensureFavoritesConfig, toFavoriteKey, syncFavoriteFlags, toggleFavoriteModel } from '../src/favorites.js'
+import { ensureFavoritesConfig, toFavoriteKey, syncFavoriteFlags, toggleFavoriteModel, reorderFavorite } from '../src/favorites.js'
 import { checkForUpdateDetailed, checkForUpdate, runUpdate, promptUpdateNotification, fetchLastReleaseDate } from './updater.js'
 import { promptApiKey } from '../src/setup.js'
 import { syncShellEnv, ensureShellRcSource, promptShellEnvMigration, removeShellEnv } from '../src/shell-env.js'
@@ -123,6 +123,7 @@ import { startOpenClaw } from '../src/openclaw.js'
 import { createOverlayRenderers } from '../src/overlays.js'
 import { createKeyHandler, createMouseEventHandler } from '../src/key-handler.js'
 import { createMouseHandler, containsMouseSequence } from '../src/mouse.js'
+import { stopRouterDashboardClient } from '../src/router-dashboard.js'
 import { getToolModeOrder, getToolMeta } from '../src/tool-metadata.js'
 import { startExternalTool } from '../src/tool-launchers.js'
 import { getToolInstallPlan, installToolWithPlan, isToolInstalled } from '../src/tool-bootstrap.js'
@@ -241,7 +242,11 @@ export async function runApp(cliArgs, config) {
       config.settings.shellEnvEnabled = false
       saveConfig(config)
     }
-    // 📖 'skip' (Ctrl+C) now also sets shellEnvEnabled = false — prompt won't reappear
+    if (choice === 'skip') {
+      if (!config.settings) config.settings = {}
+      config.settings.shellEnvEnabled = false
+      saveConfig(config)
+    }
   }
 
   // 📖 Default mode: use the last persisted launcher choice when valid,
@@ -522,6 +527,31 @@ export async function runApp(cliArgs, config) {
     installedModelsScrollOffset: 0, // 📖 Vertical scroll offset for overlay viewport
     installedModelsData: [],       // 📖 Cached scan results
     installedModelsErrorMsg: null, // 📖 Error or status message
+    // 📖 Router Dashboard overlay state (Shift+R opens it).
+    routerDashboardOpen: false,
+    routerDashboardStatus: 'idle', // 📖 idle | loading | ready | partial | stopped | stale | unreachable | malformed
+    routerDashboardBaseUrl: null,
+    routerDashboardPort: null,
+    routerDashboardHealth: null,
+    routerDashboardStats: null,
+    routerDashboardError: null,
+    routerDashboardScrollOffset: 0,
+    routerDashboardEvents: [],
+    routerDashboardLiveRequests: [],
+    routerDashboardClearedAt: 0,
+    routerDashboardLastUpdatedAt: null,
+    routerDashboardLastRefreshStartedAt: null,
+    routerDashboardPollTimer: null,
+    routerDashboardEventAbort: null,
+    routerDashboardEventStatus: 'idle',
+    routerDashboardEventError: null,
+    routerDashboardNotice: null,
+    routerDashboardNoticeTimer: null,
+    routerOnboardingScrollOffset: 0,
+    // 📖 Router upgrade banner (shown once to existing users who haven't seen router)
+    routerUpgradeBannerShownAt: 0, // 📖 Timestamp when banner was shown (0 = not shown)
+    routerUpgradeBannerDismissedAt: 0, // 📖 Timestamp when banner was dismissed (0 = not dismissed)
+    routerDashboardEverOpened: false, // 📖 Set to true the first time dashboard opens (used for upgrade-path telemetry)
     // 📖 Custom text filter (Ctrl+P palette → type text → Enter). Ephemeral — not saved to config.
     customTextFilter: null,       // 📖 Active free-text filter string (null = off). Matches model name, ctx, provider key/name.
   }
@@ -725,6 +755,7 @@ export async function runApp(cliArgs, config) {
     clearInterval(ticker)
     clearTimeout(state.pingIntervalObj)
     clearInterval(state.versionRecheckTimer)
+    stopRouterDashboardClient(state)
     process.stdout.write(ALT_LEAVE)
     if (process.stdout.isTTY) {
       process.stdout.flush && process.stdout.flush()
@@ -798,6 +829,7 @@ export async function runApp(cliArgs, config) {
     if (ticker) clearInterval(ticker)
     clearTimeout(state.pingIntervalObj)
     clearInterval(state.versionRecheckTimer)
+    stopRouterDashboardClient(state)
     if (onKeyPress) process.stdin.removeListener('keypress', onKeyPress)
     if (onMouseData) process.stdin.removeListener('data', onMouseData)
     if (process.stdin.isTTY && resetRawMode) process.stdin.setRawMode(false)
@@ -864,6 +896,7 @@ export async function runApp(cliArgs, config) {
     installProviderEndpoints,
     syncFavoriteFlags,
     toggleFavoriteModel,
+    reorderFavorite,
     sortResultsWithPinnedFavorites,
     adjustScrollOffset,
     applyTierFilter,
@@ -1015,7 +1048,7 @@ export async function runApp(cliArgs, config) {
     refreshAutoPingMode()
     state.frame++
     // 📖 Cache visible+sorted models each frame so Enter handler always matches the display
-    if (!state.settingsOpen && !state.installEndpointsOpen && !state.toolInstallPromptOpen && !state.incompatibleFallbackOpen && !state.recommendOpen && !state.feedbackOpen && !state.changelogOpen && !state.installedModelsOpen && !state.commandPaletteOpen) {
+    if (!state.settingsOpen && !state.installEndpointsOpen && !state.toolInstallPromptOpen && !state.incompatibleFallbackOpen && !state.recommendOpen && !state.feedbackOpen && !state.changelogOpen && !state.installedModelsOpen && !state.routerDashboardOpen && !state.commandPaletteOpen) {
       const visible = state.results.filter(r => !r.hidden)
       state.visibleSorted = sortResultsWithPinnedFavorites(visible, state.sortColumn, state.sortDirection, {
         pinFavorites: state.favoritesPinnedAndSticky,
@@ -1058,7 +1091,12 @@ export async function runApp(cliArgs, config) {
           state.lastReleaseDate,
           state.footerHidden,
           state.verdictFilterMode,
-          state.healthFilterMode
+          state.healthFilterMode,
+          state.routerFooterRunning,
+          state.routerFooterActiveSet,
+          state.routerFooterTodayTokens,
+          state.routerFooterAllTimeTokens,
+          state.routerFooterRequests
         )
       }
       tableContent = state.commandPaletteFrozenTable
@@ -1096,10 +1134,21 @@ export async function runApp(cliArgs, config) {
         state.lastReleaseDate,
         state.footerHidden,
         state.verdictFilterMode,
-        state.healthFilterMode
+        state.healthFilterMode,
+        state.routerFooterRunning,
+        state.routerFooterActiveSet,
+        state.routerFooterTodayTokens,
+        state.routerFooterAllTimeTokens,
+        state.routerFooterRequests
       )
     }
 
+    // 📖 Router upgrade banner: inline notification for existing users not yet seen router
+    if (!state.routerOnboardingOpen && !state.settingsOpen && !state.installEndpointsOpen && !state.toolInstallPromptOpen && !state.installedModelsOpen && !state.routerDashboardOpen && !state.tokenUsageOpen && !state.commandPaletteOpen && !state.recommendOpen && !state.feedbackOpen && !state.helpVisible && !state.changelogOpen && !state.incompatibleFallbackOpen) {
+      const banner = overlays.renderRouterUpgradeBanner()
+      if (banner) tableContent = banner + '\n' + tableContent
+    }
+
     const content = state.settingsOpen
       ? overlays.renderSettings()
       : state.installEndpointsOpen
@@ -1108,6 +1157,12 @@ export async function runApp(cliArgs, config) {
         ? overlays.renderToolInstallPrompt()
       : state.installedModelsOpen
         ? overlays.renderInstalledModels()
+      : state.routerDashboardOpen
+        ? overlays.renderRouterDashboard()
+      : state.tokenUsageOpen
+        ? overlays.renderTokenUsage()
+      : state.routerOnboardingOpen
+        ? overlays.renderRouterOnboarding()
       : state.incompatibleFallbackOpen
         ? overlays.renderIncompatibleFallback()
       : state.commandPaletteOpen
@@ -1228,6 +1283,57 @@ export async function runApp(cliArgs, config) {
     } catch {}
   }, VERSION_RECHECK_INTERVAL_MS)
 
+  // 📖 Router footer stats: poll daemon every 30s so the main table footer always
+  // 📖 shows live token counts and daemon status even when the Router Dashboard is closed.
+  const ROUTER_FOOTER_POLL_INTERVAL_MS = 30_000
+  const ROUTER_FOOTER_FETCH_TIMEOUT_MS = 1200
+
+  async function fetchRouterFooterStats() {
+    try {
+      const controller = new AbortController()
+      const timer = setTimeout(() => controller.abort(), ROUTER_FOOTER_FETCH_TIMEOUT_MS)
+      const pidPath = `${process.env.HOME}/.free-coding-models-daemon.pid`
+      const portPath = `${process.env.HOME}/.free-coding-models-daemon.port`
+      let port = 19280
+      try {
+        const { readFileSync: rfs } = await import('node:fs')
+        const savedPort = rfs(portPath, 'utf8').trim()
+        if (/^\d+$/.test(savedPort)) port = Number(savedPort)
+      } catch {}
+      const res = await globalThis.fetch(`http://127.0.0.1:${port}/stats`, {
+        signal: controller.signal,
+      })
+      clearTimeout(timer)
+      if (!res.ok) { state.routerFooterRunning = false; return }
+      const raw = await res.json()
+      const tokens = raw.tokens || {}
+      const today = tokens.today || {}
+      const allTime = tokens.all_time || {}
+      state.routerFooterRunning = true
+      state.routerFooterActiveSet = raw.activeSet || null
+      state.routerFooterTodayTokens = today.total_tokens || 0
+      state.routerFooterAllTimeTokens = allTime.total_tokens || 0
+      state.routerFooterRequests = today.requests || 0
+      state.routerFooterLastFetchAt = Date.now()
+    } catch {
+      state.routerFooterRunning = false
+    }
+  }
+
+  state.routerFooterPollTimer = setInterval(() => {
+    void fetchRouterFooterStats()
+  }, ROUTER_FOOTER_POLL_INTERVAL_MS)
+  void fetchRouterFooterStats() // 📖 Initial fetch immediately so footer is populated on first render
+
+  // 📖 Router ON by default — no onboarding prompt, just auto-enable silently.
+  const routerCfg = state.config?.router
+  if (!routerCfg || routerCfg.onboardingSeen !== true || routerCfg.enabled !== true) {
+    if (!state.config.router) state.config.router = {}
+    state.config.router.enabled = true
+    state.config.router.onboardingSeen = true
+    saveConfig(state.config)
+  }
+
   // 📖 Keep interface running forever - user can select anytime or Ctrl+C to exit
   // 📖 The pings continue running in background with dynamic interval
   // 📖 User can press W to decrease interval (faster pings) or = to increase (slower)

package/src/cache.js

@@ -14,7 +14,7 @@
  *   {
  *     "timestamp": 1712345678901,           // Last cache write time (ms since epoch)
  *     "models": {
- *       "nvidia/deepseek-v3.2": {
+ *       "nvidia/deepseek-ai/deepseek-v4-flash": {
  *         "avg": 245,
  *         "p95": 312,
  *         "jitter": 45,

package/src/cli-help.js

@@ -37,6 +37,11 @@ const ANALYSIS_FLAGS = [
 
 const CONFIG_FLAGS = [
   { flag: '--web', description: 'Launch the web dashboard in your browser' },
+  { flag: '--daemon', description: 'Start the FCM Router daemon in the foreground' },
+  { flag: '--daemon-bg', description: 'Start the FCM Router daemon in the background' },
+  { flag: '--daemon-status', description: 'Print FCM Router daemon status JSON' },
+  { flag: '--daemon-stop', description: 'Gracefully stop the FCM Router daemon' },
+  { flag: '--sync-set [name]', description: 'Auto-discover and live-probe models into a router set' },
   { flag: '--no-telemetry', description: 'Disable anonymous telemetry for this run' },
   { flag: '--help, -h', description: 'Print this help and exit' },
 ]
@@ -44,6 +49,10 @@ const CONFIG_FLAGS = [
 const EXAMPLES = [
   'free-coding-models --help',
   'free-coding-models --web',
+  'free-coding-models --daemon-bg',
+  'free-coding-models --daemon-status',
+  'free-coding-models --sync-set',
+  'free-coding-models --sync-set my-coding-set',
   'free-coding-models --openclaw --tier S',
   "free-coding-models --json | jq '.[0]'",
 ]

package/src/command-palette.js

@@ -16,6 +16,18 @@
  */
 
 import { TOOL_METADATA, TOOL_MODE_ORDER } from './tool-metadata.js'
+import { sources } from '../sources.js'
+
+const PROVIDER_FILTER_COMMANDS = Object.entries(sources).map(([providerKey, source]) => {
+  const label = source?.name || providerKey
+  return {
+    id: `filter-provider-${providerKey.replace(/[^a-z0-9]+/gi, '-')}`,
+    label,
+    providerKey,
+    description: `${label} models`,
+    keywords: ['filter', 'provider', 'origin', providerKey, label.toLowerCase()],
+  }
+})
 
 const TOOL_MODE_DESCRIPTIONS = {
   opencode: 'Launch in OpenCode CLI with the selected model.',
@@ -119,17 +131,7 @@ const BASE_COMMAND_TREE = [
         children: [
           { id: 'filter-provider-cycle', label: 'Cycle provider', shortcut: 'D', description: 'Switch between providers', keywords: ['filter', 'provider', 'origin'] },
           { id: 'filter-provider-all', label: 'All providers', providerKey: null, description: 'Show all providers', keywords: ['filter', 'provider', 'all'] },
-          { id: 'filter-provider-nvidia', label: 'NVIDIA NIM', providerKey: 'nvidiaNim', description: 'NVIDIA models', keywords: ['filter', 'provider', 'nvidia', 'nim'] },
-          { id: 'filter-provider-groq', label: 'Groq', providerKey: 'groq', description: 'Groq models', keywords: ['filter', 'provider', 'groq'] },
-          { id: 'filter-provider-cerebras', label: 'Cerebras', providerKey: 'cerebras', description: 'Cerebras models', keywords: ['filter', 'provider', 'cerebras'] },
-          { id: 'filter-provider-sambanova', label: 'SambaNova', providerKey: 'sambanova', description: 'SambaNova models', keywords: ['filter', 'provider', 'sambanova'] },
-          { id: 'filter-provider-openrouter', label: 'OpenRouter', providerKey: 'openrouter', description: 'OpenRouter models', keywords: ['filter', 'provider', 'openrouter'] },
-          { id: 'filter-provider-together', label: 'Together AI', providerKey: 'together', description: 'Together models', keywords: ['filter', 'provider', 'together'] },
-          { id: 'filter-provider-deepinfra', label: 'DeepInfra', providerKey: 'deepinfra', description: 'DeepInfra models', keywords: ['filter', 'provider', 'deepinfra'] },
-          { id: 'filter-provider-fireworks', label: 'Fireworks AI', providerKey: 'fireworks', description: 'Fireworks models', keywords: ['filter', 'provider', 'fireworks'] },
-          { id: 'filter-provider-hyperbolic', label: 'Hyperbolic', providerKey: 'hyperbolic', description: 'Hyperbolic models', keywords: ['filter', 'provider', 'hyperbolic'] },
-          { id: 'filter-provider-google', label: 'Google AI', providerKey: 'google', description: 'Google models', keywords: ['filter', 'provider', 'google'] },
-          { id: 'filter-provider-huggingface', label: 'Hugging Face', providerKey: 'huggingface', description: 'Hugging Face models', keywords: ['filter', 'provider', 'huggingface'] },
+          ...PROVIDER_FILTER_COMMANDS,
         ]
       },
       {
@@ -199,7 +201,7 @@ const BASE_COMMAND_TREE = [
         ],
       },
       { id: 'action-cycle-theme', label: 'Cycle theme', shortcut: 'G', icon: '🌗', description: 'Switch dark/light/auto', keywords: ['theme', 'dark', 'light', 'auto'] },
-      { id: 'action-reset-view', label: 'Reset view', shortcut: 'Shift+R', icon: '🔄', description: 'Reset filters and sort', keywords: ['reset', 'view', 'sort', 'filters'] },
+      { id: 'action-reset-view', label: 'Reset view', icon: '🔄', description: 'Reset filters and sort', keywords: ['reset', 'view', 'sort', 'filters'] },
     ],
   },
   // 📖 Pages - directly at root level, not in submenu
@@ -208,6 +210,8 @@ const BASE_COMMAND_TREE = [
   { id: 'open-changelog', label: 'Changelog', shortcut: 'N', icon: '📋', type: 'page', description: 'Version history', keywords: ['changelog', 'release'] },
   { id: 'open-feedback', label: 'Feedback', shortcut: 'I', icon: '📝', type: 'page', description: 'Report bugs or requests', keywords: ['feedback', 'bug', 'request'] },
   { id: 'open-recommend', label: 'Smart recommend', shortcut: 'Q', icon: '🎯', type: 'page', description: 'Find best model for task', keywords: ['recommend', 'best model'] },
+  { id: 'open-router-dashboard', label: 'Router dashboard', shortcut: 'Shift+R', icon: '🔀', type: 'page', description: 'Inspect daemon health, circuits, tokens, and request log', keywords: ['router', 'daemon', 'dashboard', 'health', 'stats', 'tokens', 'circuit'] },
+  { id: 'open-token-usage', label: 'Token usage', shortcut: 'Shift+T', icon: '📊', type: 'page', description: 'View token usage history, 7-day chart, today/all-time totals', keywords: ['token', 'usage', 'chart', 'history', 'router'] },
   { id: 'open-install-endpoints', label: 'Install endpoints', icon: '🔌', type: 'page', description: 'Install provider catalogs', keywords: ['install', 'endpoints', 'providers'] },
   { id: 'open-installed-models', label: 'Installed models', icon: '🗂️', type: 'page', description: 'View models configured in tools', keywords: ['installed', 'models', 'configured', 'tools', 'manager', 'goose', 'crush', 'aider'] },
 ]