Function runSetup

src/setup/wizard.ts:46–392

(opts: SetupOptions = {})

}

export async function runSetup(opts: SetupOptions = {}): Promise<void> {
  const interactive = !opts.defaults && !opts.check && isInteractiveTTY();
  const promptOpts: PromptOptions = { interactive };

  console.log('');
  console.log('QodeX setup — tune QodeX to your hardware and preferences.');
  if (interactive) {
    console.log(`This will save to ${QODEX_CONFIG_FILE}. You can re-run anytime with \`qx setup\`.`);
  } else if (opts.check) {
    console.log('(--check mode: showing detected values, NOT writing config)');
  } else {
    console.log('(--defaults / non-interactive mode: applying sensible defaults)');
  }

  // ── 1. Hardware ─────────────────────────────────────────────────────────────
  section('[1/7] Detecting hardware');
  const hw = detectHardware();
  console.log(formatHardwareSummary(hw));

  // ── 2. Primary model ────────────────────────────────────────────────────────
  section('[2/7] Primary model');
  paragraph(
    'The model that does the actual work. We just scanned your machine for what\'s\n' +
    'actually installed — those show up first. Cloud models need an API key.',
  );

  // Probe local backends (Ollama daemon + LM Studio server) for what's available
  // RIGHT NOW. Detection is bounded (~1.5s per source) and silent on failure.
  const detected = await detectAllLocalModels();
  if (detected.length > 0) {
    // Group by source so the user can see backend distribution at a glance.
    const byOllama = detected.filter(m => m.source === 'ollama');
    const byLmStudio = detected.filter(m => m.source === 'lm-studio');
    console.log(`  Detected ${detected.length} local model${detected.length === 1 ? '' : 's'} across ${
      (byOllama.length > 0 ? 1 : 0) + (byLmStudio.length > 0 ? 1 : 0)
    } backend${byOllama.length > 0 && byLmStudio.length > 0 ? 's' : ''}:`);
    if (byLmStudio.length > 0) {
      console.log('');
      console.log('  LM Studio (MLX-optimized for Apple Silicon, faster on M-series):');
      for (const m of byLmStudio) {
        const f = formatModel(m);
        console.log(`    • ${f.label}   ${f.hint}`);
      }
    }
    if (byOllama.length > 0) {
      console.log('');
      console.log('  Ollama (GGUF, broad compatibility, easier model management):');
      for (const m of byOllama) {
        const f = formatModel(m);
        console.log(`    • ${f.label}   ${f.hint}`);
      }
    }
    if (byOllama.length > 0 && byLmStudio.length > 0) {
      console.log('');
      console.log('  Two backends detected — real parallel sub-agents possible (one on each).');
    }
    console.log('');
  } else {