@vibeframe/cli 0.91.7 → 0.91.8

package/dist/index.js

@@ -62962,7 +62962,7 @@ init_source();
 // package.json
 var package_default = {
   name: "@vibeframe/cli",
-  version: "0.91.7",
+  version: "0.91.8",
   description: "VibeFrame CLI - natural language video editing from the terminal",
   private: false,
   license: "MIT",
@@ -69963,14 +69963,19 @@ var VALID_SCOPES = ["user", "project"];
 function parseScope(raw) {
   const v = String(raw ?? "user");
   if (!VALID_SCOPES.includes(v)) {
-    exitWithError(generalError(
-      `Invalid --scope: ${v}`,
-      `Must be one of: ${VALID_SCOPES.join(", ")}`
-    ));
+    exitWithError(
+      generalError(`Invalid --scope: ${v}`, `Must be one of: ${VALID_SCOPES.join(", ")}`)
+    );
   }
   return v;
 }
-var setupCommand = new Command("setup").description("Configure VibeFrame (LLM provider, API keys)").option("--reset", "Reset configuration to defaults").option("--full", "Run full setup with all optional providers").option("--show", "Show current configuration (for debugging)").option("-v, --verbose", "With --show: include unset providers + Resolution order + Defaults block").option("--claude-code", "Show Claude Code integration guide").option("-y, --yes", "Non-interactive: write config without prompting (CI / devcontainer)").option("--provider <id>", "Set the Agent LLM provider (claude | openai | gemini | xai | openrouter | ollama)").option("--import-env", "Promote API keys from .env / shell env into config.yaml").option("--test", "After save, live-test each configured key (exits 7 if any FAIL)").option(
+var setupCommand = new Command("setup").description("Configure VibeFrame (LLM provider, API keys)").option("--reset", "Reset configuration to defaults").option("--full", "Run full setup with all optional providers").option("--show", "Show current configuration (for debugging)").option(
+  "-v, --verbose",
+  "With --show: include unset providers + Resolution order + Defaults block"
+).option("--claude-code", "Show Claude Code integration guide").option("-y, --yes", "Non-interactive: write config without prompting (CI / devcontainer)").option(
+  "--provider <id>",
+  "Set the Agent LLM provider (claude | openai | gemini | xai | openrouter | ollama)"
+).option("--import-env", "Promote API keys from .env / shell env into config.yaml").option("--test", "After save, live-test each configured key (exits 7 if any FAIL)").option(
   "--scope <scope>",
   "Where to save: 'user' (~/.vibeframe/config.yaml, shared) or 'project' (./.vibeframe/config.yaml, gitignored, this project only)",
   "user"
@@ -70020,10 +70025,12 @@ Exit codes (non-interactive):
     return;
   }
   if (!hasTTY()) {
-    exitWithError(generalError(
-      "Interactive setup requires a terminal.",
-      "Run 'vibe setup' directly from your terminal, or use 'vibe setup --yes --provider <id> --import-env' for CI."
-    ));
+    exitWithError(
+      generalError(
+        "Interactive setup requires a terminal.",
+        "Run 'vibe setup' directly from your terminal, or use 'vibe setup --yes --provider <id> --import-env' for CI."
+      )
+    );
   }
   try {
     await runSetupWizard(options.full, scope);
@@ -70040,24 +70047,50 @@ var AI_FEATURES = [
     desc: "generate + edit",
     defaultProvider: "OpenAI gpt-image-2 (Artificial Analysis #1, since v0.56)",
     alsoAvailable: "Gemini Nano Banana, Grok Imagine",
-    keys: [{ configKey: "openai", envVar: "OPENAI_API_KEY", name: "OpenAI", url: "https://platform.openai.com/api-keys", what: "gpt-image-2 image generation + editing (also Whisper, Agent)" }],
+    keys: [
+      {
+        configKey: "openai",
+        envVar: "OPENAI_API_KEY",
+        name: "OpenAI",
+        url: "https://platform.openai.com/api-keys",
+        what: "gpt-image-2 image generation + editing (also Whisper, Agent)"
+      }
+    ],
     providerChoices: [
       {
         label: "OpenAI gpt-image-2",
         desc: "recommended default, image generation + editing",
-        key: { configKey: "openai", envVar: "OPENAI_API_KEY", name: "OpenAI", url: "https://platform.openai.com/api-keys", what: "gpt-image-2 image generation + editing (also Whisper, Agent)" },
+        key: {
+          configKey: "openai",
+          envVar: "OPENAI_API_KEY",
+          name: "OpenAI",
+          url: "https://platform.openai.com/api-keys",
+          what: "gpt-image-2 image generation + editing (also Whisper, Agent)"
+        },
         defaultFor: { kind: "image", value: "openai" }
       },
       {
         label: "Gemini",
         desc: "Google image generation + multimodal analysis",
-        key: { configKey: "google", envVar: "GOOGLE_API_KEY", name: "Google", url: "https://aistudio.google.com/apikey", what: "Gemini image generation and multimodal analysis" },
+        key: {
+          configKey: "google",
+          envVar: "GOOGLE_API_KEY",
+          name: "Google",
+          url: "https://aistudio.google.com/apikey",
+          what: "Gemini image generation and multimodal analysis"
+        },
         defaultFor: { kind: "image", value: "gemini" }
       },
       {
         label: "Grok",
         desc: "xAI image generation",
-        key: { configKey: "xai", envVar: "XAI_API_KEY", name: "xAI", url: "https://console.x.ai/", what: "Grok image generation and Agent" },
+        key: {
+          configKey: "xai",
+          envVar: "XAI_API_KEY",
+          name: "xAI",
+          url: "https://console.x.ai/",
+          what: "Grok image generation and Agent"
+        },
         defaultFor: { kind: "image", value: "grok" }
       }
     ],
@@ -70068,36 +70101,74 @@ var AI_FEATURES = [
     desc: "generate + extend",
     defaultProvider: "Seedance 2.0 via fal.ai (Artificial Analysis #2 t2v + i2v, since v0.57)",
     alsoAvailable: "Grok Imagine, Kling, Runway Gen-4.5, Google Veo",
-    keys: [{ configKey: "fal", envVar: "FAL_KEY", name: "Seedance 2.0 (via fal.ai)", url: "https://fal.ai/dashboard/keys", what: "ByteDance Seedance 2.0 text-to-video and image-to-video" }],
+    keys: [
+      {
+        configKey: "fal",
+        envVar: "FAL_KEY",
+        name: "Seedance 2.0 (via fal.ai)",
+        url: "https://fal.ai/dashboard/keys",
+        what: "ByteDance Seedance 2.0 text-to-video and image-to-video"
+      }
+    ],
     providerChoices: [
       {
         label: "Seedance 2.0 via fal.ai",
         desc: "recommended default, text-to-video + image-to-video",
-        key: { configKey: "fal", envVar: "FAL_KEY", name: "Seedance 2.0 (via fal.ai)", url: "https://fal.ai/dashboard/keys", what: "ByteDance Seedance 2.0 text-to-video and image-to-video" },
+        key: {
+          configKey: "fal",
+          envVar: "FAL_KEY",
+          name: "Seedance 2.0 (via fal.ai)",
+          url: "https://fal.ai/dashboard/keys",
+          what: "ByteDance Seedance 2.0 text-to-video and image-to-video"
+        },
         defaultFor: { kind: "video", value: "seedance" }
       },
       {
         label: "Grok",
         desc: "xAI video generation with audio",
-        key: { configKey: "xai", envVar: "XAI_API_KEY", name: "xAI", url: "https://console.x.ai/", what: "Grok video generation and Agent" },
+        key: {
+          configKey: "xai",
+          envVar: "XAI_API_KEY",
+          name: "xAI",
+          url: "https://console.x.ai/",
+          what: "Grok video generation and Agent"
+        },
         defaultFor: { kind: "video", value: "grok" }
       },
       {
         label: "Kling",
         desc: "Kling v2.5/v3 video generation",
-        key: { configKey: "kling", envVar: "KLING_API_KEY", name: "Kling", url: "https://platform.klingai.com/", what: "Kling video generation" },
+        key: {
+          configKey: "kling",
+          envVar: "KLING_API_KEY",
+          name: "Kling",
+          url: "https://platform.klingai.com/",
+          what: "Kling video generation"
+        },
         defaultFor: { kind: "video", value: "kling" }
       },
       {
         label: "Runway",
         desc: "Runway Gen-4.5 video generation",
-        key: { configKey: "runway", envVar: "RUNWAY_API_SECRET", name: "Runway", url: "https://app.runwayml.com/settings/api-keys", what: "Runway Gen-4.5 video generation" },
+        key: {
+          configKey: "runway",
+          envVar: "RUNWAY_API_SECRET",
+          name: "Runway",
+          url: "https://app.runwayml.com/settings/api-keys",
+          what: "Runway Gen-4.5 video generation"
+        },
         defaultFor: { kind: "video", value: "runway" }
       },
       {
         label: "Veo",
         desc: "Google Veo video generation",
-        key: { configKey: "google", envVar: "GOOGLE_API_KEY", name: "Google", url: "https://aistudio.google.com/apikey", what: "Google Veo video generation" },
+        key: {
+          configKey: "google",
+          envVar: "GOOGLE_API_KEY",
+          name: "Google",
+          url: "https://aistudio.google.com/apikey",
+          what: "Google Veo video generation"
+        },
         defaultFor: { kind: "video", value: "veo" }
       }
     ],
@@ -70108,12 +70179,26 @@ var AI_FEATURES = [
     desc: "TTS, SFX, music, voice clone",
     defaultProvider: "ElevenLabs (paid, premium quality) \u2014 falls back to local Kokoro when no key (free, since v0.54)",
     alsoAvailable: "Replicate MusicGen (music only)",
-    keys: [{ configKey: "elevenlabs", envVar: "ELEVENLABS_API_KEY", name: "ElevenLabs", url: "https://elevenlabs.io/app/settings/api-keys", what: "Text-to-speech, sound effects, music, voice cloning (skip to use local Kokoro)" }],
+    keys: [
+      {
+        configKey: "elevenlabs",
+        envVar: "ELEVENLABS_API_KEY",
+        name: "ElevenLabs",
+        url: "https://elevenlabs.io/app/settings/api-keys",
+        what: "Text-to-speech, sound effects, music, voice cloning (skip to use local Kokoro)"
+      }
+    ],
     providerChoices: [
       {
         label: "ElevenLabs",
         desc: "premium TTS, SFX, music, voice clone",
-        key: { configKey: "elevenlabs", envVar: "ELEVENLABS_API_KEY", name: "ElevenLabs", url: "https://elevenlabs.io/app/settings/api-keys", what: "Text-to-speech, sound effects, music, voice cloning" }
+        key: {
+          configKey: "elevenlabs",
+          envVar: "ELEVENLABS_API_KEY",
+          name: "ElevenLabs",
+          url: "https://elevenlabs.io/app/settings/api-keys",
+          what: "Text-to-speech, sound effects, music, voice cloning"
+        }
       },
       {
         label: "Kokoro local",
@@ -70123,7 +70208,13 @@ var AI_FEATURES = [
       {
         label: "Replicate MusicGen",
         desc: "background music generation",
-        key: { configKey: "replicate", envVar: "REPLICATE_API_TOKEN", name: "Replicate", url: "https://replicate.com/account/api-tokens", what: "MusicGen background music" }
+        key: {
+          configKey: "replicate",
+          envVar: "REPLICATE_API_TOKEN",
+          name: "Replicate",
+          url: "https://replicate.com/account/api-tokens",
+          what: "MusicGen background music"
+        }
       }
     ],
     tryCommand: 'vibe generate speech "Hello world" -o hello.mp3'
@@ -70134,8 +70225,20 @@ var AI_FEATURES = [
     defaultProvider: "Whisper (transcription) + Claude (reasoning)",
     alsoAvailable: "",
     keys: [
-      { configKey: "openai", envVar: "OPENAI_API_KEY", name: "OpenAI", url: "https://platform.openai.com/api-keys", what: "Whisper transcription (captions, jump-cut)" },
-      { configKey: "anthropic", envVar: "ANTHROPIC_API_KEY", name: "Anthropic", url: "https://console.anthropic.com/settings/keys", what: "Claude (color grade, reframe, motion graphics)" }
+      {
+        configKey: "openai",
+        envVar: "OPENAI_API_KEY",
+        name: "OpenAI",
+        url: "https://platform.openai.com/api-keys",
+        what: "Whisper transcription (captions, jump-cut)"
+      },
+      {
+        configKey: "anthropic",
+        envVar: "ANTHROPIC_API_KEY",
+        name: "Anthropic",
+        url: "https://console.anthropic.com/settings/keys",
+        what: "Claude (color grade, reframe, motion graphics)"
+      }
     ],
     tryCommand: "vibe edit caption video.mp4 -o captioned.mp4"
   }
@@ -70166,6 +70269,14 @@ function isProviderChoiceConfigured(config2, choice) {
   }
   return false;
 }
+function isFeatureConfigured(config2, feature) {
+  if (feature.providerChoices?.some((choice) => isProviderChoiceConfigured(config2, choice))) {
+    return true;
+  }
+  return feature.keys.some(
+    (keyDef) => Boolean(config2.providers[keyDef.configKey])
+  );
+}
 function mergeSelectedFeatures(current, next) {
   const merged = [...current];
   for (const feature of next) {
@@ -70184,10 +70295,12 @@ async function runNonInteractiveSetup(opts) {
   const changes = [];
   if (opts.provider) {
     if (!VALID_LLM_PROVIDERS.includes(opts.provider)) {
-      exitWithError(generalError(
-        `Invalid --provider: ${opts.provider}`,
-        `Must be one of: ${VALID_LLM_PROVIDERS.join(", ")}`
-      ));
+      exitWithError(
+        generalError(
+          `Invalid --provider: ${opts.provider}`,
+          `Must be one of: ${VALID_LLM_PROVIDERS.join(", ")}`
+        )
+      );
     }
     if (config2.llm.provider !== opts.provider) {
       config2.llm.provider = opts.provider;
@@ -70254,7 +70367,11 @@ async function runNonInteractiveSetup(opts) {
     }
     if (failures > 0) {
       console.error();
-      console.error(source_default.red(`Verification failed: ${failures} key${failures === 1 ? "" : "s"} returned non-2xx.`));
+      console.error(
+        source_default.red(
+          `Verification failed: ${failures} key${failures === 1 ? "" : "s"} returned non-2xx.`
+        )
+      );
       process.exit(7);
     }
   }
@@ -70263,15 +70380,11 @@ async function runSetupWizard(fullSetup = false, scope = "user") {
   console.log();
   const cfgPath = getConfigPath(scope).replace(homedir5(), "~");
   const scopeNote = scope === "project" ? "applies to this project only \xB7 add .vibeframe/ to .gitignore" : "applies to every project for this user";
-  console.log(
-    source_default.bold.magenta("VibeFrame Setup") + source_default.bold(` \u2014 ${scope} scope`)
-  );
+  console.log(source_default.bold.magenta("VibeFrame Setup") + source_default.bold(` \u2014 ${scope} scope`));
   console.log(source_default.dim(`${cfgPath} \xB7 ${scopeNote}`));
   if (scope === "user") {
     console.log(
-      source_default.dim(
-        "Tip: for per-project keys, cd into a project and run: vibe setup --scope project"
-      )
+      source_default.dim("Tip: for per-project keys, cd into a project and run: vibe setup --scope project")
     );
   }
   console.log(source_default.dim("\u2500".repeat(40)));
@@ -70312,10 +70425,34 @@ async function runSetupWizard(fullSetup = false, scope = "user") {
   if (topIndex === 2) {
     config2.llm.provider = "claude";
     const pipelineKeys = [
-      { configKey: "anthropic", envVar: "ANTHROPIC_API_KEY", name: "Anthropic", url: "https://console.anthropic.com/settings/keys", what: "Claude \u2014 storyboard generation + reasoning" },
-      { configKey: "openai", envVar: "OPENAI_API_KEY", name: "OpenAI", url: "https://platform.openai.com/api-keys", what: "gpt-image-2 image generation (default since v0.56) + Whisper word-level transcribe" },
-      { configKey: "fal", envVar: "FAL_KEY", name: "fal.ai", url: "https://fal.ai/dashboard/keys", what: "Seedance 2.0 \u2014 video generation, default since v0.57" },
-      { configKey: "elevenlabs", envVar: "ELEVENLABS_API_KEY", name: "ElevenLabs", url: "https://elevenlabs.io/app/settings/api-keys", what: "Text-to-speech narration + music (skip to use local Kokoro)" }
+      {
+        configKey: "anthropic",
+        envVar: "ANTHROPIC_API_KEY",
+        name: "Anthropic",
+        url: "https://console.anthropic.com/settings/keys",
+        what: "Claude \u2014 storyboard generation + reasoning"
+      },
+      {
+        configKey: "openai",
+        envVar: "OPENAI_API_KEY",
+        name: "OpenAI",
+        url: "https://platform.openai.com/api-keys",
+        what: "gpt-image-2 image generation (default since v0.56) + Whisper word-level transcribe"
+      },
+      {
+        configKey: "fal",
+        envVar: "FAL_KEY",
+        name: "fal.ai",
+        url: "https://fal.ai/dashboard/keys",
+        what: "Seedance 2.0 \u2014 video generation, default since v0.57"
+      },
+      {
+        configKey: "elevenlabs",
+        envVar: "ELEVENLABS_API_KEY",
+        name: "ElevenLabs",
+        url: "https://elevenlabs.io/app/settings/api-keys",
+        what: "Text-to-speech narration + music (skip to use local Kokoro)"
+      }
     ];
     console.log(source_default.dim("2. API keys"));
     console.log(source_default.bold("Pipeline requires these API keys:"));
@@ -70323,10 +70460,19 @@ async function runSetupWizard(fullSetup = false, scope = "user") {
     console.log();
     await collectKeys(config2, pipelineKeys);
     await saveConfig(config2, { scope });
-    await completeOrContinue(config2, "vibe build my-story/   # see CONTRIBUTING.md for STORYBOARD.md format", [], scope);
+    await completeOrContinue(
+      config2,
+      "vibe build my-story/   # see CONTRIBUTING.md for STORYBOARD.md format",
+      [],
+      scope
+    );
     return;
   }
   const result = await runAIFeaturesSetup(config2, scope);
+  if (result.back) {
+    await completeOrContinue(config2, "vibe --help", [], scope);
+    return;
+  }
   await saveConfig(config2, { scope });
   await completeOrContinue(config2, result.tryCommand, result.selectedFeatures, scope);
 }
@@ -70346,6 +70492,10 @@ async function completeOrContinue(config2, tryCommand, selectedFeatures, scope)
   console.log();
   if (action === 0) {
     const result = await runAIFeaturesSetup(config2, scope);
+    if (result.back) {
+      await completeOrContinue(config2, tryCommand, selectedFeatures, scope);
+      return;
+    }
     const mergedFeatures = mergeSelectedFeatures(selectedFeatures, result.selectedFeatures);
     const mergedTryCommand = selectedFeatures.length > 0 ? tryCommand : result.tryCommand;
     await saveConfig(config2, { scope });
@@ -70361,142 +70511,168 @@ async function completeOrContinue(config2, tryCommand, selectedFeatures, scope)
   await showComplete(config2, tryCommand, selectedFeatures, scope);
 }
 async function runAIFeaturesSetup(config2, _scope) {
-  console.log(source_default.dim("2. Features"));
-  console.log(source_default.bold("Which AI features do you need?"));
-  console.log(source_default.dim(`  ${source_default.bold("Most users pick more than one.")} Press ${source_default.bold("space")} on each feature you want, then ${source_default.bold("enter")} to confirm.`));
-  console.log(source_default.dim("  Shortcut: enter alone picks only the highlighted feature."));
-  console.log();
-  const featureLabels = AI_FEATURES.map((f) => {
-    const keyCount = f.keys.length;
-    const tag = source_default.dim(`${keyCount} key${keyCount > 1 ? "s" : ""}`);
-    return `${f.label} ${source_default.dim(`(${f.desc})`)} ${tag}`;
-  });
-  const picked = await promptMultiSelect(
-    source_default.cyan("  Pick (e.g. 1,3 or 'all'): "),
-    featureLabels,
-    [],
-    { pickFocusedOnEnter: true }
-  );
-  const selectedFeatures = picked.map((i) => AI_FEATURES[i]);
-  console.log();
-  if (selectedFeatures.length === 0) {
-    console.log(source_default.dim("  No features selected. You can re-run setup anytime."));
+  featureSelection: for (; ; ) {
+    console.log(source_default.dim("2. Features"));
+    console.log(source_default.bold("Which AI features do you need?"));
+    console.log(
+      source_default.dim(
+        `  ${source_default.bold("Most users pick more than one.")} Press ${source_default.bold("space")} on each feature you want, then ${source_default.bold("enter")} to confirm.`
+      )
+    );
+    console.log(source_default.dim("  Shortcut: enter alone picks only the highlighted feature."));
+    console.log(source_default.dim(`  Select ${source_default.bold("Back")} to return to the setup checkpoint.`));
     console.log();
-    return { tryCommand: "vibe --help", selectedFeatures: [] };
-  }
-  const plannedKeys = /* @__PURE__ */ new Map();
-  console.log(source_default.dim("3. Providers"));
-  console.log(source_default.bold("Choose providers for each selected feature"));
-  console.log(source_default.dim(`  Recommended default is highlighted. Press ${source_default.bold("enter")} to pick the highlighted provider, or ${source_default.bold("space")} to choose multiple.`));
-  console.log();
-  for (const feature of selectedFeatures) {
-    const keysForFeature = [];
-    if (feature.providerChoices && feature.providerChoices.length > 0) {
-      console.log(source_default.bold.cyan(`  ${feature.label}`));
-      console.log(source_default.dim(`  Default path: ${feature.defaultProvider}`));
-      if (feature.alsoAvailable) {
-        console.log(source_default.dim(`  Alternatives: ${feature.alsoAvailable}`));
-      }
+    const backIndex = AI_FEATURES.length;
+    const featureLabels = [
+      ...AI_FEATURES.map((f) => {
+        const keyCount = f.keys.length;
+        const tag = source_default.dim(`${keyCount} key${keyCount > 1 ? "s" : ""}`);
+        return `${f.label} ${source_default.dim(`(${f.desc})`)} ${tag}`;
+      }),
+      `Back ${source_default.dim("(return to setup checkpoint)")}`
+    ];
+    const configuredFeatures = AI_FEATURES.map((feature) => isFeatureConfigured(config2, feature));
+    const picked = await promptMultiSelect(
+      source_default.cyan("  Pick (e.g. 1,3 or 'all'): "),
+      featureLabels,
+      [...configuredFeatures, false],
+      { pickFocusedOnEnter: true, preserveDefaultSelectionOnEnter: true }
+    );
+    if (picked.includes(backIndex)) {
       console.log();
-      const defaultSelected = feature.providerChoices.map(
-        (choice) => isProviderChoiceConfigured(config2, choice)
-      );
-      const providerLabels = feature.providerChoices.map((choice) => {
-        const keyHint = choice.keyless ? source_default.dim("no key") : choice.key ? source_default.dim(choice.key.envVar) : source_default.dim("no key");
-        const defaultHint = choice === feature.providerChoices?.[0] ? source_default.dim("recommended default") : "";
-        return [
-          choice.label,
-          defaultHint,
-          source_default.dim(`- ${choice.desc}`),
-          keyHint
-        ].filter(Boolean).join(" ");
-      });
-      const pickedProviders = await promptMultiSelect(
-        source_default.cyan("  Providers (arrow + enter picks one, space adds more): "),
-        providerLabels,
-        defaultSelected,
-        { pickFocusedOnEnter: true, preserveDefaultSelectionOnEnter: true }
-      );
-      const selectedChoices = pickedProviders.map((i) => feature.providerChoices[i]);
-      const defaultChoice = selectedChoices.find((choice) => choice.defaultFor);
-      if (defaultChoice) {
-        applyProviderDefault(config2, defaultChoice);
-      }
-      for (const choice of selectedChoices) {
-        if (choice.key) addUniqueKey(keysForFeature, choice.key);
-      }
-      if (selectedChoices.some((choice) => choice.keyless)) {
-        console.log(source_default.dim("  No API key needed for selected local provider(s)."));
-      }
+      return { tryCommand: "vibe --help", selectedFeatures: [], back: true };
+    }
+    const selectedFeatures = picked.filter((i) => i < AI_FEATURES.length).map((i) => AI_FEATURES[i]);
+    console.log();
+    if (selectedFeatures.length === 0) {
+      console.log(source_default.dim("  No features selected. You can re-run setup anytime."));
       console.log();
-    } else {
-      for (const keyDef of feature.keys) {
-        addUniqueKey(keysForFeature, keyDef);
-      }
+      return { tryCommand: "vibe --help", selectedFeatures: [] };
     }
-    plannedKeys.set(feature.label, keysForFeature);
-  }
-  const needsKeys = [...plannedKeys.values()].some((keys) => keys.length > 0);
-  if (needsKeys) {
-    console.log(source_default.dim("4. API keys"));
-    console.log(source_default.bold("API Keys"));
-    console.log(source_default.dim("  Saved locally, never shared. Press Enter to skip."));
+    const plannedKeys = /* @__PURE__ */ new Map();
+    console.log(source_default.dim("3. Providers"));
+    console.log(source_default.bold("Choose providers for each selected feature"));
+    console.log(
+      source_default.dim(
+        `  Recommended default is highlighted. Press ${source_default.bold("enter")} to pick the highlighted provider, or ${source_default.bold("space")} to choose multiple.`
+      )
+    );
     console.log();
-    const collectedKeys = /* @__PURE__ */ new Set();
     for (const feature of selectedFeatures) {
-      const keysForFeature = plannedKeys.get(feature.label) ?? [];
-      if (keysForFeature.length === 0) {
-        continue;
-      }
-      console.log(source_default.bold.cyan(`  ${feature.label}`));
-      console.log(source_default.dim(`  Default: ${feature.defaultProvider}`));
-      if (feature.alsoAvailable) {
-        console.log(source_default.dim(`  Also available: ${feature.alsoAvailable}`));
+      const keysForFeature = [];
+      if (feature.providerChoices && feature.providerChoices.length > 0) {
+        console.log(source_default.bold.cyan(`  ${feature.label}`));
+        console.log(source_default.dim(`  Default path: ${feature.defaultProvider}`));
+        if (feature.alsoAvailable) {
+          console.log(source_default.dim(`  Alternatives: ${feature.alsoAvailable}`));
+        }
+        console.log();
+        const defaultSelected = feature.providerChoices.map(
+          (choice) => isProviderChoiceConfigured(config2, choice)
+        );
+        const providerLabels = feature.providerChoices.map((choice) => {
+          const keyHint = choice.keyless ? source_default.dim("no key") : choice.key ? source_default.dim(choice.key.envVar) : source_default.dim("no key");
+          const defaultHint = choice === feature.providerChoices?.[0] ? source_default.dim("recommended default") : "";
+          return [choice.label, defaultHint, source_default.dim(`- ${choice.desc}`), keyHint].filter(Boolean).join(" ");
+        });
+        const backProviderIndex = providerLabels.length;
+        const pickedProviders = await promptMultiSelect(
+          source_default.cyan("  Providers (arrow + enter picks one, space adds more): "),
+          [...providerLabels, `Back ${source_default.dim("(choose different features)")}`],
+          [...defaultSelected, false],
+          { pickFocusedOnEnter: true, preserveDefaultSelectionOnEnter: true }
+        );
+        if (pickedProviders.includes(backProviderIndex)) {
+          console.log();
+          continue featureSelection;
+        }
+        const selectedChoices = pickedProviders.filter((i) => i < feature.providerChoices.length).map((i) => feature.providerChoices[i]);
+        const defaultChoice = selectedChoices.find((choice) => choice.defaultFor);
+        if (defaultChoice) {
+          applyProviderDefault(config2, defaultChoice);
+        }
+        for (const choice of selectedChoices) {
+          if (choice.key) addUniqueKey(keysForFeature, choice.key);
+        }
+        if (selectedChoices.some((choice) => choice.keyless)) {
+          console.log(source_default.dim("  No API key needed for selected local provider(s)."));
+        }
+        console.log();
+      } else {
+        for (const keyDef of feature.keys) {
+          addUniqueKey(keysForFeature, keyDef);
+        }
       }
+      plannedKeys.set(feature.label, keysForFeature);
+    }
+    const needsKeys = [...plannedKeys.values()].some((keys) => keys.length > 0);
+    if (needsKeys) {
+      console.log(source_default.dim("4. API keys"));
+      console.log(source_default.bold("API Keys"));
+      console.log(source_default.dim("  Saved locally, never shared. Press Enter to skip."));
       console.log();
-      for (const keyDef of keysForFeature) {
-        if (collectedKeys.has(keyDef.configKey)) {
-          console.log(`  ${source_default.green("\u2713")} ${keyDef.name.padEnd(14)} (already set above)`);
+      const collectedKeys = /* @__PURE__ */ new Set();
+      for (const feature of selectedFeatures) {
+        const keysForFeature = plannedKeys.get(feature.label) ?? [];
+        if (keysForFeature.length === 0) {
           continue;
         }
-        loadEnv();
-        const configValue = config2.providers[keyDef.configKey];
-        const envValue = process.env[keyDef.envVar];
-        if (configValue || envValue) {
-          const value = configValue || envValue;
-          const source = configValue ? "config" : ".env";
-          console.log(`  ${source_default.green("\u2713")} ${keyDef.name.padEnd(14)} ${maskApiKey(value)} ${source_default.dim(`(${source})`)}`);
-          collectedKeys.add(keyDef.configKey);
-          continue;
+        console.log(source_default.bold.cyan(`  ${feature.label}`));
+        console.log(source_default.dim(`  Default: ${feature.defaultProvider}`));
+        if (feature.alsoAvailable) {
+          console.log(source_default.dim(`  Also available: ${feature.alsoAvailable}`));
         }
-        console.log(source_default.dim(`  ${keyDef.what}`));
-        console.log(source_default.dim(`  Get key: ${keyDef.url}  [o] open in browser`));
-        const newKey = await promptHidden(
-          source_default.cyan(`  ${keyDef.name.padEnd(14)} ${source_default.dim(keyDef.envVar)}: `),
-          { openHotkeyUrl: keyDef.url }
-        );
-        if (newKey.trim()) {
-          const trimmed = newKey.trim();
-          config2.providers[keyDef.configKey] = trimmed;
-          const fmt = validateKeyFormat(keyDef.configKey, trimmed);
-          if (!fmt.ok && fmt.expected) {
-            console.log(`  ${source_default.yellow("\u26A0")} Saved, but format looks unusual ${source_default.dim(`(expected ${fmt.expected})`)}`);
+        console.log();
+        for (const keyDef of keysForFeature) {
+          if (collectedKeys.has(keyDef.configKey)) {
+            console.log(`  ${source_default.green("\u2713")} ${keyDef.name.padEnd(14)} (already set above)`);
+            continue;
+          }
+          loadEnv();
+          const configValue = config2.providers[keyDef.configKey];
+          const envValue = process.env[keyDef.envVar];
+          if (configValue || envValue) {
+            const value = configValue || envValue;
+            const source = configValue ? "config" : ".env";
+            console.log(
+              `  ${source_default.green("\u2713")} ${keyDef.name.padEnd(14)} ${maskApiKey(value)} ${source_default.dim(`(${source})`)}`
+            );
+            collectedKeys.add(keyDef.configKey);
+            continue;
+          }
+          console.log(source_default.dim(`  ${keyDef.what}`));
+          console.log(source_default.dim(`  Get key: ${keyDef.url}  [o] open in browser`));
+          const newKey = await promptHidden(
+            source_default.cyan(`  ${keyDef.name.padEnd(14)} ${source_default.dim(keyDef.envVar)}: `),
+            { openHotkeyUrl: keyDef.url }
+          );
+          if (newKey.trim()) {
+            const trimmed = newKey.trim();
+            config2.providers[keyDef.configKey] = trimmed;
+            const fmt = validateKeyFormat(keyDef.configKey, trimmed);
+            if (!fmt.ok && fmt.expected) {
+              console.log(
+                `  ${source_default.yellow("\u26A0")} Saved, but format looks unusual ${source_default.dim(`(expected ${fmt.expected})`)}`
+              );
+            } else {
+              console.log(`  ${source_default.green("\u2713")} Saved`);
+            }
+            collectedKeys.add(keyDef.configKey);
           } else {
-            console.log(`  ${source_default.green("\u2713")} Saved`);
+            console.log(
+              `  ${source_default.yellow("\u26A0")} Skipped ${source_default.dim(`(set ${keyDef.envVar} in .env later)`)}`
+            );
           }
-          collectedKeys.add(keyDef.configKey);
-        } else {
-          console.log(`  ${source_default.yellow("\u26A0")} Skipped ${source_default.dim(`(set ${keyDef.envVar} in .env later)`)}`);
         }
+        console.log();
       }
+    } else {
+      console.log(source_default.dim("4. API keys"));
+      console.log(source_default.dim("  No API keys needed for the selected provider(s)."));
       console.log();
     }
-  } else {
-    console.log(source_default.dim("4. API keys"));
-    console.log(source_default.dim("  No API keys needed for the selected provider(s)."));
-    console.log();
+    return { tryCommand: selectedFeatures[0].tryCommand, selectedFeatures };
   }
-  return { tryCommand: selectedFeatures[0].tryCommand, selectedFeatures };
 }
 async function collectKeys(config2, keys) {
   loadEnv();
@@ -70504,11 +70680,15 @@ async function collectKeys(config2, keys) {
     const configValue = config2.providers[keyDef.configKey];
     const envValue = process.env[keyDef.envVar];
     if (configValue) {
-      console.log(`  ${source_default.green("\u2713")} ${keyDef.name.padEnd(14)} ${maskApiKey(configValue)} ${source_default.dim("(config)")}`);
+      console.log(
+        `  ${source_default.green("\u2713")} ${keyDef.name.padEnd(14)} ${maskApiKey(configValue)} ${source_default.dim("(config)")}`
+      );
       continue;
     }
     if (envValue) {
-      console.log(`  ${source_default.green("\u2713")} ${keyDef.name.padEnd(14)} ${maskApiKey(envValue)} ${source_default.dim("(.env)")}`);
+      console.log(
+        `  ${source_default.green("\u2713")} ${keyDef.name.padEnd(14)} ${maskApiKey(envValue)} ${source_default.dim("(.env)")}`
+      );
       continue;
     }
     console.log(source_default.dim(`  ${keyDef.what}`));
@@ -70522,12 +70702,16 @@ async function collectKeys(config2, keys) {
       config2.providers[keyDef.configKey] = trimmed;
       const fmt = validateKeyFormat(keyDef.configKey, trimmed);
       if (!fmt.ok && fmt.expected) {
-        console.log(`  ${source_default.yellow("\u26A0")} Saved, but format looks unusual ${source_default.dim(`(expected ${fmt.expected})`)}`);
+        console.log(
+          `  ${source_default.yellow("\u26A0")} Saved, but format looks unusual ${source_default.dim(`(expected ${fmt.expected})`)}`
+        );
       } else {
         console.log(`  ${source_default.green("\u2713")} Saved`);
       }
     } else {
-      console.log(`  ${source_default.yellow("\u26A0")} Skipped ${source_default.dim(`(set ${keyDef.envVar} in .env later)`)}`);
+      console.log(
+        `  ${source_default.yellow("\u26A0")} Skipped ${source_default.dim(`(set ${keyDef.envVar} in .env later)`)}`
+      );
     }
   }
   console.log();
@@ -70564,37 +70748,41 @@ async function runCustomSetup(config2, scope = "user", opts = {}) {
   for (const p of allProviders) {
     const existing = config2.providers[p.key];
     if (existing) {
-      console.log(`  ${source_default.green("\u2713")} ${p.name.padEnd(12)} ${maskApiKey(existing)} ${source_default.dim(p.desc)}`);
+      console.log(
+        `  ${source_default.green("\u2713")} ${p.name.padEnd(12)} ${maskApiKey(existing)} ${source_default.dim(p.desc)}`
+      );
       const change = await promptConfirm(source_default.cyan("    Update?"), false);
       if (change) {
         console.log(source_default.dim(`    Get key: ${p.url}  [o] open in browser`));
-        const newKey = await promptHidden(
-          source_default.cyan("    New key: "),
-          { openHotkeyUrl: p.url }
-        );
+        const newKey = await promptHidden(source_default.cyan("    New key: "), { openHotkeyUrl: p.url });
         if (newKey.trim()) {
           const trimmed = newKey.trim();
           config2.providers[p.key] = trimmed;
           const fmt = validateKeyFormat(p.key, trimmed);
           if (!fmt.ok && fmt.expected) {
-            console.log(source_default.yellow(`    \u26A0 Updated, but format looks unusual (expected ${fmt.expected})`));
+            console.log(
+              source_default.yellow(`    \u26A0 Updated, but format looks unusual (expected ${fmt.expected})`)
+            );
           } else {
             console.log(source_default.green("    \u2713 Updated"));
           }
         }
       }
     } else {
-      console.log(source_default.dim(`  ${source_default.dim("\u25CB")} ${p.name.padEnd(12)} ${source_default.dim(p.desc)}  Get key: ${p.url}  [o] open`));
-      const newKey = await promptHidden(
-        source_default.cyan(`    ${p.env}: `),
-        { openHotkeyUrl: p.url }
+      console.log(
+        source_default.dim(
+          `  ${source_default.dim("\u25CB")} ${p.name.padEnd(12)} ${source_default.dim(p.desc)}  Get key: ${p.url}  [o] open`
+        )
       );
+      const newKey = await promptHidden(source_default.cyan(`    ${p.env}: `), { openHotkeyUrl: p.url });
       if (newKey.trim()) {
         const trimmed = newKey.trim();
         config2.providers[p.key] = trimmed;
         const fmt = validateKeyFormat(p.key, trimmed);
         if (!fmt.ok && fmt.expected) {
-          console.log(`  ${source_default.yellow("\u26A0")} Saved, but format looks unusual ${source_default.dim(`(expected ${fmt.expected})`)}`);
+          console.log(
+            `  ${source_default.yellow("\u26A0")} Saved, but format looks unusual ${source_default.dim(`(expected ${fmt.expected})`)}`
+          );
         } else {
           console.log(`  ${source_default.green("\u2713")} Saved`);
         }
@@ -70631,14 +70819,20 @@ async function showComplete(config2, defaultTryCommand, features = [], scope = "
   }
   console.log();
   console.log(source_default.bold("  Next steps:"));
-  console.log(source_default.dim("    cd <project>; vibe init   Scaffold AGENTS.md / CLAUDE.md / .env.example (project scope)"));
+  console.log(
+    source_default.dim(
+      "    cd <project>; vibe init   Scaffold AGENTS.md / CLAUDE.md / .env.example (project scope)"
+    )
+  );
   const hostDetected = detectedAgentHosts().length > 0;
   for (const w of listWalkthroughs()) {
     const cmd = `vibe walkthrough ${w.topic}`.padEnd(26);
     const tag = hostDetected && w.topic === "scene" ? source_default.cyan(" (recommended)") : "";
     console.log(source_default.dim(`    ${cmd}${w.summary}${tag}`));
   }
-  console.log(source_default.dim("    vibe doctor --test-keys   Live-check each provider key against its API"));
+  console.log(
+    source_default.dim("    vibe doctor --test-keys   Live-check each provider key against its API")
+  );
   console.log(source_default.dim("    vibe doctor               Check system health + available commands"));
   console.log(source_default.dim("    vibe schema --list        Discover every command"));
   console.log(source_default.dim("    vibe setup                Re-run user-scope setup anytime"));
@@ -70773,7 +70967,11 @@ async function showConfig(opts = { verbose: false }) {
     }
   }
   if (!verbose && unsetCount > 0) {
-    console.log(source_default.dim(`  (${unsetCount} provider${unsetCount === 1 ? "" : "s"} unset \u2014 run with --verbose to list)`));
+    console.log(
+      source_default.dim(
+        `  (${unsetCount} provider${unsetCount === 1 ? "" : "s"} unset \u2014 run with --verbose to list)`
+      )
+    );
   }
   console.log();
   if (verbose) {
@@ -70785,8 +70983,12 @@ async function showConfig(opts = { verbose: false }) {
     }
     console.log(source_default.bold("Resolution order:"));
     console.log(source_default.dim("  1. --api-key CLI option"));
-    console.log(source_default.dim(`  2. Active config scope: ${activeScope === "project" ? projectPath : userPath}`));
-    console.log(source_default.dim(`     (project takes priority when present at cwd; user is ignored in that case)`));
+    console.log(
+      source_default.dim(`  2. Active config scope: ${activeScope === "project" ? projectPath : userPath}`)
+    );
+    console.log(
+      source_default.dim(`     (project takes priority when present at cwd; user is ignored in that case)`)
+    );
     console.log(source_default.dim("  3. .env / shell environment variables (process.env)"));
     console.log();
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibeframe/cli",
-  "version": "0.91.7",
+  "version": "0.91.8",
   "description": "VibeFrame CLI - natural language video editing from the terminal",
   "private": false,
   "license": "MIT",
@@ -183,8 +183,8 @@
     "tsx": "^4.21.0",
     "typescript": "^5.3.3",
     "vitest": "^1.2.2",
-    "@vibeframe/ai-providers": "0.91.7",
-    "@vibeframe/core": "0.91.7"
+    "@vibeframe/ai-providers": "0.91.8",
+    "@vibeframe/core": "0.91.8"
   },
   "engines": {
     "node": ">=20"