free-coding-models 0.2.15 → 0.3.0

package/src/overlays.js

@@ -4,20 +4,28 @@
  *
  * @details
  *   This module centralizes all overlay rendering in one place:
- *   - Settings, Install Endpoints, Help, Log, Smart Recommend, Feature Request, Bug Report, Changelog
+ *   - Settings, Install Endpoints, Help, Log, Smart Recommend, Feedback, Changelog
+ *   - FCM Proxy V2 overlay with tool selector, auto-sync toggle, and cleanup
  *   - Settings diagnostics for provider key tests, including wrapped retry/error details
  *   - Recommend analysis timer orchestration and progress updates
  *
  *   The factory pattern keeps stateful UI logic isolated while still
  *   allowing the main CLI to control shared state and dependencies.
  *
+ *   📖 The proxy overlay rows are: Enable → Active tool → Auto-sync → Port → Cleanup → Install/Restart/Stop/Kill/Logs
+ *   📖 Tool selector cycles through PROXY_SYNCABLE_TOOLS (12 tools from proxy-sync.js)
+ *   📖 Feedback overlay (I key) combines feature requests + bug reports in one left-aligned input
+ *
  *   → Functions:
  *   - `createOverlayRenderers` — returns renderer + analysis helpers
  *
  * @exports { createOverlayRenderers }
+ * @see ./proxy-sync.js — PROXY_SYNCABLE_TOOLS used by the tool selector
+ * @see ./key-handler.js — handles keypresses for all overlay interactions
  */
 
 import { loadChangelog } from './changelog-loader.js'
