@vibeframe/cli 0.106.6 → 0.106.8

package/dist/commands/_shared/scene-render.d.ts

@@ -17,6 +17,7 @@ import { type SceneAspect } from "./scene-project.js";
 export type RenderFps = 24 | 30 | 60;
 export type RenderQuality = "draft" | "standard" | "high";
 export type RenderFormat = "mp4" | "webm" | "mov";
+export type RenderOpenAction = "open" | "reveal";
 export interface SceneRenderOptions {
     /** Project directory (defaults to cwd). */
     projectDir?: string;
@@ -33,6 +34,10 @@ export interface SceneRenderOptions {
     /** Hyperframes capture worker count. Default 1 (the existing backend's
      *  default — auto-worker mode times out on small comps). */
     workers?: number;
+    /** Open the rendered media in the OS default app after a successful render. */
+    openAfterRender?: boolean;
+    /** Reveal the rendered media in Finder/file manager after a successful render. */
+    revealInFinder?: boolean;
     signal?: AbortSignal;
     onProgress?: (pct: number, stage: string) => void;
 }
@@ -42,6 +47,13 @@ export interface SceneRenderResult {
     beat?: string | null;
     root?: string;
     outputPath?: string;
+    absoluteOutputPath?: string;
+    openCommand?: string;
+    revealCommand?: string;
+    opened?: boolean;
+    revealed?: boolean;
+    openError?: string;
+    revealError?: string;
     durationMs?: number;
     framesRendered?: number;
     totalFrames?: number;
@@ -59,6 +71,11 @@ export interface SceneRenderResult {
     error?: string;
     retryWith?: string[];
 }
+export interface MediaOpenCommand {
+    command: string;
+    args: string[];
+    display: string;
+}
 /** Map a quality preset to an x264 CRF (lower = higher quality). */
 export declare function qualityToCrf(quality?: RenderQuality): number;
 /**
@@ -85,6 +102,7 @@ export declare function buildRenderConfig(opts: {
     workers?: number;
     entryFile?: string;
 }): RenderConfig;
+export declare function buildMediaOpenCommand(action: RenderOpenAction, filePath: string, platform?: NodeJS.Platform): MediaOpenCommand;
 /**
  * Render a scene project. Mirrors the contract of the existing Hyperframes
  * backend (preflight → execute → structured result), but skips the

package/dist/index.js

@@ -31472,11 +31472,11 @@ registerRoot(Root);
   return dir;
 }
 async function this_npmInstall(dir) {
-  const { execFile: execFile2 } = await import("node:child_process");
-  const { promisify: promisify2 } = await import("node:util");
-  const execFileAsync2 = promisify2(execFile2);
+  const { execFile: execFile3 } = await import("node:child_process");
+  const { promisify: promisify3 } = await import("node:util");
+  const execFileAsync3 = promisify3(execFile3);
   try {
-    await execFileAsync2("npm", ["install", "--prefer-offline", "--no-audit", "--no-fund"], {
+    await execFileAsync3("npm", ["install", "--prefer-offline", "--no-audit", "--no-fund"], {
       cwd: dir,
       timeout: 18e4
     });
@@ -31500,13 +31500,13 @@ async function renderMotion(options) {
   );
   try {
     const entryPoint = join9(dir, "Root.tsx");
-    const { execFile: execFile2 } = await import("node:child_process");
-    const { promisify: promisify2 } = await import("node:util");
-    const execFileAsync2 = promisify2(execFile2);
+    const { execFile: execFile3 } = await import("node:child_process");
+    const { promisify: promisify3 } = await import("node:util");
+    const execFileAsync3 = promisify3(execFile3);
     if (transparent) {
       const webmOut = options.outputPath.replace(/\.\w+$/, ".webm");
       try {
-        await execFileAsync2("npx", [
+        await execFileAsync3("npx", [
           "remotion",
           "render",
           entryPoint,
@@ -31523,7 +31523,7 @@ async function renderMotion(options) {
       } catch {
       }
       try {
-        await execFileAsync2("npx", [
+        await execFileAsync3("npx", [
           "remotion",
           "render",
           entryPoint,
@@ -31543,7 +31543,7 @@ async function renderMotion(options) {
       }
     }
     const mp4Out = options.outputPath.replace(/\.\w+$/, ".mp4");
-    await execFileAsync2("npx", [
+    await execFileAsync3("npx", [
       "remotion",
       "render",
       entryPoint,
@@ -59857,15 +59857,18 @@ var init_scene_audio_mux = __esm({
 // src/commands/_shared/scene-render.ts
 var scene_render_exports = {};
 __export(scene_render_exports, {
+  buildMediaOpenCommand: () => buildMediaOpenCommand,
   buildRenderConfig: () => buildRenderConfig,
   defaultOutputPath: () => defaultOutputPath,
   executeSceneRender: () => executeSceneRender,
   prepareBeatRenderRoot: () => prepareBeatRenderRoot,
   qualityToCrf: () => qualityToCrf2
 });
+import { execFile as execFile2 } from "node:child_process";
 import { existsSync as existsSync46 } from "node:fs";
 import { mkdir as mkdir24, readFile as readFile43, stat as stat8, writeFile as writeFile48 } from "node:fs/promises";
 import { resolve as resolve62, relative as relative11, dirname as dirname22, basename as basename21, join as join22, isAbsolute as isAbsolute6 } from "node:path";
+import { promisify as promisify2 } from "node:util";
 import {
   createRenderJob,
   executeRenderJob
@@ -59892,6 +59895,38 @@ function buildRenderConfig(opts) {
     workers: opts.workers ?? 1
   };
 }
+function buildMediaOpenCommand(action, filePath, platform3 = process.platform) {
+  if (platform3 === "darwin") {
+    const args = action === "reveal" ? ["-R", filePath] : [filePath];
+    return {
+      command: "open",
+      args,
+      display: ["open", ...args].map(quoteCliArg).join(" ")
+    };
+  }
+  if (platform3 === "win32") {
+    if (action === "reveal") {
+      const args2 = [`/select,${filePath}`];
+      return {
+        command: "explorer",
+        args: args2,
+        display: ["explorer", ...args2].map(quoteCliArg).join(" ")
+      };
+    }
+    const args = ["/c", "start", "", filePath];
+    return {
+      command: "cmd",
+      args,
+      display: ["cmd", ...args].map(quoteCliArg).join(" ")
+    };
+  }
+  const target = action === "reveal" ? dirname22(filePath) : filePath;
+  return {
+    command: "xdg-open",
+    args: [target],
+    display: ["xdg-open", target].map(quoteCliArg).join(" ")
+  };
+}
 async function executeSceneRender(opts = {}) {
   const projectDir = resolve62(opts.projectDir ?? ".");
   const projectConfig = await readProjectConfig(projectDir);
@@ -60015,6 +60050,9 @@ async function executeSceneRender(opts = {}) {
     beat: opts.beatId ?? null,
     root,
     outputPath: relative11(process.cwd(), outputPath) || outputPath,
+    absoluteOutputPath: outputPath,
+    openCommand: buildMediaOpenCommand("open", outputPath).display,
+    revealCommand: buildMediaOpenCommand("reveal", outputPath).display,
     durationMs: Date.now() - start,
     framesRendered: job.framesRendered,
     totalFrames: job.totalFrames,
@@ -60025,12 +60063,38 @@ async function executeSceneRender(opts = {}) {
     audioMuxApplied,
     audioMuxWarning
   };
+  if (opts.revealInFinder) {
+    try {
+      await runMediaOpenAction("reveal", outputPath);
+      result.revealed = true;
+    } catch (err) {
+      result.revealed = false;
+      result.revealError = err instanceof Error ? err.message : String(err);
+    }
+  }
+  if (opts.openAfterRender) {
+    try {
+      await runMediaOpenAction("open", outputPath);
+      result.opened = true;
+    } catch (err) {
+      result.opened = false;
+      result.openError = err instanceof Error ? err.message : String(err);
+    }
+  }
   result.reportPath = await writeRenderReport(projectDir, {
     ...result,
     outputPath
   });
   return result;
 }
+async function runMediaOpenAction(action, filePath) {
+  const cmd = buildMediaOpenCommand(action, filePath);
+  await execFileAsync2(cmd.command, cmd.args);
+}
+function quoteCliArg(value) {
+  if (/^[A-Za-z0-9_/@%+=:,.-]+$/.test(value)) return value;
+  return `"${value.replace(/(["\\$`])/g, "\\$1")}"`;
+}
 async function safeStat(p) {
   try {
     return await stat8(p);
@@ -60201,6 +60265,13 @@ async function writeRenderReport(projectDir, result) {
           beat: result.beat ?? null,
           root: result.root,
           outputPath: result.outputPath,
+          absoluteOutputPath: result.absoluteOutputPath,
+          openCommand: result.openCommand,
+          revealCommand: result.revealCommand,
+          opened: result.opened,
+          revealed: result.revealed,
+          openError: result.openError,
+          revealError: result.revealError,
           fps: result.fps,
           quality: result.quality,
           format: result.format,
@@ -60245,6 +60316,7 @@ function escapeAttr(value) {
 function unique4(items) {
   return [...new Set(items.filter((item) => Boolean(item)))];
 }
+var execFileAsync2;
 var init_scene_render = __esm({
   "src/commands/_shared/scene-render.ts"() {
     "use strict";
@@ -60254,6 +60326,7 @@ var init_scene_render = __esm({
     init_scene_audio_mux();
     init_project_config();
     init_scene_project();
+    execFileAsync2 = promisify2(execFile2);
   }
 });
 
@@ -67341,7 +67414,9 @@ var init_scene2 = __esm({
       fps: external_exports.number().optional().describe("Frames per second. Must be 24, 30, or 60. Default 30."),
       quality: external_exports.enum(["draft", "standard", "high"]).optional().describe("Quality preset. Default 'standard'."),
       format: external_exports.enum(["mp4", "webm", "mov"]).optional().describe("Container format. Default 'mp4'."),
-      workers: external_exports.number().optional().describe("Capture worker count (1-16). Default 1.")
+      workers: external_exports.number().optional().describe("Capture worker count (1-16). Default 1."),
+      openAfterRender: external_exports.boolean().optional().describe("Open the rendered video in the OS default app after render. Default false."),
+      revealInFinder: external_exports.boolean().optional().describe("Reveal the rendered video in Finder/file manager after render. Default false.")
     });
     sceneRenderTool = defineTool({
       name: "render",
@@ -67359,7 +67434,9 @@ var init_scene2 = __esm({
           fps: args.fps,
           quality: args.quality,
           format: args.format,
-          workers: args.workers
+          workers: args.workers,
+          openAfterRender: args.openAfterRender,
+          revealInFinder: args.revealInFinder
         });
         if (!result.success) {
           return { success: false, error: result.error ?? "render failed" };
@@ -67368,6 +67445,13 @@ var init_scene2 = __esm({
           success: true,
           data: {
             outputPath: result.outputPath,
+            absoluteOutputPath: result.absoluteOutputPath,
+            openCommand: result.openCommand,
+            revealCommand: result.revealCommand,
+            opened: result.opened,
+            revealed: result.revealed,
+            openError: result.openError,
+            revealError: result.revealError,
             beat: result.beat,
             root: result.root,
             reportPath: result.reportPath,
@@ -67376,13 +67460,24 @@ var init_scene2 = __esm({
             totalFrames: result.totalFrames,
             fps: result.fps,
             quality: result.quality,
-            format: result.format
+            format: result.format,
+            audioCount: result.audioCount,
+            audioMuxApplied: result.audioMuxApplied,
+            audioMuxWarning: result.audioMuxWarning
           },
           humanLines: [
-            `\u2705 Render complete: ${result.outputPath}`,
+            `\u2705 Render complete: ${result.absoluteOutputPath ?? result.outputPath}`,
             `   duration: ${((result.durationMs ?? 0) / 1e3).toFixed(1)}s`,
             `   frames:   ${result.framesRendered ?? "?"}${result.totalFrames ? ` / ${result.totalFrames}` : ""}`,
-            `   config:   ${result.fps}fps \xB7 ${result.quality} \xB7 ${result.format}`
+            `   config:   ${result.fps}fps \xB7 ${result.quality} \xB7 ${result.format}`,
+            `   audio:    ${result.audioCount && result.audioCount > 0 ? `${result.audioCount} track${result.audioCount === 1 ? "" : "s"} muxed` : "silent"}`,
+            ...result.openCommand ? [`   open:     ${result.openCommand}`] : [],
+            ...result.revealCommand ? [`   reveal:   ${result.revealCommand}`] : [],
+            `   inspect:  vibe inspect render ${projectDir} --cheap --json`,
+            ...result.opened ? [`   opened:   yes`] : [],
+            ...result.revealed ? [`   revealed: yes`] : [],
+            ...result.openError ? [`   open warning: ${result.openError}`] : [],
+            ...result.revealError ? [`   reveal warning: ${result.revealError}`] : []
           ]
         };
       }
@@ -72028,7 +72123,7 @@ init_source();
 // package.json
 var package_default = {
   name: "@vibeframe/cli",
-  version: "0.106.6",
+  version: "0.106.8",
   description: "VibeFrame CLI - agentic video workflow runtime",
   private: false,
   license: "MIT",
@@ -80703,7 +80798,18 @@ function resolveHostSelection(selection) {
   return [selection];
 }
 function vibeframeMcpJson(host, projectDir) {
-  return host.id === "claude-desktop" ? { ...VIBEFRAME_MCP_JSON, cwd: resolve53(projectDir) } : { ...VIBEFRAME_MCP_JSON };
+  if (host.id !== "claude-desktop") return { ...VIBEFRAME_MCP_JSON };
+  const workspace = resolve53(projectDir);
+  if (process.platform === "win32") {
+    return {
+      command: "cmd.exe",
+      args: ["/d", "/s", "/c", `cd /d ${cmdQuote(workspace)} && npx -y @vibeframe/mcp-server`]
+    };
+  }
+  return {
+    command: "bash",
+    args: ["-lc", `cd ${shellQuote(workspace)} && exec npx -y @vibeframe/mcp-server`]
+  };
 }
 function renderHostSnippet(host, projectDir) {
   if (host.configKind === "codex-toml") return CODEX_MCP_BLOCK.trimEnd();
@@ -80768,9 +80874,9 @@ async function inspectHost(host, projectDir) {
         const json = JSON.parse(content);
         configured = hasVibeframeMcpServer(json);
         const server = readVibeframeMcpServer(json);
-        if (host.id === "claude-desktop" && configured && !server?.cwd) {
+        if (host.id === "claude-desktop" && configured && !isAnchoredClaudeDesktopServer(server)) {
           warnings.push(
-            "Claude Desktop vibeframe MCP config has no cwd; run `vibe host setup claude-desktop <workspace> --write` to anchor relative paths."
+            "Claude Desktop vibeframe MCP config is not workspace-anchored; run `vibe host setup claude-desktop <workspace> --write` to anchor relative paths."
           );
         }
       }
@@ -80794,17 +80900,17 @@ async function mergeMcpJson(configPath, opts) {
   const mcpServers = typeof root.mcpServers === "object" && root.mcpServers !== null && !Array.isArray(root.mcpServers) ? root.mcpServers : {};
   if (mcpServers.vibeframe && !opts.force) {
     const existing = mcpServers.vibeframe;
-    if (canAddMissingCwd(existing, opts.server)) {
+    if (canUpgradeDefaultServer(existing, opts.server)) {
       root.mcpServers = {
         ...mcpServers,
-        vibeframe: { ...existing, cwd: opts.server.cwd }
+        vibeframe: opts.server
       };
       await mkdir22(dirname18(configPath), { recursive: true });
       if (exists && opts.backup) {
         await writeFile44(`${configPath}.bak-${timestamp()}`, await readFile37(configPath, "utf-8"), "utf-8");
       }
       await writeFile44(configPath, JSON.stringify(root, null, 2) + "\n", "utf-8");
-      return { path: configPath, status: "merged", reason: "added cwd to existing vibeframe MCP server" };
+      return { path: configPath, status: "merged", reason: "anchored existing default vibeframe MCP server" };
     }
     return {
       path: configPath,
@@ -80874,14 +80980,24 @@ function readVibeframeMcpServer(value) {
   if (!server || typeof server !== "object" || Array.isArray(server)) return null;
   return server;
 }
-function canAddMissingCwd(existing, target) {
-  if (!target.cwd) return false;
+function isAnchoredClaudeDesktopServer(server) {
+  if (!server) return false;
+  if (server.command === "bash" && Array.isArray(server.args)) {
+    return server.args[0] === "-lc" && typeof server.args[1] === "string" && server.args[1].includes("exec npx -y @vibeframe/mcp-server");
+  }
+  if (server.command === "cmd.exe" && Array.isArray(server.args)) {
+    return server.args.some((arg) => typeof arg === "string" && arg.includes("npx -y @vibeframe/mcp-server"));
+  }
+  return false;
+}
+function canUpgradeDefaultServer(existing, target) {
   if (!existing || typeof existing !== "object" || Array.isArray(existing)) return false;
   const current = existing;
-  if (current.cwd) return false;
-  if (current.command !== target.command) return false;
   if (!Array.isArray(current.args)) return false;
-  return JSON.stringify(current.args) === JSON.stringify(target.args);
+  if (current.command === target.command && JSON.stringify(current.args) === JSON.stringify(target.args)) {
+    return false;
+  }
+  return current.command === VIBEFRAME_MCP_JSON.command && JSON.stringify(current.args) === JSON.stringify(VIBEFRAME_MCP_JSON.args);
 }
 function hostNextSteps(host) {
   if (host.id === "codex") {
@@ -80921,6 +81037,12 @@ function ensureTrailingNewline(value) {
 function escapeRegExp3(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
+function shellQuote(value) {
+  return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+function cmdQuote(value) {
+  return `"${value.replace(/"/g, '""')}"`;
+}
 
 // src/commands/_shared/init-templates.ts
 var AGENTS_MD = `# AGENTS.md
@@ -82704,7 +82826,7 @@ import { resolve as resolve65 } from "node:path";
 var VALID_FPS = [24, 30, 60];
 var VALID_QUALITIES = ["draft", "standard", "high"];
 var VALID_FORMATS = ["mp4", "webm", "mov"];
-var renderCommand = new Command("render").description("Render a VibeFrame video project to MP4/WebM/MOV").argument("[project-dir]", "Video project directory", ".").option("-o, --out <path>", "Output file (default: renders/<name>-<timestamp>.<format>)").option("--root <file>", "Root composition file", "index.html").option("--beat <id>", "Render only one storyboard beat using a temporary root").option("--fps <n>", `Frames per second: ${VALID_FPS.join("|")}`, "30").option("--quality <q>", `Quality preset: ${VALID_QUALITIES.join("|")}`, "standard").option("--format <f>", `Output container: ${VALID_FORMATS.join("|")}`, "mp4").option("--workers <n>", "Capture workers (1-16, default 1)", "1").option("--dry-run", "Preview parameters without rendering").addHelpText("after", `
+var renderCommand = new Command("render").description("Render a VibeFrame video project to MP4/WebM/MOV").argument("[project-dir]", "Video project directory", ".").option("-o, --out <path>", "Output file (default: renders/<name>-<timestamp>.<format>)").option("--root <file>", "Root composition file", "index.html").option("--beat <id>", "Render only one storyboard beat using a temporary root").option("--fps <n>", `Frames per second: ${VALID_FPS.join("|")}`, "30").option("--quality <q>", `Quality preset: ${VALID_QUALITIES.join("|")}`, "standard").option("--format <f>", `Output container: ${VALID_FORMATS.join("|")}`, "mp4").option("--workers <n>", "Capture workers (1-16, default 1)", "1").option("--open", "Open the rendered video in the OS default app after render").option("--reveal", "Reveal the rendered video in Finder/file manager after render").option("--dry-run", "Preview parameters without rendering").addHelpText("after", `
 Examples:
   $ vibe render my-video
   $ vibe render my-video -o renders/final.mp4 --quality high
@@ -82724,7 +82846,9 @@ Alias note: this is the project-level entrypoint for \`vibe scene render\`.`).ac
     fps,
     quality,
     format,
-    workers
+    workers,
+    openAfterRender: Boolean(options.open),
+    revealInFinder: Boolean(options.reveal)
   };
   if (options.dryRun) {
     if (!isJsonMode() && !isQuietMode()) {
@@ -82749,6 +82873,8 @@ Alias note: this is the project-level entrypoint for \`vibe scene render\`.`).ac
     quality,
     format,
     workers,
+    openAfterRender: Boolean(options.open),
+    revealInFinder: Boolean(options.reveal),
     onProgress: (pct, stage) => {
       if (spinner2) spinner2.text = `Rendering [${Math.round(pct * 100)}%] ${stage}`;
     }
@@ -82779,6 +82905,8 @@ function printRenderDryRun(projectDirArg, params) {
   console.log(`  Format:        ${source_default.bold(params.format)}`);
   console.log(`  Quality/FPS:   ${source_default.bold(`${params.quality} / ${params.fps}`)}`);
   console.log(`  Workers:       ${source_default.bold(String(params.workers))}`);
+  if (params.openAfterRender) console.log(`  Open:          ${source_default.bold("yes")}`);
+  if (params.revealInFinder) console.log(`  Reveal:        ${source_default.bold("yes")}`);
   console.log();
   console.log(source_default.dim("No browser capture, FFmpeg mux, or video files were created."));
 }
@@ -82787,7 +82915,7 @@ function printRenderResult(spinner2, result) {
   console.log();
   console.log(source_default.bold.cyan("Output"));
   console.log(source_default.dim("-".repeat(60)));
-  console.log(`  File:      ${source_default.bold(result.outputPath)}`);
+  console.log(`  File:      ${source_default.bold(result.absoluteOutputPath ?? result.outputPath)}`);
   if (result.beat) console.log(`  Beat:      ${result.beat}`);
   if (result.root) console.log(`  Root:      ${result.root}`);
   console.log(`  Format:    ${result.format ?? "mp4"}`);
@@ -82800,6 +82928,12 @@ function printRenderResult(spinner2, result) {
     console.log(`  Audio:     ${audio}`);
   }
   if (result.audioMuxWarning) console.log(source_default.yellow(`  Warning:   ${result.audioMuxWarning}`));
+  if (result.openCommand) console.log(`  Open:      ${source_default.dim(result.openCommand)}`);
+  if (result.revealCommand) console.log(`  Reveal:    ${source_default.dim(result.revealCommand)}`);
+  if (result.opened) console.log(source_default.green("  Opened:    yes"));
+  if (result.revealed) console.log(source_default.green("  Revealed:  yes"));
+  if (result.openError) console.log(source_default.yellow(`  Open warn: ${result.openError}`));
+  if (result.revealError) console.log(source_default.yellow(`  Reveal warn: ${result.revealError}`));
 }
 function parseFps(value) {
   const n = Number.parseInt(value, 10);

package/dist/tools/adapters/mcp.js

@@ -109,6 +109,56 @@ function zodToJsonSchema(schema) {
 }
 
 // src/tools/adapters/mcp.ts
+function formatConsolePart(value) {
+  if (typeof value === "string") return value;
+  if (value instanceof Error) return value.stack ?? value.message;
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return String(value);
+  }
+}
+function invokeWriteCallback(encodingOrCallback, callback) {
+  const cb = typeof encodingOrCallback === "function" ? encodingOrCallback : typeof callback === "function" ? callback : void 0;
+  if (cb) queueMicrotask(() => cb());
+}
+function formatStdoutChunk(chunk, encodingOrCallback) {
+  if (Buffer.isBuffer(chunk)) {
+    const encoding = typeof encodingOrCallback === "string" ? encodingOrCallback : "utf8";
+    return chunk.toString(encoding);
+  }
+  return String(chunk);
+}
+async function withCapturedStdout(fn) {
+  const originalWrite = process.stdout.write;
+  const originalConsoleLog = console.log;
+  const originalConsoleInfo = console.info;
+  const originalConsoleDebug = console.debug;
+  let captured = "";
+  const captureConsole = (...values) => {
+    captured += `${values.map(formatConsolePart).join(" ")}
+`;
+  };
+  process.stdout.write = (chunk, encodingOrCallback, callback) => {
+    captured += formatStdoutChunk(chunk, encodingOrCallback);
+    invokeWriteCallback(encodingOrCallback, callback);
+    return true;
+  };
+  console.log = captureConsole;
+  console.info = captureConsole;
+  console.debug = captureConsole;
+  try {
+    return await fn();
+  } finally {
+    process.stdout.write = originalWrite;
+    console.log = originalConsoleLog;
+    console.info = originalConsoleInfo;
+    console.debug = originalConsoleDebug;
+    if (captured.trim() && process.env.VIBE_MCP_DEBUG_STDIO === "1") {
+      process.stderr.write(captured);
+    }
+  }
+}
 function formatZodError(err) {
   const missing = err.issues.filter((i) => {
     if (i.code !== "invalid_type") return false;
@@ -155,10 +205,12 @@ function buildMcpDispatcher(manifest) {
       };
     }
     try {
-      const result = await tool.execute(parsed.data, {
-        workingDirectory: process.cwd(),
-        surface: "mcp"
-      });
+      const result = await withCapturedStdout(
+        () => tool.execute(parsed.data, {
+          workingDirectory: process.cwd(),
+          surface: "mcp"
+        })
+      );
       const text = result.success ? JSON.stringify({ success: true, ...result.data }) : result.data ? JSON.stringify({
         success: false,
         error: result.error ?? "unknown error",

package/dist/tools/manifest/index.js

@@ -29537,15 +29537,18 @@ var init_scene_audio_mux = __esm({
 // src/commands/_shared/scene-render.ts
 var scene_render_exports = {};
 __export(scene_render_exports, {
+  buildMediaOpenCommand: () => buildMediaOpenCommand,
   buildRenderConfig: () => buildRenderConfig,
   defaultOutputPath: () => defaultOutputPath,
   executeSceneRender: () => executeSceneRender,
   prepareBeatRenderRoot: () => prepareBeatRenderRoot,
   qualityToCrf: () => qualityToCrf
 });
+import { execFile as execFile2 } from "node:child_process";
 import { existsSync as existsSync11 } from "node:fs";
 import { mkdir as mkdir6, readFile as readFile12, stat as stat2, writeFile as writeFile11 } from "node:fs/promises";
 import { resolve as resolve15, relative as relative6, dirname as dirname5, basename as basename3, join as join10, isAbsolute } from "node:path";
+import { promisify as promisify2 } from "node:util";
 import {
   createRenderJob,
   executeRenderJob
@@ -29572,6 +29575,38 @@ function buildRenderConfig(opts) {
     workers: opts.workers ?? 1
   };
 }
+function buildMediaOpenCommand(action, filePath, platform = process.platform) {
+  if (platform === "darwin") {
+    const args = action === "reveal" ? ["-R", filePath] : [filePath];
+    return {
+      command: "open",
+      args,
+      display: ["open", ...args].map(quoteCliArg).join(" ")
+    };
+  }
+  if (platform === "win32") {
+    if (action === "reveal") {
+      const args2 = [`/select,${filePath}`];
+      return {
+        command: "explorer",
+        args: args2,
+        display: ["explorer", ...args2].map(quoteCliArg).join(" ")
+      };
+    }
+    const args = ["/c", "start", "", filePath];
+    return {
+      command: "cmd",
+      args,
+      display: ["cmd", ...args].map(quoteCliArg).join(" ")
+    };
+  }
+  const target = action === "reveal" ? dirname5(filePath) : filePath;
+  return {
+    command: "xdg-open",
+    args: [target],
+    display: ["xdg-open", target].map(quoteCliArg).join(" ")
+  };
+}
 async function executeSceneRender(opts = {}) {
   const projectDir = resolve15(opts.projectDir ?? ".");
   const projectConfig = await readProjectConfig(projectDir);
@@ -29695,6 +29730,9 @@ async function executeSceneRender(opts = {}) {
     beat: opts.beatId ?? null,
     root,
     outputPath: relative6(process.cwd(), outputPath) || outputPath,
+    absoluteOutputPath: outputPath,
+    openCommand: buildMediaOpenCommand("open", outputPath).display,
+    revealCommand: buildMediaOpenCommand("reveal", outputPath).display,
     durationMs: Date.now() - start,
     framesRendered: job.framesRendered,
     totalFrames: job.totalFrames,
@@ -29705,12 +29743,38 @@ async function executeSceneRender(opts = {}) {
     audioMuxApplied,
     audioMuxWarning
   };
+  if (opts.revealInFinder) {
+    try {
+      await runMediaOpenAction("reveal", outputPath);
+      result.revealed = true;
+    } catch (err) {
+      result.revealed = false;
+      result.revealError = err instanceof Error ? err.message : String(err);
+    }
+  }
+  if (opts.openAfterRender) {
+    try {
+      await runMediaOpenAction("open", outputPath);
+      result.opened = true;
+    } catch (err) {
+      result.opened = false;
+      result.openError = err instanceof Error ? err.message : String(err);
+    }
+  }
   result.reportPath = await writeRenderReport(projectDir, {
     ...result,
     outputPath
   });
   return result;
 }
+async function runMediaOpenAction(action, filePath) {
+  const cmd = buildMediaOpenCommand(action, filePath);
+  await execFileAsync2(cmd.command, cmd.args);
+}
+function quoteCliArg(value) {
+  if (/^[A-Za-z0-9_/@%+=:,.-]+$/.test(value)) return value;
+  return `"${value.replace(/(["\\$`])/g, "\\$1")}"`;
+}
 async function safeStat(p) {
   try {
     return await stat2(p);
@@ -29881,6 +29945,13 @@ async function writeRenderReport(projectDir, result) {
           beat: result.beat ?? null,
           root: result.root,
           outputPath: result.outputPath,
+          absoluteOutputPath: result.absoluteOutputPath,
+          openCommand: result.openCommand,
+          revealCommand: result.revealCommand,
+          opened: result.opened,
+          revealed: result.revealed,
+          openError: result.openError,
+          revealError: result.revealError,
           fps: result.fps,
           quality: result.quality,
           format: result.format,
@@ -29925,6 +29996,7 @@ function escapeAttr(value) {
 function unique(items) {
   return [...new Set(items.filter((item) => Boolean(item)))];
 }
+var execFileAsync2;
 var init_scene_render = __esm({
   "src/commands/_shared/scene-render.ts"() {
     "use strict";
@@ -29934,6 +30006,7 @@ var init_scene_render = __esm({
     init_scene_audio_mux();
     init_project_config();
     init_scene_project();
+    execFileAsync2 = promisify2(execFile2);
   }
 });
 
@@ -35843,11 +35916,11 @@ registerRoot(Root);
   return dir;
 }
 async function this_npmInstall(dir) {
-  const { execFile: execFile2 } = await import("node:child_process");
-  const { promisify: promisify2 } = await import("node:util");
-  const execFileAsync2 = promisify2(execFile2);
+  const { execFile: execFile3 } = await import("node:child_process");
+  const { promisify: promisify3 } = await import("node:util");
+  const execFileAsync3 = promisify3(execFile3);
   try {
-    await execFileAsync2("npm", ["install", "--prefer-offline", "--no-audit", "--no-fund"], {
+    await execFileAsync3("npm", ["install", "--prefer-offline", "--no-audit", "--no-fund"], {
       cwd: dir,
       timeout: 18e4
     });
@@ -35871,13 +35944,13 @@ async function renderMotion(options) {
   );
   try {
     const entryPoint = join16(dir, "Root.tsx");
-    const { execFile: execFile2 } = await import("node:child_process");
-    const { promisify: promisify2 } = await import("node:util");
-    const execFileAsync2 = promisify2(execFile2);
+    const { execFile: execFile3 } = await import("node:child_process");
+    const { promisify: promisify3 } = await import("node:util");
+    const execFileAsync3 = promisify3(execFile3);
     if (transparent) {
       const webmOut = options.outputPath.replace(/\.\w+$/, ".webm");
       try {
-        await execFileAsync2("npx", [
+        await execFileAsync3("npx", [
           "remotion",
           "render",
           entryPoint,
@@ -35894,7 +35967,7 @@ async function renderMotion(options) {
       } catch {
       }
       try {
-        await execFileAsync2("npx", [
+        await execFileAsync3("npx", [
           "remotion",
           "render",
           entryPoint,
@@ -35914,7 +35987,7 @@ async function renderMotion(options) {
       }
     }
     const mp4Out = options.outputPath.replace(/\.\w+$/, ".mp4");
-    await execFileAsync2("npx", [
+    await execFileAsync3("npx", [
       "remotion",
       "render",
       entryPoint,
@@ -52583,7 +52656,9 @@ var sceneRenderSchema = external_exports.object({
   fps: external_exports.number().optional().describe("Frames per second. Must be 24, 30, or 60. Default 30."),
   quality: external_exports.enum(["draft", "standard", "high"]).optional().describe("Quality preset. Default 'standard'."),
   format: external_exports.enum(["mp4", "webm", "mov"]).optional().describe("Container format. Default 'mp4'."),
-  workers: external_exports.number().optional().describe("Capture worker count (1-16). Default 1.")
+  workers: external_exports.number().optional().describe("Capture worker count (1-16). Default 1."),
+  openAfterRender: external_exports.boolean().optional().describe("Open the rendered video in the OS default app after render. Default false."),
+  revealInFinder: external_exports.boolean().optional().describe("Reveal the rendered video in Finder/file manager after render. Default false.")
 });
 var sceneRenderTool = defineTool({
   name: "render",
@@ -52601,7 +52676,9 @@ var sceneRenderTool = defineTool({
       fps: args.fps,
       quality: args.quality,
       format: args.format,
-      workers: args.workers
+      workers: args.workers,
+      openAfterRender: args.openAfterRender,
+      revealInFinder: args.revealInFinder
     });
     if (!result.success) {
       return { success: false, error: result.error ?? "render failed" };
@@ -52610,6 +52687,13 @@ var sceneRenderTool = defineTool({
       success: true,
       data: {
         outputPath: result.outputPath,
+        absoluteOutputPath: result.absoluteOutputPath,
+        openCommand: result.openCommand,
+        revealCommand: result.revealCommand,
+        opened: result.opened,
+        revealed: result.revealed,
+        openError: result.openError,
+        revealError: result.revealError,
         beat: result.beat,
         root: result.root,
         reportPath: result.reportPath,
@@ -52618,13 +52702,24 @@ var sceneRenderTool = defineTool({
         totalFrames: result.totalFrames,
         fps: result.fps,
         quality: result.quality,
-        format: result.format
+        format: result.format,
+        audioCount: result.audioCount,
+        audioMuxApplied: result.audioMuxApplied,
+        audioMuxWarning: result.audioMuxWarning
       },
       humanLines: [
-        `\u2705 Render complete: ${result.outputPath}`,
+        `\u2705 Render complete: ${result.absoluteOutputPath ?? result.outputPath}`,
         `   duration: ${((result.durationMs ?? 0) / 1e3).toFixed(1)}s`,
         `   frames:   ${result.framesRendered ?? "?"}${result.totalFrames ? ` / ${result.totalFrames}` : ""}`,
-        `   config:   ${result.fps}fps \xB7 ${result.quality} \xB7 ${result.format}`
+        `   config:   ${result.fps}fps \xB7 ${result.quality} \xB7 ${result.format}`,
+        `   audio:    ${result.audioCount && result.audioCount > 0 ? `${result.audioCount} track${result.audioCount === 1 ? "" : "s"} muxed` : "silent"}`,
+        ...result.openCommand ? [`   open:     ${result.openCommand}`] : [],
+        ...result.revealCommand ? [`   reveal:   ${result.revealCommand}`] : [],
+        `   inspect:  vibe inspect render ${projectDir} --cheap --json`,
+        ...result.opened ? [`   opened:   yes`] : [],
+        ...result.revealed ? [`   revealed: yes`] : [],
+        ...result.openError ? [`   open warning: ${result.openError}`] : [],
+        ...result.revealError ? [`   reveal warning: ${result.revealError}`] : []
       ]
     };
   }

package/dist/tools/manifest/scene.d.ts

@@ -108,6 +108,8 @@ export declare const sceneRenderTool: import("../define-tool.js").ToolDefinition
     quality: z.ZodOptional<z.ZodEnum<["draft", "standard", "high"]>>;
     format: z.ZodOptional<z.ZodEnum<["mp4", "webm", "mov"]>>;
     workers: z.ZodOptional<z.ZodNumber>;
+    openAfterRender: z.ZodOptional<z.ZodBoolean>;
+    revealInFinder: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     output?: string | undefined;
     fps?: number | undefined;
@@ -117,6 +119,8 @@ export declare const sceneRenderTool: import("../define-tool.js").ToolDefinition
     root?: string | undefined;
     beat?: string | undefined;
     workers?: number | undefined;
+    openAfterRender?: boolean | undefined;
+    revealInFinder?: boolean | undefined;
 }, {
     output?: string | undefined;
     fps?: number | undefined;
@@ -126,6 +130,8 @@ export declare const sceneRenderTool: import("../define-tool.js").ToolDefinition
     root?: string | undefined;
     beat?: string | undefined;
     workers?: number | undefined;
+    openAfterRender?: boolean | undefined;
+    revealInFinder?: boolean | undefined;
 }>>;
 export declare const sceneBuildTool: import("../define-tool.js").ToolDefinition<z.ZodObject<{
     projectDir: z.ZodOptional<z.ZodString>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibeframe/cli",
-  "version": "0.106.6",
+  "version": "0.106.8",
   "description": "VibeFrame CLI - agentic video workflow runtime",
   "private": false,
   "license": "MIT",
@@ -83,8 +83,8 @@
     "tsx": "^4.21.0",
     "typescript": "^5.3.3",
     "vitest": "^1.2.2",
-    "@vibeframe/ai-providers": "0.106.6",
-    "@vibeframe/core": "0.106.6"
+    "@vibeframe/ai-providers": "0.106.8",
+    "@vibeframe/core": "0.106.8"
   },
   "engines": {
     "node": ">=20"