@vibeframe/cli 0.89.0 → 0.91.0

package/dist/index.js

@@ -14296,7 +14296,7 @@ function getCommandKeyMap() {
 function getSetupProviders() {
   return [...apiKeyRegistry.values()].filter((k) => k.showInSetup).map((k) => ({
     key: k.configKey,
-    name: k.label,
+    name: getDisplayLabelForApiKey(k.configKey),
     env: k.envVar,
     desc: k.setupDescription ?? "",
     url: k.envExampleUrl
@@ -14308,6 +14308,16 @@ function getAllApiKeys() {
 function getKeyFormat(configKey) {
   return apiKeyRegistry.get(configKey)?.keyFormat;
 }
+function getDisplayLabelForApiKey(configKey) {
+  const apiKey = apiKeyRegistry.get(configKey);
+  if (!apiKey)
+    return configKey;
+  const provider = [...providerRegistry2.values()].find((p) => p.apiKey === configKey && p.displayName && p.gateway);
+  if (provider?.displayName && provider.gateway) {
+    return `${provider.displayName} (via ${provider.gateway})`;
+  }
+  return apiKey.label;
+}
 function getAllProviders() {
   return [...providerRegistry2.values()];
 }
@@ -24412,7 +24422,7 @@ var init_FalProvider = __esm({
     VALID_ASPECTS = ["21:9", "16:9", "4:3", "1:1", "3:4", "9:16", "auto"];
     FalProvider = class {
       constructor() {
-        this.id = "fal";
+        this.id = "seedance";
         this.name = "fal.ai (Seedance 2.0)";
         this.description = "fal.ai hosting ByteDance Seedance 2.0 \u2014 Artificial Analysis #2 on both text-to-video and image-to-video leaderboards";
         this.capabilities = ["text-to-video", "image-to-video"];
@@ -24511,11 +24521,13 @@ var init_fal = __esm({
     init_FalProvider();
     init_define_provider();
     defineProvider({
-      id: "fal",
-      label: "fal.ai (Seedance 2.0)",
+      id: "seedance",
+      label: "Seedance 2.0",
       displayName: "Seedance 2.0",
       gateway: "fal.ai",
-      aliases: ["seedance"],
+      // `fal` is a deprecated v0.x alias kept so existing scripts keep working.
+      // Will be removed at the 1.0 cut (see docs/1.0-readiness.md).
+      aliases: ["fal"],
       models: ["seedance-2.0", "seedance-2.0-fast"],
       capabilities: ["text-to-video", "image-to-video", "native-audio"],
       apiKey: "fal",
@@ -25216,6 +25228,7 @@ __export(dist_exports2, {
   getAllProviders: () => getAllProviders,
   getBestProviderForCapability: () => getBestProviderForCapability,
   getCommandKeyMap: () => getCommandKeyMap,
+  getDisplayLabelForApiKey: () => getDisplayLabelForApiKey,
   getKeyFormat: () => getKeyFormat,
   getProviderEnvVars: () => getProviderEnvVars,
   getProvidersFor: () => getProvidersFor,
@@ -25690,32 +25703,81 @@ var init_schema = __esm({
 import { resolve as resolve4 } from "node:path";
 import { homedir } from "node:os";
 import { readFile as readFile2, writeFile as writeFile2, mkdir as mkdir2, access as access2 } from "node:fs/promises";
-async function loadConfig() {
+function getProjectConfigDir(cwd = process.cwd()) {
+  return resolve4(cwd, ".vibeframe");
+}
+function getProjectConfigPath(cwd = process.cwd()) {
+  return resolve4(getProjectConfigDir(cwd), "config.yaml");
+}
+function getConfigPath(scope, cwd) {
+  return scope === "project" ? getProjectConfigPath(cwd) : USER_CONFIG_PATH;
+}
+function getConfigDir(scope, cwd) {
+  return scope === "project" ? getProjectConfigDir(cwd) : USER_CONFIG_DIR;
+}
+async function fileExists(path2) {
   try {
-    await access2(CONFIG_PATH);
-    const content = await readFile2(CONFIG_PATH, "utf-8");
-    const config2 = (0, import_yaml.parse)(content);
-    const defaults = createDefaultConfig();
-    return {
-      ...defaults,
-      ...config2,
-      llm: { ...defaults.llm, ...config2.llm },
-      providers: { ...defaults.providers, ...config2.providers },
-      defaults: { ...defaults.defaults, ...config2.defaults },
-      repl: { ...defaults.repl, ...config2.repl }
-    };
+    await access2(path2);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function getActiveScope(cwd) {
+  return await fileExists(getProjectConfigPath(cwd)) ? "project" : "user";
+}
+function applyDefaults(parsed) {
+  const defaults = createDefaultConfig();
+  return {
+    ...defaults,
+    ...parsed,
+    llm: { ...defaults.llm, ...parsed.llm },
+    providers: { ...defaults.providers, ...parsed.providers },
+    defaults: { ...defaults.defaults, ...parsed.defaults },
+    repl: { ...defaults.repl, ...parsed.repl }
+  };
+}
+async function readConfigFile(path2) {
+  if (!await fileExists(path2)) return null;
+  try {
+    const content = await readFile2(path2, "utf-8");
+    const parsed = (0, import_yaml.parse)(content);
+    return applyDefaults(parsed);
   } catch {
     return null;
   }
 }
-async function saveConfig(config2) {
-  await mkdir2(CONFIG_DIR, { recursive: true });
-  const content = (0, import_yaml.stringify)(config2, {
-    indent: 2,
-    lineWidth: 0
-    // Don't wrap lines
-  });
-  await writeFile2(CONFIG_PATH, content, "utf-8");
+async function loadConfig(options = {}) {
+  const { scope, cwd, merge } = options;
+  if (merge) {
+    const user = await readConfigFile(USER_CONFIG_PATH);
+    const project2 = await readConfigFile(getProjectConfigPath(cwd));
+    if (!user && !project2) return null;
+    if (!user) return project2;
+    if (!project2) return user;
+    return {
+      ...user,
+      ...project2,
+      llm: { ...user.llm, ...project2.llm },
+      providers: { ...user.providers, ...project2.providers },
+      defaults: { ...user.defaults, ...project2.defaults },
+      repl: { ...user.repl, ...project2.repl }
+    };
+  }
+  if (scope) {
+    return readConfigFile(getConfigPath(scope, cwd));
+  }
+  const project = await readConfigFile(getProjectConfigPath(cwd));
+  if (project) return project;
+  return readConfigFile(USER_CONFIG_PATH);
+}
+async function saveConfig(config2, options = {}) {
+  const scope = options.scope ?? "user";
+  const dir = getConfigDir(scope, options.cwd);
+  const path2 = getConfigPath(scope, options.cwd);
+  await mkdir2(dir, { recursive: true });
+  const content = (0, import_yaml.stringify)(config2, { indent: 2, lineWidth: 0 });
+  await writeFile2(path2, content, "utf-8");
 }
 async function isConfigured() {
   const config2 = await loadConfig();
@@ -25737,20 +25799,19 @@ async function getApiKeyFromConfig(providerKey) {
     return config2.providers[providerKey];
   }
   const envVar = PROVIDER_ENV_VARS[providerKey];
-  if (envVar) {
-    return process.env[envVar];
-  }
+  if (envVar) return process.env[envVar];
   return void 0;
 }
-var import_yaml, CONFIG_DIR, CONFIG_PATH;
+var import_yaml, USER_CONFIG_DIR, USER_CONFIG_PATH, CONFIG_PATH;
 var init_config = __esm({
   "src/config/index.ts"() {
     "use strict";
     import_yaml = __toESM(require_dist(), 1);
     init_schema();
     init_schema();
-    CONFIG_DIR = resolve4(homedir(), ".vibeframe");
-    CONFIG_PATH = resolve4(CONFIG_DIR, "config.yaml");
+    USER_CONFIG_DIR = resolve4(homedir(), ".vibeframe");
+    USER_CONFIG_PATH = resolve4(USER_CONFIG_DIR, "config.yaml");
+    CONFIG_PATH = USER_CONFIG_PATH;
   }
 });
 
@@ -26277,9 +26338,8 @@ vibe scene lint --json    # structured output for agent loops
 `;
 }
 function buildSceneGitignore() {
-  return `# VibeFrame caches
-.vibeframe/cache/
-.vibeframe/checkpoints/
+  return `# VibeFrame \u2014 caches, checkpoints, and project-scope config.yaml (may contain API keys)
+.vibeframe/
 
 # Render outputs
 renders/*.mp4
@@ -35437,9 +35497,9 @@ var init_ai_script_pipeline = __esm({
 import { resolve as resolve26 } from "node:path";
 import { readFile as readFile14, writeFile as writeFile24 } from "node:fs/promises";
 function registerVideoCommand(parent) {
-  parent.command("video").alias("vid").description("Generate video using AI (Seedance, Grok, Kling, Runway, or Veo)").argument("[prompt]", "Text prompt describing the video (interactive if omitted)").option("-p, --provider <provider>", "Provider: seedance (ByteDance Seedance 2.0 via fal.ai), grok, kling, runway, veo. `fal` is a backwards-compatible alias for seedance.").option("-k, --api-key <key>", "API key (or set FAL_KEY / XAI_API_KEY / RUNWAY_API_SECRET / KLING_API_KEY / GOOGLE_API_KEY env)").option("-o, --output <path>", "Output file path (downloads video)").option("-i, --image <path>", "Reference image for image-to-video").option(
+  parent.command("video").alias("vid").description("Generate video using AI (Seedance, Grok, Kling, Runway, or Veo)").argument("[prompt]", "Text prompt describing the video (interactive if omitted)").option("-p, --provider <provider>", "Provider: seedance (ByteDance Seedance 2.0 via fal.ai), grok, kling, runway, veo. `fal` is a deprecated v0.x alias for seedance and will be removed in 1.0.").option("-k, --api-key <key>", "API key (or set FAL_KEY / XAI_API_KEY / RUNWAY_API_SECRET / KLING_API_KEY / GOOGLE_API_KEY env)").option("-o, --output <path>", "Output file path (downloads video)").option("-i, --image <path>", "Reference image for image-to-video").option(
     "-d, --duration <sec>",
-    "Duration in seconds. Seedance accepts 4-15 (`fal` alias supported); Kling accepts 5 or 10; Veo maps to 6 or 8.",
+    "Duration in seconds. Seedance accepts 4-15; Kling accepts 5 or 10; Veo maps to 6 or 8.",
     "5"
   ).option("-r, --ratio <ratio>", "Aspect ratio: 16:9, 9:16, or 1:1 (auto-detected from image if omitted)").option("--seed <number>", "Random seed for reproducibility (Runway only)").option("--mode <mode>", "Generation mode: std or pro (Kling only)", "std").option("--seedance-model <model>", "Seedance variant: quality or fast (fal.ai only)", "quality").option("--negative <prompt>", "Negative prompt - what to avoid (Kling/Veo)").option("--resolution <res>", "Video resolution: 720p, 1080p, 4k (Veo only)").option("--last-frame <path>", "Last frame image for frame interpolation (Veo only)").option("--ref-images <paths...>", "Reference images for character consistency (Veo 3.1 only, max 3)").option("--person <mode>", "Person generation: allow_all, allow_adult (Veo only)").option("--veo-model <model>", "Veo model: 3.0, 3.1, 3.1-fast (default: 3.1-fast)", "3.1-fast").option("--runway-model <model>", "Runway model: gen4.5 (default, text+image-to-video), gen4_turbo (image-to-video only)", "gen4.5").option("--no-wait", "Start generation and return task ID without waiting").option("--dry-run", "Preview parameters without executing").addHelpText("after", `
 Examples:
@@ -35485,8 +35545,7 @@ Examples:
         veo: "GOOGLE_API_KEY",
         kling: "KLING_API_KEY",
         runway: "RUNWAY_API_SECRET",
-        seedance: "FAL_KEY",
-        fal: "FAL_KEY"
+        seedance: "FAL_KEY"
       };
       let provider;
       if (options.provider) {
@@ -35495,9 +35554,17 @@ Examples:
           exitWithError(
             usageError(
               `Invalid provider: ${provider}`,
-              "Available providers: seedance, grok, kling, runway, veo. `fal` is a backwards-compatible alias for seedance."
+              "Available providers: seedance, grok, kling, runway, veo. `fal` is a deprecated alias for seedance."
+            )
+          );
+        }
+        if (provider === "fal") {
+          process.stderr.write(
+            source_default.yellow(
+              "Note: `-p fal` is a deprecated alias for `-p seedance` and will be removed in 1.0.\n"
             )
           );
+          provider = "seedance";
         }
         if (videoEnvMap[provider] && !hasApiKey(videoEnvMap[provider]) && !options.apiKey) {
           const resolved = resolveProvider("video");
@@ -35558,7 +35625,7 @@ Examples:
           data: {
             params: {
               prompt: prompt3,
-              provider: provider === "fal" ? "seedance" : provider,
+              provider,
               duration: options.duration,
               ratio: options.ratio,
               image: options.image,
@@ -35577,16 +35644,14 @@ Examples:
         kling: "KLING_API_KEY",
         veo: "GOOGLE_API_KEY",
         grok: "XAI_API_KEY",
-        seedance: "FAL_KEY",
-        fal: "FAL_KEY"
+        seedance: "FAL_KEY"
       };
       const providerNameMap = {
         runway: "Runway",
         kling: "Kling",
         veo: "Veo",
         grok: "Grok",
-        seedance: "Seedance 2.0 via fal.ai",
-        fal: "Seedance 2.0 via fal.ai"
+        seedance: "Seedance 2.0 via fal.ai"
       };
       const envKey = envKeyMap[provider];
       const providerName = providerNameMap[provider];
@@ -35805,7 +35870,7 @@ Examples:
           },
           3e5
         );
-      } else if (provider === "fal" || provider === "seedance") {
+      } else if (provider === "seedance") {
         const fal = new FalProvider();
         await fal.initialize({ apiKey });
         let falImage = referenceImage;
@@ -62845,7 +62910,7 @@ init_source();
 // package.json
 var package_default = {
   name: "@vibeframe/cli",
-  version: "0.89.0",
+  version: "0.91.0",
   description: "VibeFrame CLI - natural language video editing from the terminal",
   private: false,
   license: "MIT",
@@ -69840,13 +69905,34 @@ var VALID_LLM_PROVIDERS = [
   "xai",
   "openrouter"
 ];
-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)").addHelpText(
+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(", ")}`
+    ));
+  }
+  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(
+  "--scope <scope>",
+  "Where to save: 'user' (~/.vibeframe/config.yaml, shared) or 'project' (./.vibeframe/config.yaml, gitignored, this project only)",
+  "user"
+).addHelpText(
   "after",
   `
 Non-interactive examples (no TTY required):
   vibe setup --yes --provider claude --import-env         Bootstrap CI / devcontainer
   vibe setup --yes --import-env --test                    Persist .env keys + verify each one
   vibe setup --yes --provider openai                      Just switch the agent provider
+  vibe setup --scope project --yes --import-env           Project-only setup (./.vibeframe/config.yaml)
+
+Scopes:
+  user    (default) ~/.vibeframe/config.yaml \u2014 shared across every project
+  project ./.vibeframe/config.yaml \u2014 gitignored, isolates keys/defaults to this directory
+          When a project config exists at the cwd, it is used and the user file is ignored.
 
 Exit codes (non-interactive):
   0  success                7  --test verification failed (one or more keys returned non-2xx)
@@ -69861,11 +69947,12 @@ Exit codes (non-interactive):
     await showConfig({ verbose: Boolean(options.verbose) });
     return;
   }
+  const scope = parseScope(options.scope);
   if (options.reset) {
     const config2 = createDefaultConfig();
-    await saveConfig(config2);
+    await saveConfig(config2, { scope });
     console.log(source_default.green("\u2713 Configuration reset to defaults"));
-    console.log(source_default.dim(`  Saved to: ${CONFIG_PATH}`));
+    console.log(source_default.dim(`  Saved to: ${getConfigPath(scope)}`));
     return;
   }
   const wantsNonInteractive = Boolean(options.yes) || !hasTTY() && (options.provider || options.importEnv);
@@ -69873,7 +69960,8 @@ Exit codes (non-interactive):
     await runNonInteractiveSetup({
       provider: options.provider,
       importEnv: Boolean(options.importEnv),
-      test: Boolean(options.test)
+      test: Boolean(options.test),
+      scope
     });
     return;
   }
@@ -69884,7 +69972,7 @@ Exit codes (non-interactive):
     ));
   }
   try {
-    await runSetupWizard(options.full);
+    await runSetupWizard(options.full, scope);
     closeTTYStream();
     process.exit(0);
   } catch (err) {
@@ -69906,7 +69994,7 @@ 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: "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" }],
     tryCommand: 'vibe generate video "ocean waves" -o waves.mp4'
   },
   {
@@ -69930,7 +70018,8 @@ var AI_FEATURES = [
   }
 ];
 async function runNonInteractiveSetup(opts) {
-  let config2 = await loadConfig();
+  const scope = opts.scope ?? "user";
+  let config2 = await loadConfig({ scope });
   if (!config2) {
     config2 = createDefaultConfig();
   }
@@ -69967,9 +70056,9 @@ async function runNonInteractiveSetup(opts) {
       changes.push(`imported ${importedCount} key${importedCount === 1 ? "" : "s"} from env`);
     }
   }
-  await saveConfig(config2);
-  console.log(source_default.green("\u2713 Setup complete (non-interactive)"));
-  console.log(source_default.dim(`  Config: ${CONFIG_PATH}`));
+  await saveConfig(config2, { scope });
+  console.log(source_default.green(`\u2713 Setup complete (non-interactive, ${scope} scope)`));
+  console.log(source_default.dim(`  Config: ${getConfigPath(scope)}`));
   if (changes.length > 0) {
     for (const c of changes) {
       console.log(source_default.dim(`  ${c}`));
@@ -70012,20 +70101,21 @@ async function runNonInteractiveSetup(opts) {
     }
   }
 }
-async function runSetupWizard(fullSetup = false) {
+async function runSetupWizard(fullSetup = false, scope = "user") {
   console.log();
-  console.log(source_default.bold.magenta("VibeFrame Setup") + source_default.dim(" \u2014 user scope"));
+  const scopeLabel = scope === "project" ? source_default.dim(` \u2014 project scope (${getConfigPath("project")})`) : source_default.dim(" \u2014 user scope");
+  console.log(source_default.bold.magenta("VibeFrame Setup") + scopeLabel);
   console.log(source_default.dim("\u2500".repeat(40)));
   console.log();
   const hosts = detectedAgentHosts();
   console.log(source_default.dim(`Agent hosts: ${summariseAgentHosts(hosts)}`));
   console.log();
-  let config2 = await loadConfig();
+  let config2 = await loadConfig({ scope });
   if (!config2) {
     config2 = createDefaultConfig();
   }
   if (fullSetup) {
-    await runCustomSetup(config2);
+    await runCustomSetup(config2, scope);
     return;
   }
   console.log(source_default.dim("1. Goal"));
@@ -70040,12 +70130,12 @@ async function runSetupWizard(fullSetup = false) {
   const topIndex = await promptSelect(source_default.cyan("  Select [1-4]: "), topLabels, 0);
   console.log();
   if (topIndex === 0) {
-    await saveConfig(config2);
-    await showComplete(config2, "vibe edit silence-cut video.mp4 -o clean.mp4");
+    await saveConfig(config2, { scope });
+    await showComplete(config2, "vibe edit silence-cut video.mp4 -o clean.mp4", [], scope);
     return;
   }
   if (topIndex === 3) {
-    await runCustomSetup(config2);
+    await runCustomSetup(config2, scope);
     return;
   }
   if (topIndex === 2) {
@@ -70061,8 +70151,8 @@ async function runSetupWizard(fullSetup = false) {
     console.log(source_default.dim("  Saved locally, never shared. Press Enter to skip."));
     console.log();
     await collectKeys(config2, pipelineKeys);
-    await saveConfig(config2);
-    await showComplete(config2, "vibe build my-story/   # see CONTRIBUTING.md for STORYBOARD.md format");
+    await saveConfig(config2, { scope });
+    await showComplete(config2, "vibe build my-story/   # see CONTRIBUTING.md for STORYBOARD.md format", [], scope);
     return;
   }
   console.log(source_default.dim("2. Features"));
@@ -70083,8 +70173,8 @@ async function runSetupWizard(fullSetup = false) {
   if (selectedFeatures.length === 0) {
     console.log(source_default.dim("  No features selected. You can re-run setup anytime."));
     console.log();
-    await saveConfig(config2);
-    await showComplete(config2, "vibe --help", []);
+    await saveConfig(config2, { scope });
+    await showComplete(config2, "vibe --help", [], scope);
     return;
   }
   console.log(source_default.dim("3. API keys"));
@@ -70136,8 +70226,8 @@ async function runSetupWizard(fullSetup = false) {
     }
     console.log();
   }
-  await saveConfig(config2);
-  await showComplete(config2, selectedFeatures[0].tryCommand, selectedFeatures);
+  await saveConfig(config2, { scope });
+  await showComplete(config2, selectedFeatures[0].tryCommand, selectedFeatures, scope);
 }
 async function collectKeys(config2, keys) {
   loadEnv();
@@ -70173,7 +70263,7 @@ async function collectKeys(config2, keys) {
   }
   console.log();
 }
-async function runCustomSetup(config2) {
+async function runCustomSetup(config2, scope = "user") {
   console.log(source_default.bold("1. Agent LLM Provider") + source_default.dim(" (for vibe agent)"));
   console.log(source_default.dim("   Only needed if you use the interactive Agent mode."));
   console.log();
@@ -70243,14 +70333,15 @@ async function runCustomSetup(config2) {
     }
   }
   console.log();
-  await saveConfig(config2);
-  await showComplete(config2, "vibe doctor");
+  await saveConfig(config2, { scope });
+  await showComplete(config2, "vibe doctor", [], scope);
 }
-async function showComplete(config2, defaultTryCommand, features = []) {
+async function showComplete(config2, defaultTryCommand, features = [], scope = "user") {
   console.log(source_default.dim("\u2500".repeat(40)));
   console.log(source_default.green.bold("\u2713 Setup complete!"));
   console.log();
-  console.log(source_default.dim(`  Config: ${CONFIG_PATH}`));
+  const scopeNote = scope === "project" ? source_default.dim(" (project scope)") : source_default.dim(" (user scope)");
+  console.log(source_default.dim(`  Config: ${getConfigPath(scope)}${scopeNote}`));
   console.log();
   const primaryTry = features.length > 1 ? features[0].tryCommand : defaultTryCommand;
   if (features.length > 1) {
@@ -70340,13 +70431,22 @@ async function showConfig(opts = { verbose: false }) {
     hasCwdEnv = true;
   } catch {
   }
+  const activeScope = await getActiveScope();
+  const userPath = USER_CONFIG_PATH;
+  const projectPath = getConfigPath("project");
+  const userExists = await loadConfig({ scope: "user" }) !== null;
+  const projectExists = await loadConfig({ scope: "project" }) !== null;
   console.log();
   console.log(source_default.bold.magenta("VibeFrame Configuration"));
   console.log(source_default.dim("\u2500".repeat(40)));
   console.log();
-  console.log(source_default.dim(`Config file: ${CONFIG_PATH}`));
+  const userMark = activeScope === "user" && userExists ? source_default.cyan("\u2190 active") : userExists ? source_default.dim("(present)") : source_default.dim("(missing)");
+  const projectMark = activeScope === "project" ? source_default.cyan("\u2190 active") : projectExists ? source_default.dim("(present)") : source_default.dim("(missing)");
+  console.log(source_default.dim(`Scopes:`));
+  console.log(source_default.dim(`  user     ${userPath} ${userMark}`));
+  console.log(source_default.dim(`  project  ${projectPath} ${projectMark}`));
   if (hasCwdEnv) {
-    console.log(source_default.dim(`Project .env: ${cwdEnvPath}`));
+    console.log(source_default.dim(`  .env     ${cwdEnvPath} ${source_default.dim("(env vars override config)")}`));
   }
   console.log();
   const config2 = await loadConfig();
@@ -70414,9 +70514,9 @@ 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. ${CONFIG_PATH}`));
-    console.log(source_default.dim("  3. .env in current directory"));
-    console.log(source_default.dim("  4. Shell environment variables"));
+    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();
   }
 }
@@ -71551,6 +71651,9 @@ async function runDiagnostics() {
     exists: existsSync36(resolve50(cwd, rel))
   }));
   const projectInitialized = projectFiles.some((f) => f.exists);
+  const projectConfigPath = getProjectConfigPath(cwd);
+  const projectConfigExists = existsSync36(projectConfigPath);
+  const activeScope = await getActiveScope(cwd);
   const hosts = detectAgentHosts();
   const detectedNames = hosts.filter((h) => h.detected).map((h) => h.label);
   const recommendedMode = resolveSceneBuildMode({});
@@ -71573,8 +71676,15 @@ async function runDiagnostics() {
       ...Object.keys(optionalTools).length > 0 ? { optionalTools } : {}
     },
     scope: {
+      activeScope,
       user: { configured: configExists, configPath: CONFIG_PATH },
-      project: { cwd, initialized: projectInitialized, files: projectFiles },
+      project: {
+        cwd,
+        initialized: projectInitialized,
+        files: projectFiles,
+        configPath: projectConfigPath,
+        configFileExists: projectConfigExists
+      },
       agentHosts: { detected: detectedNames, summary: summariseAgentHosts(hosts) },
       sceneComposer: {
         recommendedMode,
@@ -71647,16 +71757,30 @@ function printReport(results, opts = { verbose: false }) {
   }
   console.log();
   console.log(source_default.bold("  Scope"));
+  const userActive = results.scope.activeScope === "user" && results.scope.user.configured;
+  const projectActive = results.scope.activeScope === "project";
+  const activeMark = source_default.cyan(" \u2190 active");
   if (results.scope.user.configured) {
-    console.log(`    User       ${source_default.green("OK")}       ${source_default.dim(results.scope.user.configPath)}`);
+    console.log(
+      `    Cfg(user)  ${source_default.green("OK")}       ${source_default.dim(results.scope.user.configPath)}${userActive ? activeMark : ""}`
+    );
   } else {
-    console.log(`    User       ${source_default.yellow("NOT SET")}  ${source_default.dim("Run: vibe setup")}`);
+    console.log(`    Cfg(user)  ${source_default.yellow("NOT SET")}  ${source_default.dim("Run: vibe setup")}`);
+  }
+  if (results.scope.project.configFileExists) {
+    console.log(
+      `    Cfg(proj)  ${source_default.green("OK")}       ${source_default.dim(results.scope.project.configPath)}${projectActive ? activeMark : ""}`
+    );
+  } else {
+    console.log(
+      `    Cfg(proj)  ${source_default.dim("none")}     ${source_default.dim(`Run: vibe setup --scope project  (cwd: ${results.scope.project.cwd})`)}`
+    );
   }
   if (results.scope.project.initialized) {
     const present = results.scope.project.files.filter((f) => f.exists).map((f) => f.path);
-    console.log(`    Project    ${source_default.green("OK")}       ${source_default.dim(present.join(", "))}`);
+    console.log(`    Init       ${source_default.green("OK")}       ${source_default.dim(present.join(", "))}`);
   } else {
-    console.log(`    Project    ${source_default.yellow("NOT INIT")} ${source_default.dim(`Run: vibe init  (cwd: ${results.scope.project.cwd})`)}`);
+    console.log(`    Init       ${source_default.yellow("NOT INIT")} ${source_default.dim(`Run: vibe init  (cwd: ${results.scope.project.cwd})`)}`);
   }
   console.log(`    Agents     ${source_default.dim(results.scope.agentHosts.summary)}`);
   if (verbose) {
@@ -71689,11 +71813,16 @@ function printReport(results, opts = { verbose: false }) {
   console.log(source_default.bold("  API Keys"));
   const configured = [];
   const missing = [];
+  const labelFor = (configKey, fallbackEnv) => {
+    const label = getDisplayLabelForApiKey(configKey);
+    return label === configKey ? fallbackEnv : label;
+  };
   for (const [name, info] of Object.entries(results.providers)) {
     if (info.configured) {
       configured.push(name);
+      const label = labelFor(name, info.envVar);
       console.log(
-        `    ${source_default.green("OK")}  ${info.envVar.padEnd(24)} ${source_default.dim(info.commands.join(", "))}`
+        `    ${source_default.green("OK")}  ${label.padEnd(28)} ${source_default.dim(info.envVar.padEnd(20))} ${source_default.dim(info.commands.join(", "))}`
       );
     } else {
       missing.push(name);
@@ -71703,8 +71832,9 @@ function printReport(results, opts = { verbose: false }) {
     if (verbose) {
       for (const name of missing) {
         const info = results.providers[name];
+        const label = labelFor(name, info.envVar);
         console.log(
-          `    ${source_default.red("--")}  ${info.envVar.padEnd(24)} ${source_default.dim(info.commands.join(", "))}`
+          `    ${source_default.red("--")}  ${label.padEnd(28)} ${source_default.dim(info.envVar.padEnd(20))} ${source_default.dim(info.commands.join(", "))}`
         );
       }
     } else {
@@ -71812,8 +71942,9 @@ async function runLiveKeyTests(results) {
   console.log();
 }
 function pickNextStep(results, hasMissingProviders) {
-  if (!results.scope.user.configured) {
-    return "Next: run 'vibe setup' to configure your user scope (API keys + LLM provider).";
+  const anyConfigured = results.scope.user.configured || results.scope.project.configFileExists;
+  if (!anyConfigured) {
+    return "Next: run 'vibe setup' (or 'vibe setup --scope project' to keep config inside the project) to configure API keys + LLM provider.";
   }
   if (!results.scope.project.initialized) {
     return "Next: run 'vibe init' in your project directory to scaffold AGENTS.md / CLAUDE.md / .env.example.";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibeframe/cli",
-  "version": "0.89.0",
+  "version": "0.91.0",
   "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.89.0",
-    "@vibeframe/core": "0.89.0"
+    "@vibeframe/ai-providers": "0.91.0",
+    "@vibeframe/core": "0.91.0"
   },
   "engines": {
     "node": ">=20"