openmagic 0.1.0 → 0.3.0

package/dist/cli.js

@@ -5,6 +5,8 @@ import { Command } from "commander";
 import chalk from "chalk";
 import open from "open";
 import { resolve as resolve2 } from "path";
+import { spawn } from "child_process";
+import { createInterface } from "readline";
 
 // src/proxy.ts
 import http from "http";
@@ -286,85 +288,550 @@ function getProjectTree(roots) {
 
 // src/llm/registry.ts
 var MODEL_REGISTRY = {
+  // ─── OpenAI ───────────────────────────────────────────────────
   openai: {
     name: "OpenAI",
     models: [
-      { id: "gpt-4.1", name: "GPT-4.1", vision: true, context: 1047576 },
-      { id: "gpt-4.1-mini", name: "GPT-4.1 Mini", vision: true, context: 1047576 },
-      { id: "gpt-4.1-nano", name: "GPT-4.1 Nano", vision: true, context: 1047576 },
-      { id: "gpt-4o", name: "GPT-4o", vision: true, context: 128e3 },
-      { id: "gpt-4o-mini", name: "GPT-4o Mini", vision: true, context: 128e3 },
-      { id: "o3", name: "o3 (Reasoning)", vision: true, context: 2e5 },
-      { id: "o4-mini", name: "o4-mini (Reasoning)", vision: true, context: 2e5 }
+      // GPT-5.4 family (March 2026 — latest flagship)
+      {
+        id: "gpt-5.4",
+        name: "GPT-5.4",
+        vision: true,
+        context: 105e4,
+        maxOutput: 128e3,
+        thinking: {
+          supported: true,
+          paramName: "reasoning_effort",
+          paramType: "level",
+          levels: ["none", "low", "medium", "high", "xhigh"],
+          defaultLevel: "medium"
+        }
+      },
+      {
+        id: "gpt-5.4-pro",
+        name: "GPT-5.4 Pro",
+        vision: true,
+        context: 105e4,
+        maxOutput: 128e3,
+        thinking: {
+          supported: true,
+          paramName: "reasoning_effort",
+          paramType: "level",
+          levels: ["none", "low", "medium", "high", "xhigh"],
+          defaultLevel: "high"
+        }
+      },
+      {
+        id: "gpt-5.4-mini",
+        name: "GPT-5.4 Mini",
+        vision: true,
+        context: 4e5,
+        maxOutput: 128e3,
+        thinking: {
+          supported: true,
+          paramName: "reasoning_effort",
+          paramType: "level",
+          levels: ["none", "low", "medium", "high"],
+          defaultLevel: "medium"
+        }
+      },
+      {
+        id: "gpt-5.4-nano",
+        name: "GPT-5.4 Nano",
+        vision: true,
+        context: 4e5,
+        maxOutput: 128e3,
+        thinking: {
+          supported: true,
+          paramName: "reasoning_effort",
+          paramType: "level",
+          levels: ["none", "low", "medium", "high"],
+          defaultLevel: "low"
+        }
+      },
+      // GPT-5.2 family (reasoning-focused)
+      {
+        id: "gpt-5.2",
+        name: "GPT-5.2 Thinking",
+        vision: true,
+        context: 272e3,
+        maxOutput: 128e3,
+        thinking: {
+          supported: true,
+          paramName: "reasoning_effort",
+          paramType: "level",
+          levels: ["none", "low", "medium", "high", "xhigh"],
+          defaultLevel: "high"
+        }
+      },
+      {
+        id: "gpt-5.2-pro",
+        name: "GPT-5.2 Pro",
+        vision: true,
+        context: 272e3,
+        maxOutput: 128e3,
+        thinking: {
+          supported: true,
+          paramName: "reasoning_effort",
+          paramType: "level",
+          levels: ["none", "low", "medium", "high", "xhigh"],
+          defaultLevel: "high"
+        }
+      },
+      // o-series reasoning models
+      {
+        id: "o3",
+        name: "o3 (Reasoning)",
+        vision: true,
+        context: 2e5,
+        maxOutput: 1e5,
+        thinking: {
+          supported: true,
+          paramName: "reasoning_effort",
+          paramType: "level",
+          levels: ["low", "medium", "high"],
+          defaultLevel: "medium"
+        }
+      },
+      {
+        id: "o4-mini",
+        name: "o4-mini (Reasoning)",
+        vision: true,
+        context: 2e5,
+        maxOutput: 1e5,
+        thinking: {
+          supported: true,
+          paramName: "reasoning_effort",
+          paramType: "level",
+          levels: ["low", "medium", "high"],
+          defaultLevel: "medium"
+        }
+      },
+      // GPT-4.1 family
+      {
+        id: "gpt-4.1",
+        name: "GPT-4.1",
+        vision: true,
+        context: 1047576,
+        maxOutput: 32768
+      },
+      {
+        id: "gpt-4.1-mini",
+        name: "GPT-4.1 Mini",
+        vision: true,
+        context: 1047576,
+        maxOutput: 32768
+      },
+      {
+        id: "gpt-4.1-nano",
+        name: "GPT-4.1 Nano",
+        vision: true,
+        context: 1047576,
+        maxOutput: 32768
+      },
+      // Codex
+      {
+        id: "codex-mini-latest",
+        name: "Codex Mini",
+        vision: false,
+        context: 192e3,
+        maxOutput: 1e5,
+        thinking: {
+          supported: true,
+          paramName: "reasoning_effort",
+          paramType: "level",
+          levels: ["low", "medium", "high"],
+          defaultLevel: "high"
+        }
+      }
     ],
     apiBase: "https://api.openai.com/v1",
     keyPrefix: "sk-",
     keyPlaceholder: "sk-..."
   },
+  // ─── Anthropic ────────────────────────────────────────────────
   anthropic: {
     name: "Anthropic",
     models: [
-      { id: "claude-opus-4-20250514", name: "Claude Opus 4", vision: true, context: 2e5 },
-      { id: "claude-sonnet-4-20250514", name: "Claude Sonnet 4", vision: true, context: 2e5 },
-      { id: "claude-haiku-4-20250514", name: "Claude Haiku 4", vision: true, context: 2e5 }
+      // Claude 4.6 (latest — Feb 2026)
+      {
+        id: "claude-opus-4-6",
+        name: "Claude Opus 4.6",
+        vision: true,
+        context: 1e6,
+        maxOutput: 128e3,
+        thinking: {
+          supported: true,
+          paramName: "budget_tokens",
+          paramType: "budget",
+          defaultBudget: 1e4,
+          maxBudget: 128e3
+        }
+      },
+      {
+        id: "claude-sonnet-4-6",
+        name: "Claude Sonnet 4.6",
+        vision: true,
+        context: 1e6,
+        maxOutput: 64e3,
+        thinking: {
+          supported: true,
+          paramName: "budget_tokens",
+          paramType: "budget",
+          defaultBudget: 8e3,
+          maxBudget: 64e3
+        }
+      },
+      // Claude 4.5
+      {
+        id: "claude-haiku-4-5-20251001",
+        name: "Claude Haiku 4.5",
+        vision: true,
+        context: 2e5,
+        maxOutput: 64e3,
+        thinking: {
+          supported: true,
+          paramName: "budget_tokens",
+          paramType: "budget",
+          defaultBudget: 5e3,
+          maxBudget: 64e3
+        }
+      },
+      {
+        id: "claude-sonnet-4-5-20250929",
+        name: "Claude Sonnet 4.5",
+        vision: true,
+        context: 1e6,
+        maxOutput: 64e3,
+        thinking: {
+          supported: true,
+          paramName: "budget_tokens",
+          paramType: "budget",
+          defaultBudget: 8e3,
+          maxBudget: 64e3
+        }
+      },
+      {
+        id: "claude-opus-4-5-20251101",
+        name: "Claude Opus 4.5",
+        vision: true,
+        context: 2e5,
+        maxOutput: 64e3,
+        thinking: {
+          supported: true,
+          paramName: "budget_tokens",
+          paramType: "budget",
+          defaultBudget: 1e4,
+          maxBudget: 64e3
+        }
+      },
+      // Claude 4.0
+      {
+        id: "claude-sonnet-4-20250514",
+        name: "Claude Sonnet 4",
+        vision: true,
+        context: 2e5,
+        maxOutput: 64e3,
+        thinking: {
+          supported: true,
+          paramName: "budget_tokens",
+          paramType: "budget",
+          defaultBudget: 8e3,
+          maxBudget: 64e3
+        }
+      },
+      {
+        id: "claude-opus-4-20250514",
+        name: "Claude Opus 4",
+        vision: true,
+        context: 2e5,
+        maxOutput: 32e3,
+        thinking: {
+          supported: true,
+          paramName: "budget_tokens",
+          paramType: "budget",
+          defaultBudget: 1e4,
+          maxBudget: 32e3
+        }
+      }
     ],
     apiBase: "https://api.anthropic.com/v1",
     keyPrefix: "sk-ant-",
     keyPlaceholder: "sk-ant-..."
   },
+  // ─── Google Gemini ────────────────────────────────────────────
   google: {
     name: "Google Gemini",
     models: [
-      { id: "gemini-2.5-pro", name: "Gemini 2.5 Pro", vision: true, context: 1048576 },
-      { id: "gemini-2.5-flash", name: "Gemini 2.5 Flash", vision: true, context: 1048576 },
-      { id: "gemini-2.0-flash", name: "Gemini 2.0 Flash", vision: true, context: 1048576 }
+      // Gemini 3.1 (latest — Feb-Mar 2026)
+      {
+        id: "gemini-3.1-pro-preview",
+        name: "Gemini 3.1 Pro",
+        vision: true,
+        context: 1048576,
+        maxOutput: 65536,
+        thinking: {
+          supported: true,
+          paramName: "thinking_level",
+          paramType: "level",
+          levels: ["none", "low", "medium", "high"],
+          defaultLevel: "medium"
+        }
+      },
+      // Gemini 3.0
+      {
+        id: "gemini-3-flash-preview",
+        name: "Gemini 3 Flash",
+        vision: true,
+        context: 1048576,
+        maxOutput: 65536,
+        thinking: {
+          supported: true,
+          paramName: "thinking_level",
+          paramType: "level",
+          levels: ["none", "low", "medium", "high"],
+          defaultLevel: "low"
+        }
+      },
+      {
+        id: "gemini-3.1-flash-lite-preview",
+        name: "Gemini 3.1 Flash Lite",
+        vision: true,
+        context: 1048576,
+        maxOutput: 65536
+      },
+      // Gemini 2.5
+      {
+        id: "gemini-2.5-pro",
+        name: "Gemini 2.5 Pro",
+        vision: true,
+        context: 1048576,
+        maxOutput: 65536,
+        thinking: {
+          supported: true,
+          paramName: "thinking_level",
+          paramType: "level",
+          levels: ["none", "low", "medium", "high"],
+          defaultLevel: "medium"
+        }
+      },
+      {
+        id: "gemini-2.5-flash",
+        name: "Gemini 2.5 Flash",
+        vision: true,
+        context: 1048576,
+        maxOutput: 65536,
+        thinking: {
+          supported: true,
+          paramName: "thinking_level",
+          paramType: "level",
+          levels: ["none", "low", "medium", "high"],
+          defaultLevel: "low"
+        }
+      },
+      {
+        id: "gemini-2.5-flash-lite",
+        name: "Gemini 2.5 Flash Lite",
+        vision: true,
+        context: 1048576,
+        maxOutput: 65536
+      }
     ],
     apiBase: "https://generativelanguage.googleapis.com/v1beta",
     keyPrefix: "AI",
     keyPlaceholder: "AIza..."
   },
+  // ─── xAI (Grok) ──────────────────────────────────────────────
+  xai: {
+    name: "xAI (Grok)",
+    models: [
+      {
+        id: "grok-4.20-0309-reasoning",
+        name: "Grok 4.20 Reasoning",
+        vision: true,
+        context: 2e6,
+        maxOutput: 128e3,
+        thinking: {
+          supported: true,
+          paramName: "reasoning_effort",
+          paramType: "level",
+          levels: ["low", "medium", "high"],
+          defaultLevel: "medium"
+        }
+      },
+      {
+        id: "grok-4.20-0309-non-reasoning",
+        name: "Grok 4.20",
+        vision: true,
+        context: 2e6,
+        maxOutput: 128e3
+      },
+      {
+        id: "grok-4-1-fast-reasoning",
+        name: "Grok 4.1 Fast Reasoning",
+        vision: true,
+        context: 2e6,
+        maxOutput: 128e3,
+        thinking: {
+          supported: true,
+          paramName: "reasoning_effort",
+          paramType: "level",
+          levels: ["low", "medium", "high"],
+          defaultLevel: "low"
+        }
+      },
+      {
+        id: "grok-4-1-fast-non-reasoning",
+        name: "Grok 4.1 Fast",
+        vision: true,
+        context: 2e6,
+        maxOutput: 128e3
+      }
+    ],
+    apiBase: "https://api.x.ai/v1",
+    keyPrefix: "xai-",
+    keyPlaceholder: "xai-..."
+  },
+  // ─── DeepSeek ─────────────────────────────────────────────────
   deepseek: {
     name: "DeepSeek",
     models: [
-      { id: "deepseek-chat", name: "DeepSeek V3", vision: false, context: 65536 },
-      { id: "deepseek-reasoner", name: "DeepSeek R1", vision: false, context: 65536 }
+      {
+        id: "deepseek-chat",
+        name: "DeepSeek V3.2",
+        vision: false,
+        context: 128e3,
+        maxOutput: 8192
+      },
+      {
+        id: "deepseek-reasoner",
+        name: "DeepSeek R1",
+        vision: false,
+        context: 128e3,
+        maxOutput: 8192,
+        thinking: {
+          supported: true,
+          paramName: "reasoning_effort",
+          paramType: "level",
+          levels: ["low", "medium", "high"],
+          defaultLevel: "medium"
+        }
+      }
     ],
     apiBase: "https://api.deepseek.com/v1",
     keyPrefix: "sk-",
     keyPlaceholder: "sk-..."
   },
-  groq: {
-    name: "Groq",
-    models: [
-      { id: "llama-3.3-70b-versatile", name: "Llama 3.3 70B", vision: false, context: 131072 },
-      { id: "llama-3.1-8b-instant", name: "Llama 3.1 8B", vision: false, context: 131072 },
-      { id: "gemma2-9b-it", name: "Gemma 2 9B", vision: false, context: 8192 }
-    ],
-    apiBase: "https://api.groq.com/openai/v1",
-    keyPrefix: "gsk_",
-    keyPlaceholder: "gsk_..."
-  },
+  // ─── Mistral ──────────────────────────────────────────────────
   mistral: {
     name: "Mistral",
     models: [
-      { id: "mistral-large-latest", name: "Mistral Large", vision: false, context: 131072 },
-      { id: "mistral-small-latest", name: "Mistral Small", vision: false, context: 131072 },
-      { id: "codestral-latest", name: "Codestral", vision: false, context: 262144 }
+      {
+        id: "mistral-large-3-25-12",
+        name: "Mistral Large 3",
+        vision: true,
+        context: 131072,
+        maxOutput: 32768
+      },
+      {
+        id: "mistral-small-4-0-26-03",
+        name: "Mistral Small 4",
+        vision: true,
+        context: 131072,
+        maxOutput: 32768
+      },
+      {
+        id: "mistral-small-3-2-25-06",
+        name: "Mistral Small 3.2",
+        vision: true,
+        context: 131072,
+        maxOutput: 32768
+      },
+      {
+        id: "codestral-2508",
+        name: "Codestral",
+        vision: false,
+        context: 262144,
+        maxOutput: 32768
+      },
+      {
+        id: "devstral-2-25-12",
+        name: "Devstral 2",
+        vision: false,
+        context: 131072,
+        maxOutput: 32768
+      },
+      {
+        id: "magistral-medium-1-2-25-09",
+        name: "Magistral Medium (Reasoning)",
+        vision: false,
+        context: 131072,
+        maxOutput: 32768,
+        thinking: {
+          supported: true,
+          paramName: "reasoning_effort",
+          paramType: "level",
+          levels: ["low", "medium", "high"],
+          defaultLevel: "medium"
+        }
+      },
+      {
+        id: "magistral-small-1-2-25-09",
+        name: "Magistral Small (Reasoning)",
+        vision: false,
+        context: 131072,
+        maxOutput: 32768,
+        thinking: {
+          supported: true,
+          paramName: "reasoning_effort",
+          paramType: "level",
+          levels: ["low", "medium", "high"],
+          defaultLevel: "medium"
+        }
+      }
     ],
     apiBase: "https://api.mistral.ai/v1",
     keyPrefix: "",
     keyPlaceholder: "Enter API key..."
   },
-  xai: {
-    name: "xAI (Grok)",
+  // ─── Groq ─────────────────────────────────────────────────────
+  groq: {
+    name: "Groq",
     models: [
-      { id: "grok-3", name: "Grok 3", vision: true, context: 131072 },
-      { id: "grok-3-mini", name: "Grok 3 Mini", vision: true, context: 131072 }
+      {
+        id: "meta-llama/llama-4-scout-17b-16e-instruct",
+        name: "Llama 4 Scout 17B",
+        vision: true,
+        context: 131072,
+        maxOutput: 8192
+      },
+      {
+        id: "llama-3.3-70b-versatile",
+        name: "Llama 3.3 70B",
+        vision: false,
+        context: 131072,
+        maxOutput: 32768
+      },
+      {
+        id: "llama-3.1-8b-instant",
+        name: "Llama 3.1 8B Instant",
+        vision: false,
+        context: 131072,
+        maxOutput: 8192
+      },
+      {
+        id: "qwen/qwen3-32b",
+        name: "Qwen 3 32B",
+        vision: false,
+        context: 131072,
+        maxOutput: 8192
+      }
     ],
-    apiBase: "https://api.x.ai/v1",
-    keyPrefix: "xai-",
-    keyPlaceholder: "xai-..."
+    apiBase: "https://api.groq.com/openai/v1",
+    keyPrefix: "gsk_",
+    keyPlaceholder: "gsk_..."
   },
+  // ─── Ollama (Local) ───────────────────────────────────────────
   ollama: {
     name: "Ollama (Local)",
     models: [],
@@ -373,6 +840,7 @@ var MODEL_REGISTRY = {
     keyPlaceholder: "not required",
     local: true
   },
+  // ─── OpenRouter (200+ models) ─────────────────────────────────
   openrouter: {
     name: "OpenRouter",
     models: [],
@@ -492,8 +960,8 @@ async function chatOpenAICompatible(provider, model, apiKey, messages, context,
         contextParts.consoleLogs = context.consoleLogs.map((l) => `[${l.level}] ${l.args.join(" ")}`).join("\n");
       }
       const enrichedContent = buildUserMessage(msg.content, contextParts);
-      const modelInfo = providerConfig.models.find((m) => m.id === model);
-      if (context.screenshot && modelInfo?.vision) {
+      const modelInfo2 = providerConfig.models.find((m) => m.id === model);
+      if (context.screenshot && modelInfo2?.vision) {
         apiMessages.push({
           role: "user",
           content: [
@@ -520,6 +988,11 @@ async function chatOpenAICompatible(provider, model, apiKey, messages, context,
     stream: true,
     max_tokens: 4096
   };
+  const modelInfo = providerConfig.models.find((m) => m.id === model);
+  if (modelInfo?.thinking?.supported && modelInfo.thinking.paramType === "level") {
+    body.reasoning_effort = modelInfo.thinking.defaultLevel || "medium";
+    body.max_tokens = Math.min(modelInfo.maxOutput, 16384);
+  }
   try {
     const headers = {
       "Content-Type": "application/json"
@@ -627,13 +1100,22 @@ async function chatAnthropic(model, apiKey, messages, context, onChunk, onDone,
       });
     }
   }
+  const providerConfig = MODEL_REGISTRY.anthropic;
+  const modelInfo = providerConfig?.models.find((m) => m.id === model);
+  const thinkingBudget = modelInfo?.thinking?.defaultBudget || 0;
   const body = {
     model,
-    max_tokens: 4096,
+    max_tokens: thinkingBudget > 0 ? Math.max(thinkingBudget + 4096, 16384) : 4096,
     system: SYSTEM_PROMPT,
     messages: apiMessages,
     stream: true
   };
+  if (thinkingBudget > 0) {
+    body.thinking = {
+      type: "enabled",
+      budget_tokens: thinkingBudget
+    };
+  }
   try {
     const response = await fetch(url, {
       method: "POST",
@@ -728,14 +1210,21 @@ async function chatGoogle(model, apiKey, messages, context, onChunk, onDone, onE
       });
     }
   }
+  const providerConfig = MODEL_REGISTRY.google;
+  const modelInfo = providerConfig?.models.find((m) => m.id === model);
+  const thinkingLevel = modelInfo?.thinking?.defaultLevel;
+  const generationConfig = {
+    maxOutputTokens: 8192
+  };
+  if (thinkingLevel && thinkingLevel !== "none") {
+    generationConfig.thinking_level = thinkingLevel.toUpperCase();
+  }
   const body = {
     system_instruction: {
       parts: [{ text: SYSTEM_PROMPT }]
     },
     contents,
-    generationConfig: {
-      maxOutputTokens: 4096
-    }
+    generationConfig
   };
   try {
     const response = await fetch(url, {
@@ -840,7 +1329,7 @@ function createOpenMagicServer(proxyPort, roots) {
         "Content-Type": "application/json",
         "Access-Control-Allow-Origin": "*"
       });
-      res.end(JSON.stringify({ status: "ok", version: "0.1.0" }));
+      res.end(JSON.stringify({ status: "ok", version: "0.3.0" }));
       return;
     }
     res.writeHead(404);
@@ -893,7 +1382,7 @@ async function handleMessage(ws, msg, state, roots, _proxyPort) {
         id: msg.id,
         type: "handshake.ok",
         payload: {
-          version: "0.1.0",
+          version: "0.3.0",
           roots,
           config: {
             provider: config.provider,
@@ -1044,6 +1533,8 @@ function serveToolbarBundle(res) {
 
 // src/detect.ts
 import { createConnection } from "net";
+import { readFileSync as readFileSync4, existsSync as existsSync4 } from "fs";
+import { join as join4 } from "path";
 var COMMON_DEV_PORTS = [
   3e3,
   // React (CRA), Next.js, Express
@@ -1063,8 +1554,16 @@ var COMMON_DEV_PORTS = [
   // Common alternate
   4e3,
   // Phoenix, generic
-  1234
+  1234,
   // Parcel
+  4321,
+  // Astro
+  3333,
+  // Remix
+  8081,
+  // Metro (React Native)
+  9e3
+  // generic
 ];
 function checkPort(port, host = "127.0.0.1") {
   return new Promise((resolve3) => {
@@ -1108,9 +1607,98 @@ async function findAvailablePort(startPort) {
   }
   return port;
 }
+var FRAMEWORK_PATTERNS = [
+  { match: /\bnext\b/, framework: "Next.js", defaultPort: 3e3 },
+  { match: /\bvite\b/, framework: "Vite", defaultPort: 5173 },
+  { match: /\bnuxt\b/, framework: "Nuxt", defaultPort: 3e3 },
+  { match: /\bng\s+serve\b/, framework: "Angular", defaultPort: 4200 },
+  { match: /\bvue-cli-service\s+serve\b/, framework: "Vue CLI", defaultPort: 8080 },
+  { match: /\bsvelte-kit\b/, framework: "SvelteKit", defaultPort: 5173 },
+  { match: /\bastro\b/, framework: "Astro", defaultPort: 4321 },
+  { match: /\bremix\b/, framework: "Remix", defaultPort: 3e3 },
+  { match: /\breact-scripts\s+start\b/, framework: "Create React App", defaultPort: 3e3 },
+  { match: /\bparcel\b/, framework: "Parcel", defaultPort: 1234 },
+  { match: /\bwebpack\s+serve\b|webpack-dev-server/, framework: "Webpack", defaultPort: 8080 },
+  { match: /\bgatsby\b/, framework: "Gatsby", defaultPort: 8e3 },
+  { match: /\bturborepo\b|\bturbo\b.*dev/, framework: "Turborepo", defaultPort: 3e3 },
+  { match: /\bexpo\b/, framework: "Expo", defaultPort: 8081 },
+  { match: /\bnodemon\b|\bts-node\b|\bnode\b/, framework: "Node.js", defaultPort: 3e3 },
+  { match: /\bflask\b/, framework: "Flask", defaultPort: 5e3 },
+  { match: /\bdjango\b|manage\.py\s+runserver/, framework: "Django", defaultPort: 8e3 },
+  { match: /\brails\b/, framework: "Rails", defaultPort: 3e3 },
+  { match: /\bphp\s+.*serve\b|artisan\s+serve/, framework: "PHP/Laravel", defaultPort: 8e3 }
+];
+var DEV_SCRIPT_NAMES = ["dev", "start", "serve", "develop", "dev:start", "start:dev"];
+function detectDevScripts(cwd = process.cwd()) {
+  const pkgPath = join4(cwd, "package.json");
+  if (!existsSync4(pkgPath)) return [];
+  let pkg;
+  try {
+    pkg = JSON.parse(readFileSync4(pkgPath, "utf-8"));
+  } catch {
+    return [];
+  }
+  if (!pkg.scripts) return [];
+  const scripts = [];
+  for (const name of DEV_SCRIPT_NAMES) {
+    const command = pkg.scripts[name];
+    if (!command) continue;
+    let framework = "Unknown";
+    let defaultPort = 3e3;
+    for (const pattern of FRAMEWORK_PATTERNS) {
+      if (pattern.match.test(command)) {
+        framework = pattern.framework;
+        defaultPort = pattern.defaultPort;
+        break;
+      }
+    }
+    const portMatch = command.match(/(?:--port|-p)\s+(\d+)/);
+    if (portMatch) {
+      defaultPort = parseInt(portMatch[1], 10);
+    }
+    scripts.push({ name, command, framework, defaultPort });
+  }
+  return scripts;
+}
+function getProjectName(cwd = process.cwd()) {
+  const pkgPath = join4(cwd, "package.json");
+  if (!existsSync4(pkgPath)) return "this project";
+  try {
+    const pkg = JSON.parse(readFileSync4(pkgPath, "utf-8"));
+    return pkg.name || "this project";
+  } catch {
+    return "this project";
+  }
+}
 
 // src/cli.ts
-var VERSION = "0.1.0";
+var VERSION = "0.3.0";
+function ask(question) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve3) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve3(answer.trim());
+    });
+  });
+}
+function waitForPort(port, timeoutMs = 3e4) {
+  const start = Date.now();
+  return new Promise((resolve3) => {
+    const check = async () => {
+      if (await isPortOpen(port)) {
+        resolve3(true);
+        return;
+      }
+      if (Date.now() - start > timeoutMs) {
+        resolve3(false);
+        return;
+      }
+      setTimeout(check, 500);
+    };
+    check();
+  });
+}
 var program = new Command();
 program.name("openmagic").description("AI-powered coding toolbar for any web application").version(VERSION).option("-p, --port <port>", "Dev server port to proxy", "").option(
   "-l, --listen <port>",
@@ -1131,43 +1719,35 @@ program.name("openmagic").description("AI-powered coding toolbar for any web app
     targetPort = parseInt(opts.port, 10);
     const isRunning = await isPortOpen(targetPort);
     if (!isRunning) {
-      console.log(
-        chalk.yellow(
-          `  \u26A0  No server found at ${targetHost}:${targetPort}`
-        )
-      );
-      console.log(
-        chalk.dim(
-          "     Start your dev server first, then run openmagic again."
-        )
-      );
-      console.log("");
-      process.exit(1);
+      const started = await offerToStartDevServer(targetPort);
+      if (!started) {
+        process.exit(1);
+      }
     }
   } else {
     console.log(chalk.dim("  Scanning for dev server..."));
     const detected = await detectDevServer();
-    if (!detected) {
-      console.log(
-        chalk.yellow(
-          "  \u26A0  No dev server detected on common ports (3000, 5173, 8080, etc.)"
-        )
-      );
-      console.log("");
-      console.log(
-        chalk.white("  Specify the port manually:")
-      );
-      console.log(
-        chalk.cyan("    npx openmagic --port 3000")
-      );
-      console.log("");
-      process.exit(1);
+    if (detected) {
+      targetPort = detected.port;
+      targetHost = detected.host;
+    } else {
+      const started = await offerToStartDevServer();
+      if (!started) {
+        process.exit(1);
+      }
+      const redetected = await detectDevServer();
+      if (!redetected) {
+        console.log(chalk.red("  \u2717  Could not detect the dev server after starting."));
+        console.log(chalk.dim("     Try specifying the port: npx openmagic --port 3000"));
+        console.log("");
+        process.exit(1);
+      }
+      targetPort = redetected.port;
+      targetHost = redetected.host;
     }
-    targetPort = detected.port;
-    targetHost = detected.host;
   }
   console.log(
-    chalk.green(`  \u2713  Dev server found at ${targetHost}:${targetPort}`)
+    chalk.green(`  \u2713  Dev server running at ${targetHost}:${targetPort}`)
   );
   const roots = (opts.root || [process.cwd()]).map(
     (r) => resolve2(r)
@@ -1218,5 +1798,149 @@ program.name("openmagic").description("AI-powered coding toolbar for any web app
   process.on("SIGINT", shutdown);
   process.on("SIGTERM", shutdown);
 });
+async function offerToStartDevServer(expectedPort) {
+  const projectName = getProjectName();
+  const scripts = detectDevScripts();
+  if (scripts.length === 0) {
+    console.log(
+      chalk.yellow("  \u26A0  No dev server detected and no dev scripts found in package.json")
+    );
+    console.log("");
+    console.log(chalk.white("  Start your dev server manually, then run:"));
+    console.log(chalk.cyan("    npx openmagic --port <your-port>"));
+    console.log("");
+    return false;
+  }
+  let chosen = scripts[0];
+  if (scripts.length === 1) {
+    console.log(
+      chalk.yellow("  \u26A0  No dev server detected.")
+    );
+    console.log("");
+    console.log(
+      chalk.white(`  Found `) + chalk.cyan(`npm run ${chosen.name}`) + chalk.white(` in ${projectName}`) + chalk.dim(` (${chosen.framework})`)
+    );
+    console.log(chalk.dim(`     \u2192 ${chosen.command}`));
+    console.log("");
+    const answer = await ask(
+      chalk.white(`  Start it now? `) + chalk.dim("(Y/n) ")
+    );
+    if (answer.toLowerCase() === "n" || answer.toLowerCase() === "no") {
+      console.log("");
+      console.log(chalk.dim("  Start your dev server first, then run openmagic again."));
+      console.log("");
+      return false;
+    }
+  } else {
+    console.log(
+      chalk.yellow("  \u26A0  No dev server detected.")
+    );
+    console.log("");
+    console.log(
+      chalk.white(`  Found ${scripts.length} dev scripts in ${projectName}:`)
+    );
+    console.log("");
+    scripts.forEach((s, i) => {
+      console.log(
+        chalk.cyan(`    ${i + 1}) `) + chalk.white(`npm run ${s.name}`) + chalk.dim(` \u2014 ${s.framework} (port ${s.defaultPort})`)
+      );
+      console.log(chalk.dim(`       ${s.command}`));
+    });
+    console.log("");
+    const answer = await ask(
+      chalk.white(`  Which one to start? `) + chalk.dim(`(1-${scripts.length}, or n to cancel) `)
+    );
+    if (answer.toLowerCase() === "n" || answer.toLowerCase() === "no" || answer === "") {
+      console.log("");
+      console.log(chalk.dim("  Start your dev server first, then run openmagic again."));
+      console.log("");
+      return false;
+    }
+    const idx = parseInt(answer, 10) - 1;
+    if (idx < 0 || idx >= scripts.length || isNaN(idx)) {
+      chosen = scripts[0];
+    } else {
+      chosen = scripts[idx];
+    }
+  }
+  const port = expectedPort || chosen.defaultPort;
+  console.log("");
+  console.log(
+    chalk.dim(`  Starting `) + chalk.cyan(`npm run ${chosen.name}`) + chalk.dim("...")
+  );
+  const child = spawn("npm", ["run", chosen.name], {
+    cwd: process.cwd(),
+    stdio: ["ignore", "pipe", "pipe"],
+    detached: false,
+    shell: true,
+    env: {
+      ...process.env,
+      PORT: String(port),
+      // CRA, Express
+      BROWSER: "none",
+      // Prevent CRA from opening browser
+      BROWSER_NONE: "true"
+      // Some frameworks
+    }
+  });
+  child.stdout?.on("data", (data) => {
+    const lines = data.toString().trim().split("\n");
+    for (const line of lines) {
+      if (line.trim()) {
+        process.stdout.write(chalk.dim(`  \u2502 ${line}
+`));
+      }
+    }
+  });
+  child.stderr?.on("data", (data) => {
+    const lines = data.toString().trim().split("\n");
+    for (const line of lines) {
+      if (line.trim()) {
+        process.stdout.write(chalk.dim(`  \u2502 ${line}
+`));
+      }
+    }
+  });
+  child.on("error", (err) => {
+    console.log(chalk.red(`  \u2717  Failed to start: ${err.message}`));
+  });
+  child.on("exit", (code) => {
+    if (code !== null && code !== 0) {
+      console.log(chalk.red(`  \u2717  Dev server exited with code ${code}`));
+    }
+  });
+  const cleanup = () => {
+    try {
+      child.kill("SIGTERM");
+    } catch {
+    }
+  };
+  process.on("exit", cleanup);
+  process.on("SIGINT", cleanup);
+  process.on("SIGTERM", cleanup);
+  console.log(
+    chalk.dim(`  Waiting for port ${port}...`)
+  );
+  const isUp = await waitForPort(port, 3e4);
+  if (!isUp) {
+    console.log(
+      chalk.yellow(`  \u26A0  Port ${port} didn't open after 30s.`)
+    );
+    console.log(
+      chalk.dim(`     The server might use a different port. Check the output above.`)
+    );
+    console.log("");
+    const detected = await detectDevServer();
+    if (detected) {
+      console.log(
+        chalk.green(`  \u2713  Found server on port ${detected.port} instead.`)
+      );
+      return true;
+    }
+    return false;
+  }
+  console.log("");
+  return true;
+}
 program.parse();
 //# sourceMappingURL=cli.js.map