+import { PROXY_SYNCABLE_TOOLS } from './proxy-sync.js'
 
 export function createOverlayRenderers(state, deps) {
   const {
@@ -55,6 +63,8 @@ export function createOverlayRenderers(state, deps) {
     getConfiguredInstallableProviders,
     getInstallTargetModes,
     getProviderCatalogModels,
+    CONNECTION_MODES,
+    getToolMeta,
   } = deps
 
   // 📖 Wrap plain diagnostic text so long Settings messages stay readable inside
@@ -136,11 +146,8 @@ export function createOverlayRenderers(state, deps) {
   function renderSettings() {
     const providerKeys = Object.keys(sources)
     const updateRowIdx = providerKeys.length
-    const proxyEnabledRowIdx = updateRowIdx + 1
-    const proxySyncRowIdx = updateRowIdx + 2
-    const proxyPortRowIdx = updateRowIdx + 3
-    const proxyCleanupRowIdx = updateRowIdx + 4
-    const changelogViewRowIdx = updateRowIdx + 5
+    const proxyDaemonRowIdx = updateRowIdx + 1
+    const changelogViewRowIdx = updateRowIdx + 2
     const proxySettings = getProxySettings(state.config)
     const EL = '\x1b[K'
     const lines = []
@@ -271,33 +278,23 @@ export function createOverlayRenderers(state, deps) {
       lines.push(chalk.red(`      ${state.settingsUpdateError}`))
     }
 
+    // 📖 FCM Proxy V2 — single row that opens a dedicated overlay
     lines.push('')
-    lines.push(`  ${chalk.bold('🔀 Proxy')}`)
+    lines.push(`  ${chalk.bold('📡 FCM Proxy V2')}`)
     lines.push(`  ${chalk.dim('  ' + '─'.repeat(separatorWidth))}`)
     lines.push('')
 
-    const proxyEnabledBullet = state.settingsCursor === proxyEnabledRowIdx ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
-    const proxyEnabledRow = `${proxyEnabledBullet}${chalk.bold('Proxy mode (opt-in)').padEnd(44)} ${proxySettings.enabled ? chalk.greenBright('Enabled') : chalk.dim('Disabled by default')}`
-    cursorLineByRow[proxyEnabledRowIdx] = lines.length
-    lines.push(state.settingsCursor === proxyEnabledRowIdx ? chalk.bgRgb(20, 45, 60)(proxyEnabledRow) : proxyEnabledRow)
-
-    const proxySyncBullet = state.settingsCursor === proxySyncRowIdx ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
-    const proxySyncRow = `${proxySyncBullet}${chalk.bold('Persist proxy in OpenCode').padEnd(44)} ${proxySettings.syncToOpenCode ? chalk.greenBright('Enabled') : chalk.dim('Disabled')}`
-    cursorLineByRow[proxySyncRowIdx] = lines.length
-    lines.push(state.settingsCursor === proxySyncRowIdx ? chalk.bgRgb(20, 45, 60)(proxySyncRow) : proxySyncRow)
-
-    const proxyPortBullet = state.settingsCursor === proxyPortRowIdx ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
-    const proxyPortValue = state.settingsProxyPortEditMode && state.settingsCursor === proxyPortRowIdx
-      ? chalk.cyanBright(`${state.settingsProxyPortBuffer}▏`)
-      : (proxySettings.preferredPort === 0 ? chalk.dim('auto (OS-assigned)') : chalk.green(String(proxySettings.preferredPort)))
-    const proxyPortRow = `${proxyPortBullet}${chalk.bold('Preferred proxy port').padEnd(44)} ${proxyPortValue}`
-    cursorLineByRow[proxyPortRowIdx] = lines.length
-    lines.push(state.settingsCursor === proxyPortRowIdx ? chalk.bgRgb(20, 45, 60)(proxyPortRow) : proxyPortRow)
-
-    const proxyCleanupBullet = state.settingsCursor === proxyCleanupRowIdx ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
-    const proxyCleanupRow = `${proxyCleanupBullet}${chalk.bold('Clean OpenCode proxy config').padEnd(44)} ${chalk.dim('Enter removes fcm-proxy from opencode.json')}`
-    cursorLineByRow[proxyCleanupRowIdx] = lines.length
-    lines.push(state.settingsCursor === proxyCleanupRowIdx ? chalk.bgRgb(45, 30, 30)(proxyCleanupRow) : proxyCleanupRow)
+    const proxyDaemonBullet = state.settingsCursor === proxyDaemonRowIdx ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
+    const proxyStatus = proxySettings.enabled ? chalk.greenBright('Proxy ON') : chalk.dim('Proxy OFF')
+    const daemonStatus = state.daemonStatus || 'not-installed'
+    let daemonBadge
+    if (daemonStatus === 'running') daemonBadge = chalk.greenBright('Service ON')
+    else if (daemonStatus === 'stopped') daemonBadge = chalk.yellow('Service stopped')
+    else if (daemonStatus === 'stale' || daemonStatus === 'unhealthy') daemonBadge = chalk.red('Service ' + daemonStatus)
+    else daemonBadge = chalk.dim('Service OFF')
+    const proxyDaemonRow = `${proxyDaemonBullet}${chalk.bold('FCM Proxy V2 settings →').padEnd(44)} ${proxyStatus} ${chalk.dim('•')} ${daemonBadge}`
+    cursorLineByRow[proxyDaemonRowIdx] = lines.length
+    lines.push(state.settingsCursor === proxyDaemonRowIdx ? chalk.bgRgb(20, 45, 60)(proxyDaemonRow) : proxyDaemonRow)
 
     // 📖 Changelog viewer row
     const changelogViewBullet = state.settingsCursor === changelogViewRowIdx ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
@@ -307,7 +304,7 @@ export function createOverlayRenderers(state, deps) {
 
     // 📖 Profiles section — list saved profiles with active indicator + delete support
     const savedProfiles = listProfiles(state.config)
-    const profileStartIdx = updateRowIdx + 6
+    const profileStartIdx = updateRowIdx + 3
     const maxRowIdx = savedProfiles.length > 0 ? profileStartIdx + savedProfiles.length - 1 : updateRowIdx
 
     lines.push('')
@@ -377,7 +374,7 @@ export function createOverlayRenderers(state, deps) {
   }
 
   // ─── Install Endpoints overlay renderer ───────────────────────────────────
-  // 📖 renderInstallEndpoints drives the provider → tool → scope → model flow
+  // 📖 renderInstallEndpoints drives the provider → tool → connection → scope → model flow
   // 📖 behind the `Y` hotkey. It deliberately reuses the same overlay viewport
   // 📖 helpers as Settings so long provider/model lists stay navigable.
   function renderInstallEndpoints() {
@@ -386,6 +383,8 @@ export function createOverlayRenderers(state, deps) {
     const cursorLineByRow = {}
     const providerChoices = getConfiguredInstallableProviders(state.config)
     const toolChoices = getInstallTargetModes()
+    const connectionChoices = CONNECTION_MODES || []
+    const totalSteps = 5
     const scopeChoices = [
       {
         key: 'all',
@@ -401,18 +400,22 @@ export function createOverlayRenderers(state, deps) {
     const selectedProviderLabel = state.installEndpointsProviderKey
       ? (sources[state.installEndpointsProviderKey]?.name || state.installEndpointsProviderKey)
       : '—'
+
+    // 📖 Resolve tool label from metadata instead of hard-coded switch
     const selectedToolLabel = state.installEndpointsToolMode
-      ? (state.installEndpointsToolMode === 'opencode-desktop'
-          ? 'OpenCode Desktop (shared opencode.json)'
-          : (state.installEndpointsToolMode === 'opencode'
-              ? 'OpenCode CLI (shared opencode.json)'
-              : state.installEndpointsToolMode === 'openclaw'
-                ? 'OpenClaw'
-                : state.installEndpointsToolMode === 'crush'
-                  ? 'Crush'
-                  : 'Goose'))
+      ? (() => {
+          const meta = getToolMeta(state.installEndpointsToolMode)
+          const suffix = state.installEndpointsToolMode.startsWith('opencode') ? ' (shared opencode.json)' : ''
+          return `${meta.label}${suffix}`
+        })()
       : '—'
 
+    const selectedConnectionLabel = state.installEndpointsConnectionMode === 'proxy'
+      ? 'FCM Proxy V2'
+      : state.installEndpointsConnectionMode === 'direct'
+        ? 'Direct Provider'
+        : '—'
+
     lines.push('')
     // 📖 Branding header
     lines.push(`  ${chalk.cyanBright('🚀')} ${chalk.bold.cyanBright('free-coding-models')} ${chalk.dim(`v${LOCAL_VERSION}`)}`)
@@ -425,7 +428,7 @@ export function createOverlayRenderers(state, deps) {
     lines.push('')
 
     if (state.installEndpointsPhase === 'providers') {
-      lines.push(`  ${chalk.bold('Step 1/4')}  ${chalk.cyan('Choose a configured provider')}`)
+      lines.push(`  ${chalk.bold(`Step 1/${totalSteps}`)}  ${chalk.cyan('Choose a configured provider')}`)
       lines.push('')
 
       if (providerChoices.length === 0) {
@@ -435,7 +438,7 @@ export function createOverlayRenderers(state, deps) {
         providerChoices.forEach((provider, idx) => {
           const isCursor = idx === state.installEndpointsCursor
           const bullet = isCursor ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
-          const row = `${bullet}${chalk.bold(provider.label.padEnd(24))} ${chalk.dim(`${provider.modelCount} models`)}` 
+          const row = `${bullet}${chalk.bold(provider.label.padEnd(24))} ${chalk.dim(`${provider.modelCount} models`)}`
           cursorLineByRow[idx] = lines.length
           lines.push(isCursor ? chalk.bgRgb(24, 44, 62)(row) : row)
         })
@@ -444,37 +447,51 @@ export function createOverlayRenderers(state, deps) {
       lines.push('')
       lines.push(chalk.dim('  ↑↓ Navigate  •  Enter Choose provider  •  Esc Close'))
     } else if (state.installEndpointsPhase === 'tools') {
-      lines.push(`  ${chalk.bold('Step 2/4')}  ${chalk.cyan('Choose the target tool')}`)
+      lines.push(`  ${chalk.bold(`Step 2/${totalSteps}`)}  ${chalk.cyan('Choose the target tool')}`)
       lines.push(chalk.dim(`  Provider: ${selectedProviderLabel}`))
       lines.push('')
 
+      // 📖 Use getToolMeta for labels instead of hard-coded ternary chains
       toolChoices.forEach((toolMode, idx) => {
         const isCursor = idx === state.installEndpointsCursor
-        const label = toolMode === 'opencode-desktop'
-          ? 'OpenCode Desktop'
-          : toolMode === 'opencode'
-            ? 'OpenCode CLI'
-            : toolMode === 'openclaw'
-              ? 'OpenClaw'
-              : toolMode === 'crush'
-                ? 'Crush'
-                : 'Goose'
+        const meta = getToolMeta(toolMode)
+        const label = `${meta.emoji} ${meta.label}`
         const note = toolMode.startsWith('opencode')
           ? chalk.dim('shared config file')
-          : chalk.dim('managed provider install')
+          : ['claude-code', 'codex', 'openhands'].includes(toolMode)
+            ? chalk.dim('env file (~/.fcm-*-env)')
+            : chalk.dim('managed config install')
         const bullet = isCursor ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
-        const row = `${bullet}${chalk.bold(label.padEnd(22))} ${note}`
+        const row = `${bullet}${chalk.bold(label.padEnd(26))} ${note}`
         cursorLineByRow[idx] = lines.length
         lines.push(isCursor ? chalk.bgRgb(24, 44, 62)(row) : row)
       })
 
       lines.push('')
       lines.push(chalk.dim('  ↑↓ Navigate  •  Enter Choose tool  •  Esc Back'))
-    } else if (state.installEndpointsPhase === 'scope') {
-      lines.push(`  ${chalk.bold('Step 3/4')}  ${chalk.cyan('Choose the install scope')}`)
+    } else if (state.installEndpointsPhase === 'connection') {
+      // 📖 Step 3: Choose connection mode — Direct Provider vs FCM Proxy
+      lines.push(`  ${chalk.bold(`Step 3/${totalSteps}`)}  ${chalk.cyan('Choose connection mode')}`)
       lines.push(chalk.dim(`  Provider: ${selectedProviderLabel}  •  Tool: ${selectedToolLabel}`))
       lines.push('')
 
+      connectionChoices.forEach((mode, idx) => {
+        const isCursor = idx === state.installEndpointsCursor
+        const bullet = isCursor ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
+        const icon = mode.key === 'proxy' ? '🔄' : '⚡'
+        const row = `${bullet}${icon} ${chalk.bold(mode.label)}`
+        cursorLineByRow[idx] = lines.length
+        lines.push(isCursor ? chalk.bgRgb(24, 44, 62)(row) : row)
+        lines.push(chalk.dim(`      ${mode.hint}`))
+        lines.push('')
+      })
+
+      lines.push(chalk.dim('  Enter Continue  •  Esc Back'))
+    } else if (state.installEndpointsPhase === 'scope') {
+      lines.push(`  ${chalk.bold(`Step 4/${totalSteps}`)}  ${chalk.cyan('Choose the install scope')}`)
+      lines.push(chalk.dim(`  Provider: ${selectedProviderLabel}  •  Tool: ${selectedToolLabel}  •  ${selectedConnectionLabel}`))
+      lines.push('')
+
       scopeChoices.forEach((scope, idx) => {
         const isCursor = idx === state.installEndpointsCursor
         const bullet = isCursor ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
@@ -490,8 +507,8 @@ export function createOverlayRenderers(state, deps) {
       const models = getProviderCatalogModels(state.installEndpointsProviderKey)
       const selectedCount = state.installEndpointsSelectedModelIds.size
 
-      lines.push(`  ${chalk.bold('Step 4/4')}  ${chalk.cyan('Choose which models to install')}`)
-      lines.push(chalk.dim(`  Provider: ${selectedProviderLabel}  •  Tool: ${selectedToolLabel}`))
+      lines.push(`  ${chalk.bold(`Step 5/${totalSteps}`)}  ${chalk.cyan('Choose which models to install')}`)
+      lines.push(chalk.dim(`  Provider: ${selectedProviderLabel}  •  Tool: ${selectedToolLabel}  •  ${selectedConnectionLabel}`))
       lines.push(chalk.dim(`  Selected: ${selectedCount}/${models.length}`))
       lines.push('')
 
@@ -608,12 +625,12 @@ export function createOverlayRenderers(state, deps) {
     lines.push(`  ${chalk.yellow('W')}  Toggle ping mode  ${chalk.dim('(speed 2s → normal 10s → slow 30s → forced 4s)')}`)
     lines.push(`  ${chalk.yellow('E')}  Toggle configured models only  ${chalk.dim('(enabled by default, persisted globally + in profiles)')}`)
     lines.push(`  ${chalk.yellow('X')}  Toggle token log page  ${chalk.dim('(shows recent request usage from request-log.jsonl)')}`)
-    lines.push(`  ${chalk.yellow('Z')}  Cycle tool mode  ${chalk.dim('(OpenCode → Desktop → OpenClaw → Crush → Goose)')}`)
+    lines.push(`  ${chalk.yellow('Z')}  Cycle tool mode  ${chalk.dim('(OpenCode → Desktop → OpenClaw → Crush → Goose → Pi → Aider → Claude Code → Codex → Gemini → Qwen → OpenHands → Amp)')}`)
     lines.push(`  ${chalk.yellow('F')}  Toggle favorite on selected row  ${chalk.dim('(⭐ pinned at top, persisted)')}`)
-    lines.push(`  ${chalk.yellow('Y')}  Install endpoints  ${chalk.dim('(provider catalog → OpenCode/OpenClaw/Crush/Goose, no proxy)')}`)
+    lines.push(`  ${chalk.yellow('Y')}  Install endpoints  ${chalk.dim('(provider catalog → all tools, Direct or FCM Proxy V2)')}`)
     lines.push(`  ${chalk.yellow('Q')}  Smart Recommend  ${chalk.dim('(🎯 find the best model for your task — questionnaire + live analysis)')}`)
-    lines.push(`  ${chalk.rgb(57, 255, 20).bold('J')}  Request Feature  ${chalk.dim('(📝 send anonymous feedback to the project team)')}`)
-    lines.push(`  ${chalk.rgb(255, 87, 51).bold('I')}  Report Bug  ${chalk.dim('(🐛 send anonymous bug report to the project team)')}`)
+    lines.push(`  ${chalk.rgb(255, 87, 51).bold('I')}  Feedback, bugs & requests  ${chalk.dim('(📝 send anonymous feedback, bug reports, or feature requests)')}`)
+    lines.push(`  ${chalk.yellow('J')}  FCM Proxy V2 settings  ${chalk.dim('(📡 open proxy configuration and background service management)')}`)
     lines.push(`  ${chalk.yellow('P')}  Open settings  ${chalk.dim('(manage API keys, provider toggles, proxy, manual update)')}`)
     lines.push(`  ${chalk.yellow('Shift+P')}  Cycle config profile  ${chalk.dim('(switch between saved profiles live)')}`)
     lines.push(`  ${chalk.yellow('Shift+S')}  Save current config as a named profile  ${chalk.dim('(inline prompt — type name + Enter)')}`)
@@ -641,15 +658,14 @@ export function createOverlayRenderers(state, deps) {
     lines.push(`  ${chalk.cyan('free-coding-models --openclaw')}           ${chalk.dim('OpenClaw mode')}`)
     lines.push(`  ${chalk.cyan('free-coding-models --crush')}              ${chalk.dim('Crush mode')}`)
     lines.push(`  ${chalk.cyan('free-coding-models --goose')}              ${chalk.dim('Goose mode')}`)
-    // 📖 Temporarily disabled launchers kept out of the public help until their flows are hardened.
-    // lines.push(`  ${chalk.cyan('free-coding-models --aider')}              ${chalk.dim('Aider mode')}`)
-    // lines.push(`  ${chalk.cyan('free-coding-models --claude-code')}        ${chalk.dim('Claude Code proxy mode')}`)
-    // lines.push(`  ${chalk.cyan('free-coding-models --codex')}              ${chalk.dim('Codex CLI proxy mode')}`)
-    // lines.push(`  ${chalk.cyan('free-coding-models --gemini')}             ${chalk.dim('Gemini CLI proxy mode')}`)
-    // lines.push(`  ${chalk.cyan('free-coding-models --qwen')}               ${chalk.dim('Qwen Code mode')}`)
-    // lines.push(`  ${chalk.cyan('free-coding-models --openhands')}          ${chalk.dim('OpenHands mode')}`)
-    // lines.push(`  ${chalk.cyan('free-coding-models --amp')}                ${chalk.dim('Amp mode')}`)
-    // lines.push(`  ${chalk.cyan('free-coding-models --pi')}                 ${chalk.dim('Pi mode')}`)
+    lines.push(`  ${chalk.cyan('free-coding-models --pi')}                 ${chalk.dim('Pi mode')}`)
+    lines.push(`  ${chalk.cyan('free-coding-models --aider')}              ${chalk.dim('Aider mode')}`)
+    lines.push(`  ${chalk.cyan('free-coding-models --claude-code')}        ${chalk.dim('Claude Code mode')}`)
+    lines.push(`  ${chalk.cyan('free-coding-models --codex')}              ${chalk.dim('Codex CLI mode')}`)
+    lines.push(`  ${chalk.cyan('free-coding-models --gemini')}             ${chalk.dim('Gemini CLI mode')}`)
+    lines.push(`  ${chalk.cyan('free-coding-models --qwen')}               ${chalk.dim('Qwen Code mode')}`)
+    lines.push(`  ${chalk.cyan('free-coding-models --openhands')}          ${chalk.dim('OpenHands mode')}`)
+    lines.push(`  ${chalk.cyan('free-coding-models --amp')}                ${chalk.dim('Amp mode')}`)
     lines.push(`  ${chalk.cyan('free-coding-models --best')}               ${chalk.dim('Only top tiers (A+, S, S+)')}`)
     lines.push(`  ${chalk.cyan('free-coding-models --fiable')}             ${chalk.dim('10s reliability analysis')}`)
     lines.push(`  ${chalk.cyan('free-coding-models --tier S|A|B|C')}       ${chalk.dim('Filter by tier letter')}`)
@@ -1036,117 +1052,10 @@ export function createOverlayRenderers(state, deps) {
     }, PING_RATE)
   }
 
-  // ─── Feature Request overlay renderer ─────────────────────────────────────
-  // 📖 renderFeatureRequest: Draw the overlay for anonymous Discord feedback.
-  // 📖 Shows an input field where users can type feature requests, then sends to Discord webhook.
-  function renderFeatureRequest() {
-    const EL = '\x1b[K'
-    const lines = []
-
-    // 📖 Calculate available space for multi-line input (dynamic based on terminal width)
-    const maxInputWidth = state.terminalCols - 8 // 8 = padding (4 spaces each side)
-    const maxInputLines = 10 // Show up to 10 lines of input
-    
-    // 📖 Split buffer into lines for display (with wrapping)
-    const wrapText = (text, width) => {
-      const words = text.split(' ')
-      const lines = []
-      let currentLine = ''
-      
-      for (const word of words) {
-        const testLine = currentLine ? currentLine + ' ' + word : word
-        if (testLine.length <= width) {
-          currentLine = testLine
-        } else {
-          if (currentLine) lines.push(currentLine)
-          currentLine = word
-        }
-      }
-      if (currentLine) lines.push(currentLine)
-      return lines
-    }
-
-    const inputLines = wrapText(state.featureRequestBuffer, maxInputWidth)
-    const displayLines = inputLines.slice(0, maxInputLines)
-
-    // 📖 Branding header
-    lines.push('')
-    lines.push(`  ${chalk.cyanBright('🚀')} ${chalk.bold.cyanBright('free-coding-models')} ${chalk.dim(`v${LOCAL_VERSION}`)}`)
-    lines.push(`  ${chalk.bold.rgb(57, 255, 20)('📝 Feature Request')}`)
-    lines.push('')
-    lines.push(chalk.dim('  — send anonymous feedback to the project team'))
-    lines.push('')
-    
-    // 📖 Status messages (if any)
-    if (state.featureRequestStatus === 'sending') {
-      lines.push(`  ${chalk.yellow('⏳ Sending...')}`)
-      lines.push('')
-    } else if (state.featureRequestStatus === 'success') {
-      lines.push(`  ${chalk.greenBright.bold('✅ Successfully sent!')} ${chalk.dim('Closing overlay in 3 seconds...')}`)
-      lines.push('')
-      lines.push(`  ${chalk.dim('Thank you for your feedback! Your feature request has been sent to the project team.')}`)
-      lines.push('')
-    } else if (state.featureRequestStatus === 'error') {
-      lines.push(`  ${chalk.red('❌ Error:')} ${chalk.yellow(state.featureRequestError || 'Failed to send')}`)
-      lines.push(`  ${chalk.dim('Press Backspace to edit, or Esc to close')}`)
-      lines.push('')
-    } else {
-      lines.push(`  ${chalk.dim('Type your feature request below. Press Enter to send, Esc to cancel.')}`)
-      lines.push(`  ${chalk.dim('Your message will be sent anonymously to the project team.')}`)
-      lines.push('')
-    }
-
-    // 📖 Input box with border
-    lines.push(chalk.dim(`  ┌─ ${chalk.cyan('Message')} ${chalk.dim(`(${state.featureRequestBuffer.length}/500 chars)`)} ─${'─'.repeat(maxInputWidth - 22)}┐`))
-    
-    // 📖 Display input lines (or placeholder if empty)
-    if (displayLines.length === 0 && state.featureRequestStatus === 'idle') {
-      lines.push(chalk.dim(`  │${' '.repeat(maxInputWidth)}│`))
-      lines.push(chalk.dim(`  │  ${chalk.white.italic('Type your message here...')}${' '.repeat(Math.max(0, maxInputWidth - 28))}│`))
-    } else {
-      for (const line of displayLines) {
-        const padded = line.padEnd(maxInputWidth)
-        lines.push(`  │ ${chalk.white(padded)} │`)
-      }
-    }
-    
-    // 📖 Fill remaining space if needed
-    const linesToFill = Math.max(0, maxInputLines - Math.max(displayLines.length, 1))
-    for (let i = 0; i < linesToFill; i++) {
-      lines.push(chalk.dim(`  │${' '.repeat(maxInputWidth)}│`))
-    }
-    
-    // 📖 Cursor indicator (only when not sending/success)
-    if (state.featureRequestStatus === 'idle' || state.featureRequestStatus === 'error') {
-      // Add cursor indicator to the last line
-      if (lines.length > 0 && displayLines.length > 0) {
-        const lastLineIdx = lines.findIndex(l => l.includes('│ ') && !l.includes('Message'))
-        if (lastLineIdx >= 0 && lastLineIdx < lines.length) {
-          // Add cursor blink
-          const lastLine = lines[lastLineIdx]
-          if (lastLine.includes('│')) {
-            lines[lastLineIdx] = lastLine.replace(/\s+│$/, chalk.rgb(57, 255, 20).bold('▏') + ' │')
-          }
-        }
-      }
-    }
-    
-    lines.push(chalk.dim(`  └${'─'.repeat(maxInputWidth + 2)}┘`))
-    
-    lines.push('')
-    lines.push(chalk.dim('  Enter Send  •  Esc Cancel  •  Backspace Delete'))
-
-    // 📖 Apply overlay tint and return
-    const FEATURE_REQUEST_OVERLAY_BG = chalk.bgRgb(0, 0, 0) // Dark blue-ish background (RGB: 26, 26, 46)
-    const tintedLines = tintOverlayLines(lines, FEATURE_REQUEST_OVERLAY_BG, state.terminalCols)
-    const cleared = tintedLines.map(l => l + EL)
-    return cleared.join('\n')
-  }
-
-  // ─── Bug Report overlay renderer ─────────────────────────────────────────
-  // 📖 renderBugReport: Draw the overlay for anonymous Discord bug reports.
-  // 📖 Shows an input field where users can type bug reports, then sends to Discord webhook.
-  function renderBugReport() {
+  // ─── Feedback overlay renderer ────────────────────────────────────────────
+  // 📖 renderFeedback: Draw the overlay for anonymous Discord feedback.
+  // 📖 Shows an input field where users can type feedback, bug reports, or any comments.
+  function renderFeedback() {
     const EL = '\x1b[K'
     const lines = []
 
@@ -1179,9 +1088,9 @@ export function createOverlayRenderers(state, deps) {
     // 📖 Branding header
     lines.push('')
     lines.push(`  ${chalk.cyanBright('🚀')} ${chalk.bold.cyanBright('free-coding-models')} ${chalk.dim(`v${LOCAL_VERSION}`)}`)
-    lines.push(`  ${chalk.bold.rgb(255, 87, 51)('🐛 Bug Report')}`)
+    lines.push(`  ${chalk.bold.rgb(57, 255, 20)('📝 Feedback, bugs & requests')}`)
     lines.push('')
-    lines.push(chalk.dim('  — send anonymous bug reports to the project team'))
+    lines.push(chalk.dim("  — don't hesitate to send us feedback, bug reports, or just your feeling about the app"))
     lines.push('')
     
     // 📖 Status messages (if any)
@@ -1191,55 +1100,35 @@ export function createOverlayRenderers(state, deps) {
     } else if (state.bugReportStatus === 'success') {
       lines.push(`  ${chalk.greenBright.bold('✅ Successfully sent!')} ${chalk.dim('Closing overlay in 3 seconds...')}`)
       lines.push('')
-      lines.push(`  ${chalk.dim('Thank you for your feedback! Your bug report has been sent to the project team.')}`)
+      lines.push(`  ${chalk.dim('Thank you for your feedback! It has been sent to the project team.')}`)
       lines.push('')
     } else if (state.bugReportStatus === 'error') {
       lines.push(`  ${chalk.red('❌ Error:')} ${chalk.yellow(state.bugReportError || 'Failed to send')}`)
       lines.push(`  ${chalk.dim('Press Backspace to edit, or Esc to close')}`)
       lines.push('')
     } else {
-      lines.push(`  ${chalk.dim('Describe the bug you encountered. Press Enter to send, Esc to cancel.')}`)
+      lines.push(`  ${chalk.dim('Type your feedback below. Press Enter to send, Esc to cancel.')}`)
       lines.push(`  ${chalk.dim('Your message will be sent anonymously to the project team.')}`)
       lines.push('')
     }
 
-    // 📖 Input box with border
-    lines.push(chalk.dim(`  ┌─ ${chalk.cyan('Bug Details')} ${chalk.dim(`(${state.bugReportBuffer.length}/500 chars)`)} ─${'─'.repeat(maxInputWidth - 24)}┐`))
-    
-    // 📖 Display input lines (or placeholder if empty)
-    if (displayLines.length === 0 && state.bugReportStatus === 'idle') {
-      lines.push(chalk.dim(`  │${' '.repeat(maxInputWidth)}│`))
-      lines.push(chalk.dim(`  │  ${chalk.white.italic('Describe what happened...')}${' '.repeat(Math.max(0, maxInputWidth - 31))}│`))
-    } else {
+    // 📖 Simple input area – left-aligned, framed by horizontal lines
+    lines.push(`  ${chalk.cyan('Message')} (${state.bugReportBuffer.length}/500 chars)`)
+    lines.push(`  ${chalk.dim('─'.repeat(maxInputWidth))}`)
+    // 📖 Input lines — left-aligned, or placeholder when empty
+    if (displayLines.length > 0) {
       for (const line of displayLines) {
-        const padded = line.padEnd(maxInputWidth)
-        lines.push(`  │ ${chalk.white(padded)} │`)
+        lines.push(`    ${line}`)
       }
-    }
-    
-    // 📖 Fill remaining space if needed
-    const linesToFill = Math.max(0, maxInputLines - Math.max(displayLines.length, 1))
-    for (let i = 0; i < linesToFill; i++) {
-      lines.push(chalk.dim(`  │${' '.repeat(maxInputWidth)}│`))
-    }
-    
-    // 📖 Cursor indicator (only when not sending/success)
-    if (state.bugReportStatus === 'idle' || state.bugReportStatus === 'error') {
-      // Add cursor indicator to the last line
-      if (lines.length > 0 && displayLines.length > 0) {
-        const lastLineIdx = lines.findIndex(l => l.includes('│ ') && !l.includes('Bug Details'))
-        if (lastLineIdx >= 0 && lastLineIdx < lines.length) {
-          // Add cursor blink
-          const lastLine = lines[lastLineIdx]
-          if (lastLine.includes('│')) {
-            lines[lastLineIdx] = lastLine.replace(/\s+│$/, chalk.rgb(255, 87, 51).bold('▏') + ' │')
-          }
-        }
+      // 📖 Show cursor on last line
+      if (state.bugReportStatus === 'idle' || state.bugReportStatus === 'error') {
+        lines[lines.length - 1] += chalk.cyanBright('▏')
       }
+    } else {
+      const placeholderBR = state.bugReportStatus === 'idle' ? chalk.white.italic('Type your message here...') : ''
+      lines.push(`    ${placeholderBR}${chalk.cyanBright('▏')}`)
     }
-    
-    lines.push(chalk.dim(`  └${'─'.repeat(maxInputWidth + 2)}┘`))
-    
+    lines.push(`  ${chalk.dim('─'.repeat(maxInputWidth))}`)
     lines.push('')
     lines.push(chalk.dim('  Enter Send  •  Esc Cancel  •  Backspace Delete'))
 
@@ -1290,12 +1179,32 @@ export function createOverlayRenderers(state, deps) {
           if (changes[key]) itemCount += changes[key].length
         }
 
-        // 📖 Format version line with selection highlight
-        const versionStr = `  v${version.padEnd(8)} — ${itemCount} ${itemCount === 1 ? 'change' : 'changes'}`
+        // 📖 Build a short summary from the first few items (max ~15 words, stripped of markdown)
+        const allItems = []
+        for (const k of ['added', 'fixed', 'changed', 'updated']) {
+          if (changes[k]) for (const item of changes[k]) allItems.push(item)
+        }
+        let summary = ''
+        if (allItems.length > 0) {
+          // 📖 Extract the bold title part if present, otherwise use the raw text
+          const firstItem = allItems[0]
+          const boldMatch = firstItem.match(/\*\*([^*]+)\*\*/)
+          const rawText = boldMatch ? boldMatch[1] : firstItem.replace(/\*\*([^*]+)\*\*/g, '$1').replace(/`([^`]+)`/g, '$1')
+          // 📖 Truncate to ~15 words max
+          const words = rawText.split(/\s+/).slice(0, 15)
+          summary = words.join(' ')
+          if (rawText.split(/\s+/).length > 15) summary += '…'
+        }
+
+        // 📖 Format version line with selection highlight + dim summary
+        const countStr = `${itemCount} ${itemCount === 1 ? 'change' : 'changes'}`
+        const prefix = `  v${version.padEnd(8)} — ${countStr}`
         if (isSelected) {
-          lines.push(chalk.inverse(versionStr))
+          const full = summary ? `${prefix} · ${summary}` : prefix
+          lines.push(chalk.inverse(full))
         } else {
-          lines.push(versionStr)
+          const dimSummary = summary ? chalk.dim(` · ${summary}`) : ''
+          lines.push(`${prefix}${dimSummary}`)
         }
       }
 
@@ -1332,6 +1241,17 @@ export function createOverlayRenderers(state, deps) {
       }
     }
 
+    // 📖 Keep selected changelog row visible by scrolling the overlay viewport (index phase)
+    if (state.changelogPhase === 'index') {
+      const targetLine = 4 + state.changelogCursor  // 📖 3 header lines + 1 blank = versions start at line 4
+      state.changelogScrollOffset = keepOverlayTargetVisible(
+        state.changelogScrollOffset,
+        targetLine,
+        lines.length,
+        state.terminalRows
+      )
+    }
+
     // 📖 Use scrolling with overlay handler
     const CHANGELOG_OVERLAY_BG = chalk.bgRgb(10, 40, 80)  // Dark blue background
     const { visible, offset } = sliceOverlayLines(lines, state.changelogScrollOffset, state.terminalRows)
@@ -1341,6 +1261,226 @@ export function createOverlayRenderers(state, deps) {
     return cleared.join('\n')
   }
 
+  // ─── FCM Proxy V2 overlay renderer ──────────────────────────────────────────
+  // 📖 renderProxyDaemon: Dedicated full-page overlay for FCM Proxy V2 configuration
+  // 📖 and background service management. Opened from Settings → "FCM Proxy V2 settings →".
+  // 📖 Contains all proxy toggles, service status/actions, explanations, and emergency kill.
+  function renderProxyDaemon() {
+    const EL = '\x1b[K'
+    const lines = []
+    const cursorLineByRow = {}
+    const proxySettings = getProxySettings(state.config)
+
+    // 📖 Row indices — these control cursor navigation
+    const ROW_PROXY_ENABLED = 0
+    const ROW_PROXY_TOOL = 1
+    const ROW_PROXY_SYNC = 2
+    const ROW_PROXY_PORT = 3
+    const ROW_PROXY_CLEANUP = 4
+    const ROW_DAEMON_INSTALL = 5
+    const ROW_DAEMON_RESTART = 6
+    const ROW_DAEMON_STOP = 7
+    const ROW_DAEMON_KILL = 8
+    const ROW_DAEMON_LOGS = 9
+
+    const daemonStatus = state.daemonStatus || 'not-installed'
+    const daemonInfo = state.daemonInfo
+    const daemonIsActive = daemonStatus === 'running' || daemonStatus === 'unhealthy' || daemonStatus === 'stale'
+    const daemonIsInstalled = daemonIsActive || daemonStatus === 'stopped'
+
+    // 📖 Compute max row — hide daemon action rows when daemon not installed
+    let maxRow = ROW_DAEMON_INSTALL
+    if (daemonIsInstalled) maxRow = ROW_DAEMON_LOGS
+
+    // 📖 Header
+    lines.push(`  ${chalk.cyanBright('🚀')} ${chalk.bold.cyanBright('free-coding-models')} ${chalk.dim(`v${LOCAL_VERSION}`)}`)
+    lines.push(`  ${chalk.bold('📡 FCM Proxy V2 Manager')}`)
+    lines.push(`  ${chalk.dim('— Esc back to Settings • ↑↓ navigate • Enter select')}`)
+    lines.push('')
+    lines.push(`  ${chalk.bgRed.white.bold(' ⚠ EXPERIMENTAL ')} ${chalk.red('This feature is under active development and may not work as expected.')}`)
+    lines.push(`  ${chalk.red('Found a bug? Press')} ${chalk.bold.white('I')} ${chalk.red('on the main screen or join our Discord to report issues & suggest improvements.')}`)
+    lines.push('')
+
+    // 📖 Feedback message (auto-clears after 5s)
+    const msg = state.proxyDaemonMessage
+    if (msg && (Date.now() - msg.ts < 5000)) {
+      const msgColor = msg.type === 'success' ? chalk.greenBright : msg.type === 'warning' ? chalk.yellow : chalk.red
+      lines.push(`  ${msgColor(msg.msg)}`)
+      lines.push('')
+    }
+
+    // ────────────────────────────── PROXY SECTION ──────────────────────────────
+    lines.push(`  ${chalk.bold('🔀 Proxy Configuration')}`)
+    lines.push(`  ${chalk.dim('  ─────────────────────────────────────────────')}`)
+    lines.push('')
+    lines.push(`  ${chalk.dim('  The local proxy groups all your provider API keys into a single')}`)
+    lines.push(`  ${chalk.dim('  endpoint. Tools like OpenCode, Claude Code, Goose, etc. connect')}`)
+    lines.push(`  ${chalk.dim('  to this proxy which handles key rotation, rate limiting, and failover.')}`)
+    lines.push('')
+
+    // 📖 Resolve active tool for proxy sync (persisted or fallback to Z-mode)
+    const activeProxyTool = proxySettings.activeTool || state.mode || 'opencode'
+    const activeToolMeta = getToolMeta(activeProxyTool)
+    const activeToolLabel = `${activeToolMeta.emoji} ${activeToolMeta.label}`
+
+    // 📖 Row 0: Proxy enabled toggle
+    const r0b = state.proxyDaemonCursor === ROW_PROXY_ENABLED ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
+    const r0val = proxySettings.enabled ? chalk.greenBright('Enabled') : chalk.dim('Disabled (opt-in)')
+    const r0 = `${r0b}${chalk.bold('Proxy mode').padEnd(44)} ${r0val}`
+    cursorLineByRow[ROW_PROXY_ENABLED] = lines.length
+    lines.push(state.proxyDaemonCursor === ROW_PROXY_ENABLED ? chalk.bgRgb(20, 45, 60)(r0) : r0)
+
+    // 📖 Row 1: Active tool selector — cycles through proxy-syncable tools
+    const r1b = state.proxyDaemonCursor === ROW_PROXY_TOOL ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
+    const r1 = `${r1b}${chalk.bold('Active tool').padEnd(44)} ${chalk.cyanBright(activeToolLabel)} ${chalk.dim('← Enter to cycle')}`
+    cursorLineByRow[ROW_PROXY_TOOL] = lines.length
+    lines.push(state.proxyDaemonCursor === ROW_PROXY_TOOL ? chalk.bgRgb(20, 45, 60)(r1) : r1)
+
+    // 📖 Row 2: Auto-sync proxy config to active tool
+    const r2b = state.proxyDaemonCursor === ROW_PROXY_SYNC ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
+    const r2val = proxySettings.syncToOpenCode ? chalk.greenBright('Enabled') : chalk.dim('Disabled')
+    const r2 = `${r2b}${chalk.bold(`Auto-sync proxy to ${activeToolMeta.label}`).padEnd(44)} ${r2val}`
+    cursorLineByRow[ROW_PROXY_SYNC] = lines.length
+    lines.push(state.proxyDaemonCursor === ROW_PROXY_SYNC ? chalk.bgRgb(20, 45, 60)(r2) : r2)
+
+    // 📖 Row 3: Preferred port
+    const r3b = state.proxyDaemonCursor === ROW_PROXY_PORT ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
+    const r3val = state.settingsProxyPortEditMode && state.proxyDaemonCursor === ROW_PROXY_PORT
+      ? chalk.cyanBright(`${state.settingsProxyPortBuffer}▏`)
+      : (proxySettings.preferredPort === 0 ? chalk.dim('auto (OS-assigned)') : chalk.green(String(proxySettings.preferredPort)))
+    const r3 = `${r3b}${chalk.bold('Preferred proxy port').padEnd(44)} ${r3val}`
+    cursorLineByRow[ROW_PROXY_PORT] = lines.length
+    lines.push(state.proxyDaemonCursor === ROW_PROXY_PORT ? chalk.bgRgb(20, 45, 60)(r3) : r3)
+
+    // 📖 Row 4: Clean tool proxy config
+    const r4b = state.proxyDaemonCursor === ROW_PROXY_CLEANUP ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
+    const r4 = `${r4b}${chalk.bold(`Clean ${activeToolMeta.label} proxy config`).padEnd(44)} ${chalk.dim('Enter → removes all fcm-* entries')}`
+    cursorLineByRow[ROW_PROXY_CLEANUP] = lines.length
+    lines.push(state.proxyDaemonCursor === ROW_PROXY_CLEANUP ? chalk.bgRgb(45, 30, 30)(r4) : r4)
+
+    // ────────────────────────────── DAEMON SECTION ─────────────────────────────
+    lines.push('')
+    lines.push(`  ${chalk.bold('📡 FCM Proxy V2 Background Service')}`)
+    lines.push(`  ${chalk.dim('  ─────────────────────────────────────────────')}`)
+    lines.push('')
+    lines.push(`  ${chalk.dim('  The background service keeps FCM Proxy V2 running 24/7 — even when')}`)
+    lines.push(`  ${chalk.dim('  the TUI is closed or after a reboot. Claude Code, Gemini CLI, and')}`)
+    lines.push(`  ${chalk.dim('  all tools stay connected at all times.')}`)
+    lines.push('')
+
+    // 📖 Status display
+    let daemonStatusLine = `  ${chalk.bold('  Status:')} `
+    if (daemonStatus === 'running') {
+      daemonStatusLine += chalk.greenBright('● Running')
+      if (daemonInfo) daemonStatusLine += chalk.dim(` — PID ${daemonInfo.pid} • Port ${daemonInfo.port} • ${daemonInfo.accountCount || '?'} accounts • ${daemonInfo.modelCount || '?'} models`)
+    } else if (daemonStatus === 'stopped') {
+      daemonStatusLine += chalk.yellow('○ Stopped') + chalk.dim(' — service installed but not running')
+    } else if (daemonStatus === 'stale') {
+      daemonStatusLine += chalk.red('⚠ Stale') + chalk.dim(' — service crashed, PID no longer alive')
+    } else if (daemonStatus === 'unhealthy') {
+      daemonStatusLine += chalk.red('⚠ Unhealthy') + chalk.dim(' — PID alive but health check failed')
+    } else {
+      daemonStatusLine += chalk.dim('○ Not installed')
+    }
+    lines.push(daemonStatusLine)
+
+    // 📖 Version mismatch warning
+    if (daemonInfo?.version && daemonInfo.version !== LOCAL_VERSION) {
+      lines.push(`  ${chalk.yellow(`  ⚠ Version mismatch: service v${daemonInfo.version} vs FCM v${LOCAL_VERSION}`)}`)
+      lines.push(`  ${chalk.dim('    Restart or reinstall the service to apply the update.')}`)
+    }
+
+    // 📖 Uptime
+    if (daemonStatus === 'running' && daemonInfo?.startedAt) {
+      const upSec = Math.floor((Date.now() - new Date(daemonInfo.startedAt).getTime()) / 1000)
+      const upMin = Math.floor(upSec / 60)
+      const upHr = Math.floor(upMin / 60)
+      const uptimeStr = upHr > 0 ? `${upHr}h ${upMin % 60}m` : upMin > 0 ? `${upMin}m ${upSec % 60}s` : `${upSec}s`
+      lines.push(`  ${chalk.dim(`  Uptime: ${uptimeStr}`)}`)
+    }
+
+    lines.push('')
+
+    // 📖 Row 5: Install / Uninstall
+    const d0b = state.proxyDaemonCursor === ROW_DAEMON_INSTALL ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
+    const d0label = daemonIsInstalled ? 'Uninstall service' : 'Install background service'
+    const d0hint = daemonIsInstalled
+      ? chalk.dim('Enter → stop service + remove config')
+      : chalk.dim('Enter → install as OS service (launchd/systemd)')
+    const d0 = `${d0b}${chalk.bold(d0label).padEnd(44)} ${d0hint}`
+    cursorLineByRow[ROW_DAEMON_INSTALL] = lines.length
+    lines.push(state.proxyDaemonCursor === ROW_DAEMON_INSTALL ? chalk.bgRgb(daemonIsInstalled ? 45 : 20, daemonIsInstalled ? 30 : 45, daemonIsInstalled ? 30 : 40)(d0) : d0)
+
+    // 📖 Rows 6-9 only shown when service is installed
+    if (daemonIsInstalled) {
+      // 📖 Row 6: Restart
+      const d1b = state.proxyDaemonCursor === ROW_DAEMON_RESTART ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
+      const d1 = `${d1b}${chalk.bold('Restart service').padEnd(44)} ${chalk.dim('Enter → stop + start via OS service manager')}`
+      cursorLineByRow[ROW_DAEMON_RESTART] = lines.length
+      lines.push(state.proxyDaemonCursor === ROW_DAEMON_RESTART ? chalk.bgRgb(20, 45, 60)(d1) : d1)
+
+      // 📖 Row 7: Stop (SIGTERM)
+      const d2b = state.proxyDaemonCursor === ROW_DAEMON_STOP ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
+      const d2warn = chalk.dim(' (service may auto-restart)')
+      const d2 = `${d2b}${chalk.bold('Stop service').padEnd(44)} ${chalk.dim('Enter → graceful shutdown (SIGTERM)')}${d2warn}`
+      cursorLineByRow[ROW_DAEMON_STOP] = lines.length
+      lines.push(state.proxyDaemonCursor === ROW_DAEMON_STOP ? chalk.bgRgb(45, 40, 20)(d2) : d2)
+
+      // 📖 Row 8: Force kill (SIGKILL) — emergency
+      const d3b = state.proxyDaemonCursor === ROW_DAEMON_KILL ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
+      const d3 = `${d3b}${chalk.bold.red('Force kill service').padEnd(44)} ${chalk.dim('Enter → SIGKILL — emergency only')}`
+      cursorLineByRow[ROW_DAEMON_KILL] = lines.length
+      lines.push(state.proxyDaemonCursor === ROW_DAEMON_KILL ? chalk.bgRgb(60, 20, 20)(d3) : d3)
+
+      // 📖 Row 9: View logs
+      const d4b = state.proxyDaemonCursor === ROW_DAEMON_LOGS ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
+      const d4 = `${d4b}${chalk.bold('View service logs').padEnd(44)} ${chalk.dim('Enter → show last 50 log lines')}`
+      cursorLineByRow[ROW_DAEMON_LOGS] = lines.length
+      lines.push(state.proxyDaemonCursor === ROW_DAEMON_LOGS ? chalk.bgRgb(30, 30, 50)(d4) : d4)
+    }
+
+    // ────────────────────────────── INFO SECTION ───────────────────────────────
+    lines.push('')
+    lines.push(`  ${chalk.bold('ℹ  How it works')}`)
+    lines.push(`  ${chalk.dim('  ─────────────────────────────────────────────')}`)
+    lines.push('')
+    lines.push(`  ${chalk.dim('  📖 The proxy starts a local HTTP server on 127.0.0.1 (localhost only).')}`)
+    lines.push(`  ${chalk.dim('  📖 External tools connect to it as if it were OpenAI/Anthropic.')}`)
+    lines.push(`  ${chalk.dim('  📖 The proxy rotates between your API keys across all providers.')}`)
+    lines.push('')
+    lines.push(`  ${chalk.dim('  📖 The background service adds persistence: install it once, and the proxy')}`)
+    lines.push(`  ${chalk.dim('  📖 starts automatically at login and survives reboots.')}`)
+    lines.push('')
+    lines.push(`  ${chalk.dim('  📖 Claude Code support: FCM Proxy V2 translates Anthropic wire format')}`)
+    lines.push(`  ${chalk.dim('  📖 (POST /v1/messages) to OpenAI format for upstream providers.')}`)
+    lines.push('')
+    if (process.platform === 'darwin') {
+      lines.push(`  ${chalk.dim('  📦 macOS: launchd LaunchAgent at ~/Library/LaunchAgents/com.fcm.proxy.plist')}`)
+    } else if (process.platform === 'linux') {
+      lines.push(`  ${chalk.dim('  📦 Linux: systemd user service at ~/.config/systemd/user/fcm-proxy.service')}`)
+    } else {
+      lines.push(`  ${chalk.dim('  ⚠ Windows: background service not supported — use in-process proxy (starts with TUI)')}`)
+    }
+    lines.push('')
+
+    // 📖 Clamp cursor
+    if (state.proxyDaemonCursor > maxRow) state.proxyDaemonCursor = maxRow
+
+    // 📖 Scrolling and tinting
+    const PROXY_DAEMON_BG = chalk.bgRgb(15, 25, 45)
+    const targetLine = cursorLineByRow[state.proxyDaemonCursor] ?? 0
+    state.proxyDaemonScrollOffset = keepOverlayTargetVisible(
+      state.proxyDaemonScrollOffset,
+      targetLine,
+      lines.length,
+      state.terminalRows
+    )
+    const { visible, offset } = sliceOverlayLines(lines, state.proxyDaemonScrollOffset, state.terminalRows)
+    state.proxyDaemonScrollOffset = offset
+    const tintedLines = tintOverlayLines(visible, PROXY_DAEMON_BG, state.terminalCols)
+    return tintedLines.map(l => l + EL).join('\n')
+  }
+
   // 📖 stopRecommendAnalysis: cleanup timers if user cancels during analysis
   function stopRecommendAnalysis() {
     if (state.recommendAnalysisTimer) { clearInterval(state.recommendAnalysisTimer); state.recommendAnalysisTimer = null }
@@ -1349,12 +1489,12 @@ export function createOverlayRenderers(state, deps) {
 
   return {
     renderSettings,
+    renderProxyDaemon,
     renderInstallEndpoints,
     renderHelp,
     renderLog,
     renderRecommend,
-    renderFeatureRequest,
-    renderBugReport,
+    renderFeedback,
     renderChangelog,
     startRecommendAnalysis,
     stopRecommendAnalysis,