vybekiit 0.4.0 → 0.6.0

package/dist/bin.js

@@ -3084,7 +3084,7 @@ var require_dist = __commonJS({
     function parse(stream, callback) {
       const parser = new parser_1.Parser();
       stream.on("data", (buffer) => parser.parse(buffer, callback));
-      return new Promise((resolve14) => stream.on("end", () => resolve14()));
+      return new Promise((resolve13) => stream.on("end", () => resolve13()));
     }
   }
 });
@@ -3643,8 +3643,8 @@ var require_lib = __commonJS({
     var helper = require_helper();
     module.exports = function(connInfo, cb) {
       var file = helper.getFileName();
-      fs.stat(file, function(err, stat) {
-        if (err || !helper.usePgPass(stat, file)) {
+      fs.stat(file, function(err, stat3) {
+        if (err || !helper.usePgPass(stat3, file)) {
           return cb(void 0);
         }
         var st = fs.createReadStream(file);
@@ -3846,12 +3846,12 @@ var require_client = __commonJS({
           this._connect(callback);
           return;
         }
-        return new this._Promise((resolve14, reject) => {
+        return new this._Promise((resolve13, reject) => {
           this._connect((error) => {
             if (error) {
               reject(error);
             } else {
-              resolve14(this);
+              resolve13(this);
             }
           });
         });
@@ -4198,8 +4198,8 @@ var require_client = __commonJS({
         } else {
           query = new Query2(config, values, callback);
           if (!query.callback) {
-            result = new this._Promise((resolve14, reject) => {
-              query.callback = (err, res) => err ? reject(err) : resolve14(res);
+            result = new this._Promise((resolve13, reject) => {
+              query.callback = (err, res) => err ? reject(err) : resolve13(res);
             }).catch((err) => {
               Error.captureStackTrace(err);
               throw err;
@@ -4283,8 +4283,8 @@ var require_client = __commonJS({
         if (cb) {
           this.connection.once("end", cb);
         } else {
-          return new this._Promise((resolve14) => {
-            this.connection.once("end", resolve14);
+          return new this._Promise((resolve13) => {
+            this.connection.once("end", resolve13);
           });
         }
       }
@@ -4333,8 +4333,8 @@ var require_pg_pool = __commonJS({
       const cb = function(err, client) {
         err ? rej(err) : res(client);
       };
-      const result = new Promise2(function(resolve14, reject) {
-        res = resolve14;
+      const result = new Promise2(function(resolve13, reject) {
+        res = resolve13;
         rej = reject;
       }).catch((err) => {
         Error.captureStackTrace(err);
@@ -4395,7 +4395,7 @@ var require_pg_pool = __commonJS({
         if (typeof Promise2.try === "function") {
           return Promise2.try(f);
         }
-        return new Promise2((resolve14) => resolve14(f()));
+        return new Promise2((resolve13) => resolve13(f()));
       }
       _isFull() {
         return this._clients.length >= this.options.max;
@@ -4788,8 +4788,8 @@ var require_query2 = __commonJS({
     NativeQuery.prototype._getPromise = function() {
       if (this._promise) return this._promise;
       this._promise = new Promise(
-        function(resolve14, reject) {
-          this._once("end", resolve14);
+        function(resolve13, reject) {
+          this._once("end", resolve13);
           this._once("error", reject);
         }.bind(this)
       );
@@ -4899,18 +4899,18 @@ var require_client2 = __commonJS({
       this._connecting = false;
       this._connected = false;
       this._queryable = true;
-      const cp6 = this.connectionParameters = new ConnectionParameters(config);
-      if (config.nativeConnectionString) cp6.nativeConnectionString = config.nativeConnectionString;
-      this.user = cp6.user;
+      const cp7 = this.connectionParameters = new ConnectionParameters(config);
+      if (config.nativeConnectionString) cp7.nativeConnectionString = config.nativeConnectionString;
+      this.user = cp7.user;
       Object.defineProperty(this, "password", {
         configurable: true,
         enumerable: false,
         writable: true,
-        value: cp6.password
+        value: cp7.password
       });
-      this.database = cp6.database;
-      this.host = cp6.host;
-      this.port = cp6.port;
+      this.database = cp7.database;
+      this.host = cp7.host;
+      this.port = cp7.port;
       this.namedQueries = {};
     };
     Client2.Query = NativeQuery;
@@ -4967,12 +4967,12 @@ var require_client2 = __commonJS({
         this._connect(callback);
         return;
       }
-      return new this._Promise((resolve14, reject) => {
+      return new this._Promise((resolve13, reject) => {
         this._connect((error) => {
           if (error) {
             reject(error);
           } else {
-            resolve14(this);
+            resolve13(this);
           }
         });
       });
@@ -4996,8 +4996,8 @@ var require_client2 = __commonJS({
         query = new NativeQuery(config, values, callback);
         if (!query.callback) {
           let resolveOut, rejectOut;
-          result = new this._Promise((resolve14, reject) => {
-            resolveOut = resolve14;
+          result = new this._Promise((resolve13, reject) => {
+            resolveOut = resolve13;
             rejectOut = reject;
           }).catch((err) => {
             Error.captureStackTrace(err);
@@ -5060,8 +5060,8 @@ var require_client2 = __commonJS({
       }
       let result;
       if (!cb) {
-        result = new this._Promise(function(resolve14, reject) {
-          cb = (err) => err ? reject(err) : resolve14();
+        result = new this._Promise(function(resolve13, reject) {
+          cb = (err) => err ? reject(err) : resolve13();
         });
       }
       this.native.end(function() {
@@ -5236,26 +5236,73 @@ var init_esm = __esm({
 });
 
 // src/bin.ts
-import { resolve as resolve13 } from "path";
-import process26 from "process";
-import { fileURLToPath as fileURLToPath8 } from "url";
+import process29 from "process";
 
 // src/cliRunner.ts
-import { readFile as readFile18 } from "fs/promises";
-import { dirname as dirname14, join as join46 } from "path";
-import process25 from "process";
-import { fileURLToPath as fileURLToPath7 } from "url";
+import { readFile as readFile21 } from "fs/promises";
+import { dirname as dirname16, join as join49 } from "path";
+import process28 from "process";
+import { fileURLToPath as fileURLToPath8 } from "url";
+
+// src/commands/createSurfaceRegistry.ts
+var CREATE_SURFACES = [
+  {
+    id: "web",
+    label: "Web app",
+    hint: "Next.js + dashboard + marketing",
+    help: "Next.js + agent layer"
+  },
+  {
+    id: "mobile",
+    label: "Mobile app",
+    hint: "Expo",
+    help: "Expo + agent layer"
+  },
+  {
+    id: "extension",
+    label: "Browser extension",
+    hint: "WXT",
+    help: "WXT + agent layer"
+  },
+  {
+    id: "backend",
+    label: "Backend API",
+    hint: "Express + typed routes",
+    help: "Express API + typed routes"
+  }
+];
+var CREATE_SURFACE_PROMPT_OPTIONS = CREATE_SURFACES.map((surface) => ({
+  value: surface.id,
+  label: surface.label,
+  hint: surface.hint
+}));
+var CREATE_SURFACE_PIPE_FLAGS = CREATE_SURFACES.map((surface) => `--${surface.id}`).join(
+  "|"
+);
+var CREATE_SURFACE_LIST_FLAGS = CREATE_SURFACES.map((surface, index) => {
+  const flag = `--${surface.id}`;
+  if (index === CREATE_SURFACES.length - 1) {
+    return `or ${flag}`;
+  }
+  return flag;
+}).join(", ");
+var isCreateSurface = (value) => CREATE_SURFACES.some((surface) => surface.id === value);
 
 // src/cliHelp.ts
+var createSurfaceUsage = CREATE_SURFACES.map(
+  (surface) => `  vybekiit create app --${surface.id} [directory]`
+).join("\n");
+var createSurfaceHelp = CREATE_SURFACES.map((surface) => {
+  const surfaceFlag = `--${surface.id}`.padEnd(14);
+  return `  ${surfaceFlag}${surface.help}`;
+}).join("\n");
 var CLI_HELP = `vybekiit \u2014 set up tools and create your app
 
 Getting started:
   vybekiit                 Interactive menu (terminal only)
-  vybekiit setup           Welcome + install/check the tools your app needs
+  vybekiit setup           Welcome + set up Claude Code globally (skills, MCP, tools)
   vybekiit doctor          Full toolchain pass (agents, gh, cloud CLIs, skills, \u2026)
-  vybekiit create app --web [directory]
-  vybekiit create app --mobile [directory]
-  vybekiit create app --extension [directory]
+${createSurfaceUsage}
 
 After your app exists (your AI coding tool drives these):
   vybekiit list-pieces \xB7 list-page-recipes \xB7 list-presets
@@ -5265,9 +5312,7 @@ After your app exists (your AI coding tool drives these):
   vybekiit env wizard \xB7 sync-agent-layer \xB7 update path via your agent
 
 Surfaces:
-  --web         Next.js + agent layer
-  --mobile      Expo + agent layer
-  --extension   WXT + agent layer
+${createSurfaceHelp}
 
 Examples:
   vybekiit setup
@@ -5286,9 +5331,10 @@ var CLI_HELP_ALL = `vybekiit \u2014 full command list
 
 Buyer journey:
   vybekiit setup
+  vybekiit global-install [--yes]         (skills + MCP + awareness into ~/.claude)
   vybekiit doctor
   vybekiit doctor --ensure <tool> [--json]
-  vybekiit create app --web|--mobile|--extension [directory]
+  vybekiit create app ${CREATE_SURFACE_PIPE_FLAGS} [directory]
 
 Create / project:
   vybekiit new [template] [directory]     (deprecated \u2192 create app)
@@ -6022,10 +6068,7 @@ var GOAL_CATALOG = Object.fromEntries(
 );
 
 // ../packages/agentKit/src/catalogs/mcpToolsCatalog.ts
-var firstPartyMcpBinPath = (packageFolder, layout, bin = "agent") => {
-  const file = bin === "ui-catalog" ? "uiCatalog/bin.js" : "bin.js";
-  return layout === "kit-root" ? `packages/${packageFolder}/dist/${file}` : `../../packages/${packageFolder}/dist/${file}`;
-};
+var firstPartyMcpBinPath = (packageFolder, layout) => layout === "kit-root" ? `packages/${packageFolder}/dist/bin.js` : `../../packages/${packageFolder}/dist/bin.js`;
 var buildFirstPartyMcpConfig = (layout, options) => {
   const projectRoot = layout === "kit-root" && options?.template !== void 0 && options.template !== "" ? `templates/${options.template}` : ".";
   const catalogPath = layout === "kit-root" && options?.template !== void 0 && options.template !== "" ? `templates/${options.template}/.vybekiit/agent/ui-catalog-index.json` : ".vybekiit/agent/ui-catalog-index.json";
@@ -6035,20 +6078,15 @@ var buildFirstPartyMcpConfig = (layout, options) => {
         command: "node",
         args: [firstPartyMcpBinPath("agentMcp", layout)],
         env: {
-          VYBEKIIT_PROJECT_ROOT: projectRoot
-        }
-      },
-      "vybekiit-ui-catalog": {
-        command: "node",
-        args: [firstPartyMcpBinPath("agentMcp", layout, "ui-catalog")],
-        env: {
-          VYBEKIIT_UI_CATALOG_PATH: catalogPath,
-          VYBEKIIT_PROJECT_ROOT: projectRoot
+          VYBEKIIT_PROJECT_ROOT: projectRoot,
+          VYBEKIIT_UI_CATALOG_PATH: catalogPath
         }
       }
     }
   };
 };
+var formatFirstPartyMcpConfigJson = (config) => `${JSON.stringify(config, null, 2)}
+`;
 
 // ../packages/agentKit/src/catalogs/platform-skills-base.manifest.json
 var platform_skills_base_manifest_default = {
@@ -8720,8 +8758,8 @@ var readAgentSkillSymlinkStates = async (cwd) => {
     AGENT_SKILL_SYMLINKS.map(async ({ link }) => {
       const linkPath = join2(cwd, link);
       try {
-        const stat = await lstat(linkPath);
-        if (stat.isSymbolicLink()) {
+        const stat3 = await lstat(linkPath);
+        if (stat3.isSymbolicLink()) {
           return [link, { isSymlink: true, target: await readlink(linkPath) }];
         }
         return [link, { isSymlink: false, target: null }];
@@ -8753,10 +8791,10 @@ var ensureAgentSkillSymlinks = async (cwd) => {
     plan.toCreate.map(async ({ link, target }) => {
       const linkPath = join2(cwd, link);
       try {
-        const stat = await lstat(linkPath);
-        if (stat.isSymbolicLink()) {
+        const stat3 = await lstat(linkPath);
+        if (stat3.isSymbolicLink()) {
           await rm(linkPath);
-        } else if (stat.isDirectory()) {
+        } else if (stat3.isDirectory()) {
           throw new Error(
             `${link} exists as a real directory. Remove it manually, then re-run render-agent-layer.`
           );
@@ -9609,13 +9647,13 @@ var cloneKitMirror = async (repoName, targetDir) => {
     );
   }
 };
-var findLocalKitRoot = async (exists) => {
+var findLocalKitRoot = async (exists2) => {
   const candidates = [resolve2(HERE2, "..", ".."), resolve2(HERE2, "..", "..", "..")];
   const probes = await Promise.all(
     candidates.map(async (root) => {
       const [hasPackages, hasTemplates] = await Promise.all([
-        exists(join8(root, "packages")),
-        exists(join8(root, "templates"))
+        exists2(join8(root, "packages")),
+        exists2(join8(root, "templates"))
       ]);
       return { root, ok: hasPackages && hasTemplates };
     })
@@ -9719,8 +9757,7 @@ var writeFirstPartyMcpConfigFile = async (configPath, layout, options) => {
   }
   const { config, written } = mergeFirstPartyMcpServers(existing, firstParty);
   await mkdir3(dirname4(configPath), { recursive: true });
-  await writeFile3(configPath, `${JSON.stringify(config, null, 2)}
-`);
+  await writeFile3(configPath, formatFirstPartyMcpConfigJson(config));
   return written;
 };
 var shipFirstPartyMcpConfigs = async (options) => {
@@ -10004,7 +10041,6 @@ var scaffoldKitWorkspace = async (options) => {
 var isInteractive = () => Boolean(process.stdout.isTTY && process.stdin.isTTY);
 
 // src/commands/scaffoldOutput.ts
-var isCreateSurface = (value) => value === "web" || value === "mobile" || value === "extension";
 var formatCreateSuccess = (surface, dest) => [
   "",
   `\u2705 Created kit workspace + ${surface} surface at ${dest}`,
@@ -10017,12 +10053,9 @@ var formatCreateSuccess = (surface, dest) => [
 var formatCreateError = (message) => [`\u274C ${message}`, ""];
 var formatCreateUsage = () => [
   "Pick one surface for your app:",
-  "  vybekiit create app --web [directory]",
-  "  vybekiit create app --mobile [directory]",
-  "  vybekiit create app --extension [directory]",
+  ...CREATE_SURFACES.map((surface) => `  vybekiit create app --${surface.id} [directory]`),
   ""
 ];
-var surfaceToTemplate = (surface) => surface;
 
 // src/commands/createApp.ts
 var destIsMissingOrEmpty = async (dest) => {
@@ -10033,47 +10066,46 @@ var destIsMissingOrEmpty = async (dest) => {
     return true;
   }
 };
-var parseCreateAppArgs = (args) => {
-  const surfaces = [];
-  const positionals = [];
-  for (const arg of args) {
-    if (arg === "--web" || arg === "--mobile" || arg === "--extension") {
-      surfaces.push(arg.slice(2));
-      continue;
-    }
-    if (arg.startsWith("--")) {
+var parseCreateAppArgs = (argumentsToParse) => {
+  const selectedSurfaces = [];
+  const destinationArguments = [];
+  for (const argument of argumentsToParse) {
+    const surfaceFlag = argument.startsWith("--") ? argument.slice(2) : "";
+    if (isCreateSurface(surfaceFlag)) {
+      selectedSurfaces.push(surfaceFlag);
+    } else if (argument.startsWith("--")) {
       return {
         ok: false,
-        error: `Unknown flag: ${arg}. Use --web, --mobile, or --extension.`
+        error: `Unknown flag: ${argument}. Use ${CREATE_SURFACE_LIST_FLAGS}.`
       };
+    } else {
+      destinationArguments.push(argument);
     }
-    positionals.push(arg);
   }
-  if (surfaces.length === 0) {
+  if (selectedSurfaces.length === 0) {
     return { ok: false, error: "missing-surface" };
   }
-  if (surfaces.length > 1) {
-    return { ok: false, error: "Pick one surface for now (--web, --mobile, or --extension)." };
+  if (selectedSurfaces.length > 1) {
+    return {
+      ok: false,
+      error: `Pick one surface for now (${CREATE_SURFACE_LIST_FLAGS}).`
+    };
   }
-  const surface = surfaces[0];
-  if (surface === void 0 || !isCreateSurface(surface)) {
+  const [selectedSurface] = selectedSurfaces;
+  if (!selectedSurface) {
     return { ok: false, error: "missing-surface" };
   }
-  const destPath = positionals[0] !== void 0 && positionals[0] !== "" ? positionals[0] : `./${surface}`;
-  return { ok: true, inputs: { surface, destPath } };
+  const destinationPath = destinationArguments[0] || `./${selectedSurface}`;
+  return { ok: true, inputs: { surface: selectedSurface, destPath: destinationPath } };
 };
 var promptCreateSurface = async () => {
-  const { cancel: cancel4, intro: intro2, isCancel: isCancel4, outro, select: select3 } = await import("@clack/prompts");
+  const { cancel: cancel4, intro: intro2, isCancel: isCancel5, outro, select: select3 } = await import("@clack/prompts");
   intro2("VybeKiit \u2014 create an app");
   const picked = await select3({
     message: "What are you building?",
-    options: [
-      { value: "web", label: "Web app", hint: "Next.js + dashboard + marketing" },
-      { value: "mobile", label: "Mobile app", hint: "Expo" },
-      { value: "extension", label: "Browser extension", hint: "WXT" }
-    ]
+    options: CREATE_SURFACE_PROMPT_OPTIONS
   });
-  if (isCancel4(picked) || typeof picked !== "string" || !isCreateSurface(picked)) {
+  if (isCancel5(picked) || typeof picked !== "string" || !isCreateSurface(picked)) {
     cancel4("Cancelled.");
     return null;
   }
@@ -10115,7 +10147,7 @@ var runCreateApp = async (args) => {
     return 1;
   }
   const { destPath, surface } = parsed.inputs;
-  const template = surfaceToTemplate(surface);
+  const template = surface;
   const dest = resolve3(process6.cwd(), destPath);
   let cleanup;
   const mayCleanupPartial = await destIsMissingOrEmpty(dest);
@@ -10443,13 +10475,13 @@ var writeTemplateRequired = (flags) => {
   return 1;
 };
 var promptForDropInputs = async (parsed) => {
-  const { confirm, intro: intro2, isCancel: isCancel4, select: select3, text: text2, cancel: cancel4 } = await import("@clack/prompts");
+  const { confirm: confirm2, intro: intro2, isCancel: isCancel5, select: select3, text: text2, cancel: cancel4 } = await import("@clack/prompts");
   intro2("VybeKiit: drop a template");
   const picked = await select3({
     message: "Which template?",
     options: DROP_TEMPLATE_OPTIONS
   });
-  if (isCancel4(picked) || typeof picked !== "string" || !isTemplateName(picked)) {
+  if (isCancel5(picked) || typeof picked !== "string" || !isTemplateName(picked)) {
     cancel4("Cancelled.");
     return null;
   }
@@ -10462,17 +10494,17 @@ var promptForDropInputs = async (parsed) => {
       defaultValue: `./${picked}`,
       validate: (value) => typeof value === "string" && value.trim() !== "" ? void 0 : "Path is required"
     });
-    if (isCancel4(dest) || typeof dest !== "string") {
+    if (isCancel5(dest) || typeof dest !== "string") {
       cancel4("Cancelled.");
       return null;
     }
     destPath = dest;
   }
   const mode = dropMode(parsed.flags);
-  const confirmed = await confirm({
+  const confirmed = await confirm2({
     message: `Drop "${picked}" -> ${resolve5(destPath)}${mode === "new" ? "" : ` (${mode})`}?`
   });
-  if (isCancel4(confirmed) || !confirmed) {
+  if (isCancel5(confirmed) || !confirmed) {
     cancel4("Cancelled.");
     return null;
   }
@@ -11627,9 +11659,9 @@ import { Effect as Effect6 } from "effect";
 // ../packages/db/src/liveWork/railwayProvision.ts
 import { Effect as Effect5 } from "effect";
 var defaultRailwayCliRunner = async (args, options = {}) => {
-  const { execFile: execFile7 } = await import("child_process");
+  const { execFile: execFile8 } = await import("child_process");
   const { promisify: promisify7 } = await import("util");
-  const execFileAsync7 = promisify7(execFile7);
+  const execFileAsync7 = promisify7(execFile8);
   try {
     const { stdout, stderr } = await execFileAsync7("railway", [...args], {
       cwd: options.cwd,
@@ -11644,10 +11676,16 @@ var defaultRailwayCliRunner = async (args, options = {}) => {
   } catch (cause) {
     const err = cause;
     const exitCode = typeof err.code === "number" ? err.code : 1;
+    let stderr = "railway failed";
+    if (typeof err.stderr === "string") {
+      stderr = err.stderr;
+    } else if (typeof err.message === "string") {
+      stderr = err.message;
+    }
     return {
       code: exitCode,
       stdout: typeof err.stdout === "string" ? err.stdout : "",
-      stderr: typeof err.stderr === "string" ? err.stderr : typeof err.message === "string" ? err.message : "railway failed"
+      stderr
     };
   }
 };
@@ -11700,8 +11738,8 @@ var isRailwayStatusLinked = (code, stdout, stderr) => {
   }
   return blob.includes("project") && !blob.includes("no linked");
 };
-var delay = (ms) => new Promise((resolve14) => {
-  setTimeout(resolve14, ms);
+var delay = (ms) => new Promise((resolve13) => {
+  setTimeout(resolve13, ms);
 });
 var isRailwayRateLimited = (blob) => {
   const lower = blob.toLowerCase();
@@ -12088,7 +12126,7 @@ var buildResult = (provisioned, pin, args) => {
   }
   return result;
 };
-var walkLadder = (order, ctx, steps, namedStick, writePin, existingAuthProvider) => Effect8.gen(function* () {
+var walkLadder = (order, ctx, steps, namedStick, writePin, existingAuthProvider, verifyProvisioned) => Effect8.gen(function* () {
   const stepByProvider = new Map(steps.map((step) => [step.provider, step]));
   const skipped = [];
   const orphans = [];
@@ -12102,7 +12140,7 @@ var walkLadder = (order, ctx, steps, namedStick, writePin, existingAuthProvider)
       const attempt = yield* step.tryProvision(ctx).pipe(Effect8.either);
       if (attempt._tag === "Right") {
         const provisioned = attempt.right;
-        const verified = yield* verifyProvisionedData(provisioned).pipe(Effect8.either);
+        const verified = yield* verifyProvisioned(provisioned).pipe(Effect8.either);
         if (verified._tag === "Left") {
           orphans.push(orphanFromProvisioned(provisioned, "verify failed"));
           yield* cleanupOrphans(orphans);
@@ -12151,6 +12189,7 @@ var walkLadder = (order, ctx, steps, namedStick, writePin, existingAuthProvider)
 var runDataLiveWork = (options) => Effect8.gen(function* () {
   const env = options.env ?? {};
   const preferExisting = options.preferExisting !== false;
+  const verifyProvisioned = options.verifyProvisioned || verifyProvisionedData;
   let existingAuthProvider;
   if (typeof env.AUTH_PROVIDER === "string" && env.AUTH_PROVIDER.length > 0) {
     existingAuthProvider = env.AUTH_PROVIDER;
@@ -12158,7 +12197,7 @@ var runDataLiveWork = (options) => Effect8.gen(function* () {
   if (preferExisting && options.namedVendor === void 0) {
     const existing = detectExistingPrimary(env);
     if (existing !== null) {
-      yield* verifyProvisionedData(existing);
+      yield* verifyProvisioned(existing);
       return yield* finishSuccess({
         provisioned: existing,
         hopped: false,
@@ -12183,7 +12222,8 @@ var runDataLiveWork = (options) => Effect8.gen(function* () {
     options.steps ?? defaultDataLadderSteps,
     options.namedVendor !== void 0 && options.namedVendor !== null,
     options.writePin,
-    existingAuthProvider
+    existingAuthProvider,
+    verifyProvisioned
   );
 });
 
@@ -14719,9 +14759,9 @@ var makeProvisionedHost = (base, optional = {}) => {
 
 // ../packages/deploy/src/liveWork/cloudflareProvision.ts
 var defaultWranglerCliRunner = async (args, options = {}) => {
-  const { execFile: execFile7 } = await import("child_process");
+  const { execFile: execFile8 } = await import("child_process");
   const { promisify: promisify7 } = await import("util");
-  const execFileAsync7 = promisify7(execFile7);
+  const execFileAsync7 = promisify7(execFile8);
   try {
     const { stdout, stderr } = await execFileAsync7("wrangler", [...args], {
       cwd: options.cwd,
@@ -14736,10 +14776,16 @@ var defaultWranglerCliRunner = async (args, options = {}) => {
     };
   } catch (cause) {
     const err = cause;
+    let stderr = "wrangler failed";
+    if (typeof err.stderr === "string") {
+      stderr = err.stderr;
+    } else if (typeof err.message === "string") {
+      stderr = err.message;
+    }
     return {
       code: typeof err.code === "number" ? err.code : 1,
       stdout: typeof err.stdout === "string" ? err.stdout : "",
-      stderr: typeof err.stderr === "string" ? err.stderr : typeof err.message === "string" ? err.message : "wrangler failed"
+      stderr
     };
   }
 };
@@ -14798,8 +14844,8 @@ var verifyHostUrl = (url, fetchImpl = globalThis.fetch, options = {}) => Effect1
         lastMessage = cause instanceof Error ? cause.message : "Host verify failed";
       }
       if (i < attempts - 1) {
-        await new Promise((resolve14) => {
-          setTimeout(resolve14, delayMs);
+        await new Promise((resolve13) => {
+          setTimeout(resolve13, delayMs);
         });
       }
     }
@@ -15217,8 +15263,8 @@ var createGithubPagesHost = (options) => Effect14.gen(function* () {
             }
           }
         }
-        await new Promise((resolve14) => {
-          setTimeout(resolve14, 3e3);
+        await new Promise((resolve13) => {
+          setTimeout(resolve13, 3e3);
         });
       }
       return makeProvisionedHost(
@@ -15560,8 +15606,8 @@ var createNetlifyHost = (options) => Effect15.gen(function* () {
             }
           }
         }
-        await new Promise((resolve14) => {
-          setTimeout(resolve14, 2e3);
+        await new Promise((resolve13) => {
+          setTimeout(resolve13, 2e3);
         });
       }
       try {
@@ -15641,9 +15687,9 @@ import { tmpdir as tmpdir6 } from "os";
 import { join as join24 } from "path";
 import { Effect as Effect16 } from "effect";
 var defaultRailwayHostCliRunner = async (args, options = {}) => {
-  const { execFile: execFile7 } = await import("child_process");
+  const { execFile: execFile8 } = await import("child_process");
   const { promisify: promisify7 } = await import("util");
-  const execFileAsync7 = promisify7(execFile7);
+  const execFileAsync7 = promisify7(execFile8);
   try {
     const { stdout, stderr } = await execFileAsync7("railway", [...args], {
       cwd: options.cwd,
@@ -15658,10 +15704,16 @@ var defaultRailwayHostCliRunner = async (args, options = {}) => {
     };
   } catch (cause) {
     const err = cause;
+    let stderr = "railway failed";
+    if (typeof err.stderr === "string") {
+      stderr = err.stderr;
+    } else if (typeof err.message === "string") {
+      stderr = err.message;
+    }
     return {
       code: typeof err.code === "number" ? err.code : 1,
       stdout: typeof err.stdout === "string" ? err.stdout : "",
-      stderr: typeof err.stderr === "string" ? err.stderr : typeof err.message === "string" ? err.message : "railway failed"
+      stderr
     };
   }
 };
@@ -16016,9 +16068,9 @@ import { tmpdir as tmpdir8 } from "os";
 import { join as join26 } from "path";
 import { Effect as Effect18 } from "effect";
 var defaultVercelCliRunner = async (args, options = {}) => {
-  const { execFile: execFile7 } = await import("child_process");
+  const { execFile: execFile8 } = await import("child_process");
   const { promisify: promisify7 } = await import("util");
-  const execFileAsync7 = promisify7(execFile7);
+  const execFileAsync7 = promisify7(execFile8);
   try {
     const { stdout, stderr } = await execFileAsync7("vercel", [...args], {
       cwd: options.cwd,
@@ -16033,10 +16085,16 @@ var defaultVercelCliRunner = async (args, options = {}) => {
     };
   } catch (cause) {
     const err = cause;
+    let stderr = "vercel failed";
+    if (typeof err.stderr === "string") {
+      stderr = err.stderr;
+    } else if (typeof err.message === "string") {
+      stderr = err.message;
+    }
     return {
       code: typeof err.code === "number" ? err.code : 1,
       stdout: typeof err.stdout === "string" ? err.stdout : "",
-      stderr: typeof err.stderr === "string" ? err.stderr : typeof err.message === "string" ? err.message : "vercel failed"
+      stderr
     };
   }
 };
@@ -17092,10 +17150,10 @@ var runLocalDev = async () => {
   child.stderr.on("data", (data) => {
     process.stderr.write(data.toString());
   });
-  return new Promise((resolve14) => {
+  return new Promise((resolve13) => {
     child.on("close", (code) => {
       const exitCode = code === null ? 0 : code;
-      resolve14(exitCode);
+      resolve13(exitCode);
     });
   });
 };
@@ -17105,7 +17163,8 @@ import process10 from "process";
 var runNew = async (args) => {
   const [template, dir] = args;
   process10.stderr.write(
-    "Note: `vybekiit new` is deprecated. Use `vybekiit create app --web|--mobile|--extension`.\n"
+    `Note: \`vybekiit new\` is deprecated. Use \`vybekiit create app ${CREATE_SURFACE_PIPE_FLAGS}\`.
+`
   );
   if (template !== void 0 && template !== "" && isCreateSurface(template)) {
     const forwarded = dir === void 0 || dir === "" ? [`--${template}`] : [`--${template}`, dir];
@@ -17115,7 +17174,7 @@ var runNew = async (args) => {
     return await runCreateApp([]);
   }
   process10.stderr.write(
-    `Unknown surface "${template}". Use --web, --mobile, or --extension (spa/backend are not create-app surfaces).
+    `Unknown surface "${template}". Use ${CREATE_SURFACE_LIST_FLAGS} (spa is not a create-app surface).
 `
   );
   process10.stderr.write(
@@ -17706,8 +17765,8 @@ var planPageRecipeInstall = async (options) => {
 var applyPageRecipeInstall = async (plan, options = { force: false }) => {
   const outcomes = await Promise.all(
     plan.files.map(async (file) => {
-      const exists = await pathExists6(file.absolutePath);
-      if (exists && !options.force) {
+      const exists2 = await pathExists6(file.absolutePath);
+      if (exists2 && !options.force) {
         return { kind: "skipped", path: file.relativePath };
       }
       await mkdir7(dirname11(file.absolutePath), { recursive: true });
@@ -18446,7 +18505,7 @@ var runRenderAgentLayer = async (cwd = process15.cwd(), templateArg) => {
 };
 
 // src/commands/setup.ts
-import process21 from "process";
+import process24 from "process";
 
 // src/doctor/gate.ts
 import { spawnSync } from "child_process";
@@ -18508,7 +18567,7 @@ var ensureAccessOrExit = () => {
 
 // src/doctor/run.ts
 import { spawnSync as spawnSync7 } from "child_process";
-import process18 from "process";
+import process19 from "process";
 
 // ../packages/reportMode/src/deeplink.ts
 var inferVybeAssistant = (options) => {
@@ -18578,10 +18637,10 @@ var createDefaultMcpWireDeps = () => ({
     return { status: result.status };
   }
 });
-var findMcpCatalogPath = (cwd, pathExists8) => {
+var findMcpCatalogPath = (cwd, pathExists9) => {
   for (const relative4 of CATALOG_RELATIVE_PATHS) {
     const absolute = join34(cwd, relative4);
-    if (pathExists8(absolute)) {
+    if (pathExists9(absolute)) {
       return absolute;
     }
   }
@@ -19177,10 +19236,82 @@ var verifyAssetsPipeline = (cwd, surface = inferProjectSurfaceSync(cwd), deps =
   };
 };
 
-// src/doctor/codexConfig.ts
-import { access as access13, mkdir as mkdir9, readFile as readFile15, writeFile as writeFile10 } from "fs/promises";
+// src/doctor/claudeGlobalConfig.ts
+import { readdir as readdir8, readFile as readFile15, stat } from "fs/promises";
+import { join as join38 } from "path";
+
+// src/global/globalPaths.ts
 import { homedir as homedir2 } from "os";
-import { join as join37 } from "path";
+import { dirname as dirname14, join as join37 } from "path";
+import process17 from "process";
+import { fileURLToPath as fileURLToPath7 } from "url";
+var MODULE_DIR = dirname14(fileURLToPath7(import.meta.url));
+var resolveConfigDir = () => {
+  const override = process17.env.CLAUDE_CONFIG_DIR;
+  if (override !== void 0 && override.trim() !== "") {
+    return override.trim();
+  }
+  return join37(homedir2(), ".claude");
+};
+var resolveGlobalPaths = (configDir = resolveConfigDir()) => ({
+  configDir,
+  skillsDir: join37(configDir, "skills"),
+  commandsDir: join37(configDir, "commands"),
+  memoryFile: join37(configDir, "CLAUDE.md"),
+  settingsFile: join37(configDir, "settings.json"),
+  // At runtime this module is inlined into dist/bin.js, so MODULE_DIR is <install>/dist
+  // and the payload sits beside it at dist/global-skills.
+  bundledSkillsDir: join37(MODULE_DIR, "global-skills")
+});
+
+// src/doctor/claudeGlobalConfig.ts
+var exists = async (path) => {
+  try {
+    await stat(path);
+    return true;
+  } catch {
+    return false;
+  }
+};
+var countManagedSkills = async (skillsDir) => {
+  let count = 0;
+  try {
+    const entries = await readdir8(skillsDir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (entry.isDirectory() && await exists(join38(skillsDir, entry.name, ".vybekiit-managed"))) {
+        count += 1;
+      }
+    }
+  } catch {
+    return 0;
+  }
+  return count;
+};
+var readGlobalStatus = async (paths = resolveGlobalPaths()) => {
+  let hasMemory = false;
+  try {
+    hasMemory = (await readFile15(paths.memoryFile, "utf8")).includes("BEGIN VYBEKIIT");
+  } catch {
+    hasMemory = false;
+  }
+  return {
+    hasCommand: await exists(join38(paths.commandsDir, "vybekiit.md")),
+    hasMemory,
+    skillCount: await countManagedSkills(paths.skillsDir)
+  };
+};
+var isGloballyInstalled = (status) => status.hasCommand && status.hasMemory && status.skillCount > 0;
+var formatGlobalStatus = (status) => {
+  if (isGloballyInstalled(status)) {
+    return `\u2713 VybeKiit global - active in every project (${status.skillCount} skills, /vybekiit command, Claude is aware).`;
+  }
+  return "\u2192 VybeKiit global - not set up yet. Run `vybekiit setup` (or `vybekiit global-install`) to add it to every project.";
+};
+
+// src/doctor/codexConfig.ts
+import { access as access13, mkdir as mkdir9, readFile as readFile16, writeFile as writeFile10 } from "fs/promises";
+import { homedir as homedir3 } from "os";
+import { join as join39 } from "path";
 var FEATURES_BLOCK = ["[features]", "skills = true"].join("\n");
 var FEATURES_SKILLS_ENABLED_PATTERN = /\[features\][\s\S]*?\bskills\s*=\s*true\b/m;
 var FEATURES_BLOCK_PATTERN = /(\[features\][^[]*)/m;
@@ -19189,10 +19320,10 @@ var SKILLS_LINE_PATTERN = /\bskills\s*=\s*.*/m;
 var codexConfigPath = () => {
   const configuredHome = process.env.CODEX_HOME;
   if (configuredHome !== void 0 && configuredHome.trim() !== "") {
-    return join37(configuredHome.trim(), "config.toml");
+    return join39(configuredHome.trim(), "config.toml");
   }
-  const home = join37(homedir2(), ".codex");
-  return join37(home, "config.toml");
+  const home = join39(homedir3(), ".codex");
+  return join39(home, "config.toml");
 };
 var upsertFeaturesSkills = (content) => {
   if (FEATURES_SKILLS_ENABLED_PATTERN.test(content)) {
@@ -19218,10 +19349,10 @@ ${FEATURES_BLOCK}
 };
 var ensureCodexSkillsEnabled = async () => {
   const path = codexConfigPath();
-  await mkdir9(join37(path, ".."), { recursive: true });
+  await mkdir9(join39(path, ".."), { recursive: true });
   let previous = "";
   try {
-    previous = await readFile15(path, "utf8");
+    previous = await readFile16(path, "utf8");
   } catch (error) {
     if (!(error instanceof Error && "code" in error) || error.code !== "ENOENT") {
       throw error;
@@ -19237,7 +19368,7 @@ var ensureCodexSkillsEnabled = async () => {
 
 // src/doctor/kitWorkspaceHealth.ts
 import { existsSync as existsSync9, readdirSync as readdirSync2, readFileSync as readFileSync9, statSync as statSync2 } from "fs";
-import { join as join38 } from "path";
+import { join as join40 } from "path";
 var readPackageJsonSafe = (packageJsonPath) => {
   if (!existsSync9(packageJsonPath)) {
     return null;
@@ -19270,7 +19401,7 @@ var listPackageRelDirs = (packagesRoot) => {
   const top = readdirSync2(packagesRoot);
   const rels = [];
   for (const entry of top) {
-    const abs = join38(packagesRoot, entry);
+    const abs = join40(packagesRoot, entry);
     let isDir = false;
     try {
       isDir = statSync2(abs).isDirectory();
@@ -19280,7 +19411,7 @@ var listPackageRelDirs = (packagesRoot) => {
     if (!isDir) {
       continue;
     }
-    if (existsSync9(join38(abs, "package.json"))) {
+    if (existsSync9(join40(abs, "package.json"))) {
       rels.push(entry);
       continue;
     }
@@ -19291,10 +19422,10 @@ var listPackageRelDirs = (packagesRoot) => {
       continue;
     }
     for (const child of nested) {
-      const childAbs = join38(abs, child);
+      const childAbs = join40(abs, child);
       try {
-        if (statSync2(childAbs).isDirectory() && existsSync9(join38(childAbs, "package.json"))) {
-          rels.push(join38(entry, child));
+        if (statSync2(childAbs).isDirectory() && existsSync9(join40(childAbs, "package.json"))) {
+          rels.push(join40(entry, child));
         }
       } catch {
       }
@@ -19303,15 +19434,15 @@ var listPackageRelDirs = (packagesRoot) => {
   return rels;
 };
 var findMissingDistPackages = (cwd) => {
-  const packagesRoot = join38(cwd, "packages");
+  const packagesRoot = join40(cwd, "packages");
   const missing = [];
   for (const relDir of listPackageRelDirs(packagesRoot)) {
-    const packageDir = join38(packagesRoot, relDir);
-    const pkg = readPackageJsonSafe(join38(packageDir, "package.json"));
+    const packageDir = join40(packagesRoot, relDir);
+    const pkg = readPackageJsonSafe(join40(packageDir, "package.json"));
     if (pkg === null || !packageExpectsDist(pkg)) {
       continue;
     }
-    if (!existsSync9(join38(packageDir, "dist"))) {
+    if (!existsSync9(join40(packageDir, "dist"))) {
       const name = typeof pkg.name === "string" ? pkg.name : relDir;
       missing.push({ name, relDir });
     }
@@ -19319,7 +19450,7 @@ var findMissingDistPackages = (cwd) => {
   return missing;
 };
 var verifyKitWorkspaceHealth = (cwd) => {
-  const packagesRoot = join38(cwd, "packages");
+  const packagesRoot = join40(cwd, "packages");
   if (!existsSync9(packagesRoot)) {
     return { ok: true, lines: [] };
   }
@@ -19337,7 +19468,7 @@ var verifyKitWorkspaceHealth = (cwd) => {
     );
   }
   const buildRoots = ["tsconfig.base.json", "scripts/lib/tsupWorkspaceAliases.mjs"];
-  const missingRoots = buildRoots.filter((rel) => !existsSync9(join38(cwd, rel)));
+  const missingRoots = buildRoots.filter((rel) => !existsSync9(join40(cwd, rel)));
   if (missingRoots.length > 0 && missing.length > 0) {
     lines.push(
       `\u2717 Kit is also missing rebuild helpers (${missingRoots.join(", ")}). Re-run \`vybekiit create app\` with a current CLI so build roots ship with the workspace.`
@@ -19486,11 +19617,11 @@ var mergeDoctorTools = (providerTools, nativeTools) => {
 
 // src/doctor/perfReadiness.ts
 import { existsSync as existsSync10, readFileSync as readFileSync10 } from "fs";
-import { join as join39 } from "path";
+import { join as join41 } from "path";
 var createDefaultPerfReadinessDeps = (cwd) => ({
-  exists: (relativePath) => existsSync10(join39(cwd, relativePath)),
+  exists: (relativePath) => existsSync10(join41(cwd, relativePath)),
   readUtf8: (relativePath) => {
-    const absolute = join39(cwd, relativePath);
+    const absolute = join41(cwd, relativePath);
     if (!existsSync10(absolute)) {
       return null;
     }
@@ -19635,17 +19766,17 @@ var reportFor = (reports, name) => reports.find((r) => r.tool === name);
 
 // src/doctor/platformSkills.ts
 import { existsSync as existsSync11, readFileSync as readFileSync11 } from "fs";
-import { join as join40 } from "path";
-import process17 from "process";
+import { join as join42 } from "path";
+import process18 from "process";
 var readManifest = (cwd) => {
-  const path = join40(cwd, "platform-skills.manifest.json");
+  const path = join42(cwd, "platform-skills.manifest.json");
   if (!existsSync11(path)) {
     return null;
   }
   return JSON.parse(readFileSync11(path, "utf8"));
 };
 var readSkillsLock = (cwd) => {
-  const path = join40(cwd, "skills-lock.json");
+  const path = join42(cwd, "skills-lock.json");
   if (!existsSync11(path)) {
     return null;
   }
@@ -19655,7 +19786,7 @@ var readSkillsLock = (cwd) => {
     return null;
   }
 };
-var skillFileExists = (cwd, name) => existsSync11(join40(cwd, ".agents", "skills", name, "SKILL.md"));
+var skillFileExists = (cwd, name) => existsSync11(join42(cwd, ".agents", "skills", name, "SKILL.md"));
 var verifyPlatformSkills = (cwd) => {
   const manifest = readManifest(cwd);
   if (manifest === null) {
@@ -19679,7 +19810,7 @@ var verifyPlatformSkills = (cwd) => {
   };
 };
 var templateLabelForPlatformSkills = (cwd) => {
-  if (!existsSync11(join40(cwd, "platform-skills.manifest.json"))) {
+  if (!existsSync11(join42(cwd, "platform-skills.manifest.json"))) {
     return null;
   }
   return inferProjectSurfaceSync(cwd).template;
@@ -19689,7 +19820,7 @@ var formatPlatformSkillsReport = (report) => {
     return [];
   }
   const lines = [];
-  const lockPath = join40(process17.cwd(), "skills-lock.json");
+  const lockPath = join42(process18.cwd(), "skills-lock.json");
   if (existsSync11(lockPath)) {
     try {
       const lock = JSON.parse(readFileSync11(lockPath, "utf8"));
@@ -19746,10 +19877,10 @@ var formatProductSurfaceHints = (env) => {
 
 // src/doctor/projectHealth.ts
 import { existsSync as existsSync12, readFileSync as readFileSync12 } from "fs";
-import { join as join41 } from "path";
+import { join as join43 } from "path";
 var GITIGNORE_ENV_LINE_PATTERN = /^\.env/m;
 var gitignoreCoversEnv = (cwd) => {
-  const path = join41(cwd, ".gitignore");
+  const path = join43(cwd, ".gitignore");
   if (!existsSync12(path)) {
     return false;
   }
@@ -19757,7 +19888,7 @@ var gitignoreCoversEnv = (cwd) => {
   return GITIGNORE_ENV_LINE_PATTERN.test(content) || content.includes(".env\n") || content.includes(".env\r\n");
 };
 var cursorignoreCoversEnv = (cwd) => {
-  const path = join41(cwd, ".cursorignore");
+  const path = join43(cwd, ".cursorignore");
   if (!existsSync12(path)) {
     return false;
   }
@@ -19847,7 +19978,7 @@ var formatRailwayStackReport = (env, agentSetup) => {
 // src/doctor/runNativeProjectSetup.ts
 import { spawnSync as spawnSync5 } from "child_process";
 import { existsSync as existsSync13 } from "fs";
-import { join as join42 } from "path";
+import { join as join44 } from "path";
 var runCommand = (options) => {
   const { args, command, cwd, label, log } = options;
   log.log(`[doctor] ${label}: ${command} ${args.join(" ")}`);
@@ -19855,7 +19986,7 @@ var runCommand = (options) => {
   return result.status === 0;
 };
 var runExtensionSetup = (cwd, log) => {
-  const wxtTypes = join42(cwd, ".wxt", "wxt.d.ts");
+  const wxtTypes = join44(cwd, ".wxt", "wxt.d.ts");
   if (existsSync13(wxtTypes)) {
     return ["\u2713 Extension - WXT types already generated."];
   }
@@ -19874,7 +20005,7 @@ var runMobileSetup = (cwd, platform, log) => {
   if (platform !== "darwin") {
     return [];
   }
-  const podfile = join42(cwd, "ios", "Podfile");
+  const podfile = join44(cwd, "ios", "Podfile");
   if (!existsSync13(podfile)) {
     return [
       "\u2192 Mobile - no `ios/` folder yet. Run `pnpm ios` (Simulator) or `npx expo prebuild --platform ios` before store builds."
@@ -19883,7 +20014,7 @@ var runMobileSetup = (cwd, platform, log) => {
   const ok = runCommand({
     log,
     label: "installing iOS pods",
-    cwd: join42(cwd, "ios"),
+    cwd: join44(cwd, "ios"),
     command: "pod",
     args: ["install"]
   });
@@ -19908,14 +20039,14 @@ var runNativeProjectSetup = (cwd, surface, platform, log = console) => {
 // src/doctor/storageR2.ts
 import { spawnSync as spawnSync6 } from "child_process";
 import { readFileSync as readFileSync13 } from "fs";
-import { join as join43 } from "path";
+import { join as join45 } from "path";
 var R2_BUCKET_UNSAFE_PATTERN = /[^a-z0-9-]/g;
 var R2_BUCKET_DASH_RUN_PATTERN = /-+/g;
 var R2_BUCKET_EDGE_DASH_PATTERN = /^-|-$/g;
 var sanitizeBucketName = (name) => name.toLowerCase().replace(R2_BUCKET_UNSAFE_PATTERN, "-").replace(R2_BUCKET_DASH_RUN_PATTERN, "-").replace(R2_BUCKET_EDGE_DASH_PATTERN, "").slice(0, 40);
 var readProjectName = (cwd) => {
   try {
-    const pkg = JSON.parse(readFileSync13(join43(cwd, "package.json"), "utf8"));
+    const pkg = JSON.parse(readFileSync13(join45(cwd, "package.json"), "utf8"));
     if (pkg.name !== void 0 && pkg.name !== "" && pkg.name !== "my-vybekiit-app") {
       return sanitizeBucketName(pkg.name);
     }
@@ -20000,8 +20131,8 @@ var provisionR2Storage = async (cwd, env, log) => {
   if (wranglerOk(["r2", "bucket", "create", bucketName])) {
     log.log(`[doctor] Created R2 bucket "${bucketName}".`);
   } else {
-    const exists = wranglerOk(["r2", "bucket", "list"]);
-    if (!exists) {
+    const exists2 = wranglerOk(["r2", "bucket", "list"]);
+    if (!exists2) {
       return { ok: false, message: `Could not create R2 bucket "${bucketName}".` };
     }
     log.log(`[doctor] R2 bucket "${bucketName}" already exists or create skipped.`);
@@ -20482,7 +20613,7 @@ var verifyPresetsDoctor = async (env) => {
 
 // src/doctor/run.ts
 var toPlatform = (platform) => platform === "darwin" || platform === "win32" || platform === "linux" ? platform : null;
-var isCursorSession = () => Boolean(process18.env.CURSOR_TRACE_ID || process18.env.CURSOR_SESSION_ID);
+var isCursorSession = () => Boolean(process19.env.CURSOR_TRACE_ID || process19.env.CURSOR_SESSION_ID);
 var succeeds = (command, args) => spawnSync7(command, [...args], { stdio: "ignore" }).status === 0;
 var errorCode = (error) => error !== void 0 && "code" in error && typeof error.code === "string" ? error.code : void 0;
 var runInstall = (action, log) => {
@@ -20610,14 +20741,14 @@ var writeReportModeAssistant = (options) => {
   }
 };
 var runDoctor = async (log = console) => {
-  const platform = toPlatform(process18.platform);
+  const platform = toPlatform(process19.platform);
   if (platform === null) {
-    log.error(`[doctor] This operating system (${process18.platform}) isn't supported yet.`);
+    log.error(`[doctor] This operating system (${process19.platform}) isn't supported yet.`);
     return 1;
   }
-  const cwd = process18.cwd();
+  const cwd = process19.cwd();
   const surface = inferProjectSurfaceSync(cwd);
-  const env = mergeEnv(process18.env, loadEnvFile2(cwd));
+  const env = mergeEnv(process19.env, loadEnvFile2(cwd));
   const cursorSession = isCursorSession();
   if (cursorSession) {
     log.log("\u2713 Cursor - you're in Cursor; no separate agent install needed.");
@@ -20642,6 +20773,7 @@ var runDoctor = async (log = console) => {
   const cloudReady = infraTools.every((tool) => reportFor(reports, tool.name)?.installed === true);
   const agentReady = isAgentRuntimeReady(reports) || cursorSession;
   await ensureCodexSkills(reports, log);
+  log.log(formatGlobalStatus(await readGlobalStatus()));
   writeReportModeAssistant({ cwd, surface, reports, cursorSession, log });
   return computeDoctorExitCode({
     cloudReady,
@@ -20653,11 +20785,429 @@ var runDoctor = async (log = console) => {
   });
 };
 
-// src/ui/welcomeBanner.ts
+// src/global/runGlobalInstall.ts
+import process21 from "process";
+import { confirm, isCancel as isCancel2 } from "@clack/prompts";
+
+// src/global/awareness.ts
+import { mkdir as mkdir10, readFile as readFile17, writeFile as writeFile11 } from "fs/promises";
+import { dirname as dirname15 } from "path";
+var BEGIN_MARKER = "<!-- BEGIN VYBEKIIT (managed by `vybekiit setup`) -->";
+var END_MARKER = "<!-- END VYBEKIIT -->";
+var LEADING_NEWLINE = /^\n/;
+var VYBEKIIT_COMMAND = `---
+description: Show VybeKiit status and what you can do with it right now
+---
+VybeKiit is installed globally on this machine. Orient the user in plain, non-technical language.
+
+Do this now, briefly:
+1. Say: "\u2705 VybeKiit is active \u2014 you have its skills and browser automation in every project."
+2. Read the skill names under ~/.claude/skills and name 4-5 useful ones (for example: onboarding,
+   plan-my-idea, setup-payments, add-signin, go-live).
+3. If there is no app in the current folder yet, offer to run \`vybekiit create app --web\`.
+   Otherwise ask what they want to build or change next.
+
+Keep it short and friendly. Do not dump the whole skill list.
+`;
+var buildMemoryBlock = () => [
+  BEGIN_MARKER,
+  "## VybeKiit is active on this machine",
+  "",
+  "VybeKiit is installed globally: its skills live in `~/.claude/skills`, and the `playwright`",
+  "and `context7` MCP servers are registered (browser automation + live library docs).",
+  "",
+  "At the start of a session in any project, briefly tell the user VybeKiit is available, and use",
+  "its skills (onboarding, plan-my-idea, setup-payments, add-signin, go-live, harden, \u2026) when they",
+  "fit the request. The user can type `/vybekiit` any time to see status.",
+  END_MARKER,
+  ""
+].join("\n");
+var upsertMemoryBlock = (existing, block) => {
+  const begin = existing.indexOf(BEGIN_MARKER);
+  const end = existing.indexOf(END_MARKER);
+  if (begin !== -1 && end !== -1 && end > begin) {
+    const before = existing.slice(0, begin);
+    const after = existing.slice(end + END_MARKER.length).replace(LEADING_NEWLINE, "");
+    return `${before}${block}${after}`;
+  }
+  if (existing.trim() === "") {
+    return block;
+  }
+  return `${existing.trimEnd()}
+
+${block}`;
+};
+var readOrEmpty = async (path) => {
+  try {
+    return await readFile17(path, "utf8");
+  } catch (error) {
+    if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+      return "";
+    }
+    throw error;
+  }
+};
+var writeIfChanged = async (path, next, previous) => {
+  if (next === previous) {
+    return false;
+  }
+  await mkdir10(dirname15(path), { recursive: true });
+  await writeFile11(path, next, "utf8");
+  return true;
+};
+var withStatusLineBadge = (raw) => {
+  let settings = {};
+  if (raw.trim() !== "") {
+    try {
+      settings = JSON.parse(raw);
+    } catch {
+      return null;
+    }
+  }
+  if (settings.statusLine !== void 0) {
+    return null;
+  }
+  settings.statusLine = { type: "command", command: "echo '\u25C6 vybekiit'" };
+  return `${JSON.stringify(settings, null, 2)}
+`;
+};
+var installAwareness = async (paths) => {
+  const commandPath = `${paths.commandsDir}/vybekiit.md`;
+  const commandWritten = await writeIfChanged(
+    commandPath,
+    VYBEKIIT_COMMAND,
+    await readOrEmpty(commandPath)
+  );
+  const previousMemory = await readOrEmpty(paths.memoryFile);
+  const memoryUpdated = await writeIfChanged(
+    paths.memoryFile,
+    upsertMemoryBlock(previousMemory, buildMemoryBlock()),
+    previousMemory
+  );
+  const previousSettings = await readOrEmpty(paths.settingsFile);
+  const nextSettings = withStatusLineBadge(previousSettings);
+  const statusLineSet = nextSettings !== null && await writeIfChanged(paths.settingsFile, nextSettings, previousSettings);
+  return { commandWritten, memoryUpdated, statusLineSet };
+};
+
+// src/global/exec.ts
+import { execFile as execFile6 } from "child_process";
+var makeExec = (bin) => (args) => new Promise((resolve13) => {
+  execFile6(bin, [...args], { encoding: "utf8" }, (error, stdout, stderr) => {
+    if (error && "code" in error && error.code === "ENOENT") {
+      resolve13({ code: 127, stdout: "", stderr: `${bin} not found` });
+      return;
+    }
+    let code = 0;
+    if (error) {
+      code = typeof error.code === "number" ? error.code : 1;
+    }
+    resolve13({ code, stdout: stdout ?? "", stderr: stderr ?? "" });
+  });
+});
+
+// src/global/entitlement.ts
+var MIRROR_ORG3 = "VybeKiit";
+var SURFACE_MIRRORS = ["web", "mobile", "backend", "extension", "spa"];
+var defaultDeps = { exec: makeExec("gh") };
+var resolveLogin = async (exec) => {
+  const res = await exec(["api", "user", "--jq", ".login"]);
+  if (res.code !== 0) {
+    return null;
+  }
+  const login = res.stdout.trim();
+  return login === "" ? null : login;
+};
+var checkEntitlement = async (deps = defaultDeps) => {
+  const { exec } = deps;
+  if ((await exec(["--version"])).code === 127) {
+    return { entitled: false, reason: "gh-missing" };
+  }
+  const login = await resolveLogin(exec);
+  if (login === null) {
+    return { entitled: false, reason: "not-authenticated" };
+  }
+  for (const surface of SURFACE_MIRRORS) {
+    const repo = `${MIRROR_ORG3}/${surface}`;
+    if ((await exec(["api", `repos/${repo}`, "--silent"])).code === 0) {
+      return { entitled: true, reason: "entitled", login, via: repo };
+    }
+  }
+  return { entitled: false, reason: "no-access", login };
+};
+var formatEntitlementBlock = (result) => {
+  const lines = [
+    "",
+    "\u2717 VybeKiit is a paid kit \u2014 this GitHub account is not on the buyer list.",
+    ""
+  ];
+  if (result.reason === "gh-missing") {
+    lines.push(
+      "GitHub CLI (gh) was not found. Install it from https://cli.github.com, then run",
+      "  gh auth login --web",
+      "signed in with the GitHub account you purchased VybeKiit with, and re-run."
+    );
+  } else if (result.reason === "not-authenticated") {
+    lines.push(
+      "You are not signed in to GitHub. Run",
+      "  gh auth login --web",
+      "with the GitHub account you purchased VybeKiit with, then re-run."
+    );
+  } else {
+    lines.push(
+      `Signed in as '${result.login}', but that account can't access the VybeKiit kit.`,
+      "If you have purchased, accept the repository invite (check your email or",
+      "https://github.com/notifications), or email info@vybekiit.com.",
+      "",
+      "Not a buyer yet?  https://vybekiit.com"
+    );
+  }
+  lines.push("");
+  return lines;
+};
+
+// src/global/installGlobalMcp.ts
 import process20 from "process";
+var ZERO_CONFIG = [
+  {
+    name: "playwright",
+    transport: "stdio",
+    command: ["npx", "-y", "@anthropic-ai/mcp-playwright"]
+  },
+  { name: "context7", transport: "stdio", command: ["npx", "-y", "@upstash/context7-mcp@latest"] },
+  { name: "sentry", transport: "sse", command: ["https://mcp.sentry.dev/sse"] }
+];
+var KEY_GATED = [
+  {
+    name: "github",
+    transport: "stdio",
+    command: ["npx", "-y", "@modelcontextprotocol/server-github"],
+    envKeys: ["GITHUB_PERSONAL_ACCESS_TOKEN"]
+  },
+  {
+    name: "supabase",
+    transport: "stdio",
+    command: ["npx", "-y", "supabase-mcp-server"],
+    envKeys: ["SUPABASE_ACCESS_TOKEN"]
+  },
+  {
+    name: "vercel",
+    transport: "stdio",
+    command: ["npx", "-y", "@vercel/mcp"],
+    envKeys: ["VERCEL_TOKEN"]
+  },
+  {
+    name: "stripe",
+    transport: "stdio",
+    command: ["npx", "-y", "@stripe/mcp"],
+    envKeys: ["STRIPE_SECRET_KEY"]
+  },
+  {
+    name: "cloudflare",
+    transport: "stdio",
+    command: ["npx", "-y", "@anthropic-ai/mcp-cloudflare"],
+    envKeys: ["CLOUDFLARE_API_TOKEN"]
+  },
+  {
+    name: "figma",
+    transport: "stdio",
+    command: ["npx", "-y", "@anthropic-ai/mcp-figma"],
+    envKeys: ["FIGMA_ACCESS_TOKEN"]
+  },
+  {
+    name: "resend",
+    transport: "stdio",
+    command: ["npx", "-y", "resend-mcp"],
+    envKeys: ["RESEND_API_KEY"]
+  },
+  {
+    name: "exa",
+    transport: "stdio",
+    command: ["npx", "-y", "exa-mcp-server"],
+    envKeys: ["EXA_API_KEY"]
+  },
+  {
+    name: "firecrawl",
+    transport: "stdio",
+    command: ["npx", "-y", "firecrawl-mcp"],
+    envKeys: ["FIRECRAWL_API_KEY"]
+  },
+  {
+    name: "tavily",
+    transport: "stdio",
+    command: ["npx", "-y", "tavily-mcp"],
+    envKeys: ["TAVILY_API_KEY"]
+  }
+];
+var defaultDeps2 = { exec: makeExec("claude"), env: process20.env };
+var buildAddArgs = (def, env) => {
+  if (def.transport === "sse") {
+    const [url = ""] = def.command;
+    return ["mcp", "add", "-s", "user", "--transport", "sse", def.name, url];
+  }
+  const envFlags = (def.envKeys ?? []).flatMap((key) => ["-e", `${key}=${env[key] ?? ""}`]);
+  return ["mcp", "add", "-s", "user", ...envFlags, def.name, "--", ...def.command];
+};
+var hasKeys = (def, env) => (def.envKeys ?? []).every((key) => (env[key] ?? "") !== "");
+var installGlobalMcp = async (deps = defaultDeps2) => {
+  const version = await deps.exec(["--version"]);
+  if (version.code === 127) {
+    return { enabled: [], alreadyPresent: [], needsKey: [], failed: [], claudeMissing: true };
+  }
+  const enabled = [];
+  const alreadyPresent = [];
+  const needsKey = [];
+  const failed = [];
+  const candidates = [...ZERO_CONFIG, ...KEY_GATED];
+  for (const def of candidates) {
+    if (!hasKeys(def, deps.env)) {
+      needsKey.push(def.name);
+      continue;
+    }
+    if ((await deps.exec(["mcp", "get", def.name])).code === 0) {
+      alreadyPresent.push(def.name);
+      continue;
+    }
+    const added = await deps.exec(buildAddArgs(def, deps.env));
+    if (added.code === 0) {
+      enabled.push(def.name);
+    } else {
+      failed.push(def.name);
+    }
+  }
+  return { enabled, alreadyPresent, needsKey, failed, claudeMissing: false };
+};
+
+// src/global/installGlobalSkills.ts
+import { cp as cp5, mkdir as mkdir11, readdir as readdir9, readFile as readFile18, rm as rm5, stat as stat2, writeFile as writeFile12 } from "fs/promises";
+import { join as join46 } from "path";
+var MANAGED_MARKER = ".vybekiit-managed";
+var pathExists8 = async (path) => {
+  try {
+    await stat2(path);
+    return true;
+  } catch {
+    return false;
+  }
+};
+var listBundledSkills = async (sourceDir) => {
+  try {
+    const manifest = JSON.parse(await readFile18(join46(sourceDir, "manifest.json"), "utf8"));
+    if (Array.isArray(manifest.skills)) {
+      return [...manifest.skills];
+    }
+  } catch {
+  }
+  try {
+    const entries = await readdir9(sourceDir, { withFileTypes: true });
+    return entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name);
+  } catch {
+    return [];
+  }
+};
+var installGlobalSkills = async (paths, sourceDir = paths.bundledSkillsDir) => {
+  const names = await listBundledSkills(sourceDir);
+  await mkdir11(paths.skillsDir, { recursive: true });
+  const installed = [];
+  const skipped = [];
+  for (const name of names) {
+    const dest = join46(paths.skillsDir, name);
+    if (await pathExists8(dest)) {
+      if (!await pathExists8(join46(dest, MANAGED_MARKER))) {
+        skipped.push(name);
+        continue;
+      }
+      await rm5(dest, { recursive: true, force: true });
+    }
+    await cp5(join46(sourceDir, name), dest, { recursive: true });
+    await writeFile12(join46(dest, MANAGED_MARKER), "", "utf8");
+    installed.push(name);
+  }
+  return { installed, skipped, path: paths.skillsDir };
+};
+
+// src/global/runGlobalInstall.ts
+var formatGlobalInstallSummary = (summary) => {
+  const lines = [
+    "",
+    "\u2705 VybeKiit is now set up globally in Claude Code.",
+    "",
+    `  \u2022 Skills   ${summary.skillsInstalled} installed in ~/.claude/skills (available in every project)`
+  ];
+  if (summary.claudeMissing) {
+    lines.push("  \u2022 MCP      skipped \u2014 the `claude` command was not found on your PATH");
+  } else {
+    lines.push(
+      `  \u2022 MCP      ${summary.mcpEnabled.length > 0 ? summary.mcpEnabled.join(", ") : "none"} enabled (browser automation + live docs everywhere)`
+    );
+    if (summary.mcpNeedsKey.length > 0) {
+      lines.push(
+        `             ${summary.mcpNeedsKey.length} more need an API key \u2014 run \`vybekiit env wizard\``
+      );
+    }
+  }
+  lines.push(
+    "  \u2022 Command  type /vybekiit in Claude Code to see status anytime",
+    "  \u2022 Claude now knows it is VybeKiit-enabled in every project",
+    "",
+    "To see it: restart Claude Code (or run `claude` once) to approve the new MCP servers,",
+    "then type /vybekiit to confirm.",
+    ""
+  );
+  return lines;
+};
+var runGlobalInstall = async (args, gate = checkEntitlement) => {
+  const entitlement = await gate();
+  if (!entitlement.entitled) {
+    for (const line of formatEntitlementBlock(entitlement)) {
+      process21.stderr.write(`${line}
+`);
+    }
+    return 1;
+  }
+  const skipPrompt = args.includes("--yes") || args.includes("-y");
+  if (!skipPrompt) {
+    if (!isInteractive()) {
+      process21.stdout.write(
+        "Skipping global setup (non-interactive). Run `vybekiit global-install --yes` to provision Claude Code globally.\n"
+      );
+      return 0;
+    }
+    const proceed = await confirm({
+      message: "Set up VybeKiit globally in Claude Code? Adds skills + browser automation to every project.",
+      initialValue: true
+    });
+    if (isCancel2(proceed) || proceed !== true) {
+      process21.stdout.write(
+        "Skipped global setup. You can run `vybekiit global-install` anytime.\n"
+      );
+      return 0;
+    }
+  }
+  const paths = resolveGlobalPaths();
+  const skills = await installGlobalSkills(paths);
+  const mcp = await installGlobalMcp();
+  const awareness = await installAwareness(paths);
+  const summary = {
+    skillsInstalled: skills.installed.length,
+    skillsSkipped: skills.skipped.length,
+    mcpEnabled: mcp.enabled,
+    mcpNeedsKey: mcp.needsKey,
+    claudeMissing: mcp.claudeMissing,
+    commandInstalled: awareness.commandWritten
+  };
+  for (const line of formatGlobalInstallSummary(summary)) {
+    process21.stdout.write(`${line}
+`);
+  }
+  return 0;
+};
+
+// src/ui/welcomeBanner.ts
+import process23 from "process";
 
 // src/ui/ansiShimmer.ts
-import process19 from "process";
+import process22 from "process";
 var RESET = "\x1B[0m";
 var GRADIENT_START = [34, 211, 238];
 var GRADIENT_END = [167, 139, 250];
@@ -20669,7 +21219,7 @@ var colorAt = (t) => rgb(
   lerp(GRADIENT_START[1], GRADIENT_END[1], t),
   lerp(GRADIENT_START[2], GRADIENT_END[2], t)
 );
-var supportsColor = (env = process19.env, isTTY = Boolean(process19.stdout.isTTY)) => {
+var supportsColor = (env = process22.env, isTTY = Boolean(process22.stdout.isTTY)) => {
   if (env.NO_COLOR !== void 0 && env.NO_COLOR !== "") {
     return false;
   }
@@ -20700,8 +21250,8 @@ var applyShimmerSweep = (lines, frame, options) => {
   });
 };
 var DIM = "\x1B[2m";
-var sleep = (ms) => new Promise((resolve14) => {
-  setTimeout(resolve14, ms);
+var sleep = (ms) => new Promise((resolve13) => {
+  setTimeout(resolve13, ms);
 });
 
 // src/ui/welcomeBanner.ts
@@ -20731,13 +21281,13 @@ var writeBlock = (write, lines) => {
   }
 };
 var playWelcomeBanner = async (options = {}) => {
-  const write = options.write === void 0 ? (text2) => process20.stdout.write(text2) : options.write;
+  const write = options.write === void 0 ? (text2) => process23.stdout.write(text2) : options.write;
   const sleepFn = options.sleep === void 0 ? sleep : options.sleep;
   const frames = options.frames === void 0 ? DEFAULT_FRAMES : options.frames;
   const frameDelayMs = options.frameDelayMs === void 0 ? DEFAULT_FRAME_DELAY_MS : options.frameDelayMs;
   const art = [...WELCOME_ART];
   const useColor = !options.forcePlain && supportsColor();
-  const animate = useColor && Boolean(process20.stdout.isTTY) && frames > 0;
+  const animate = useColor && Boolean(process23.stdout.isTTY) && frames > 0;
   if (!animate) {
     writeBlock(write, art);
     writeln(write, "");
@@ -20804,30 +21354,31 @@ var formatSetupNextStep = (input) => {
 var runSetup = async () => {
   await playWelcomeBanner();
   const code = await runDoctor();
+  await runGlobalInstall([]);
   const access15 = checkAccess();
-  process21.stdout.write("\n");
+  process24.stdout.write("\n");
   for (const line of formatSetupNextStep({
     doctorExitCode: code,
     gateReason: access15.reason
   })) {
-    process21.stdout.write(`${line}
+    process24.stdout.write(`${line}
 `);
   }
   return code;
 };
 
 // src/commands/syncAgentLayer.ts
-import { execFile as execFile6 } from "child_process";
-import { access as access14, cp as cp5, readFile as readFile16, writeFile as writeFile11 } from "fs/promises";
-import { join as join44 } from "path";
-import process22 from "process";
+import { execFile as execFile7 } from "child_process";
+import { access as access14, cp as cp6, readFile as readFile19, writeFile as writeFile13 } from "fs/promises";
+import { join as join47 } from "path";
+import process25 from "process";
 import { promisify as promisify6 } from "util";
-var execFileAsync6 = promisify6(execFile6);
-var defaultDeps = {
+var execFileAsync6 = promisify6(execFile7);
+var defaultDeps3 = {
   resolve: resolveTemplatesSource,
-  copy: cp5,
+  copy: cp6,
   runSkillsUpdate: async (cwd) => {
-    await execFileAsync6("npx", ["skills", "update", "-y"], { cwd, env: process22.env });
+    await execFileAsync6("npx", ["skills", "update", "-y"], { cwd, env: process25.env });
   },
   pathExists: async (path) => {
     try {
@@ -20847,10 +21398,10 @@ var resolveSyncTemplate = async (explicit, cwd) => {
   }
   return null;
 };
-var listMirrorAgentPaths = async (mirrorRoot, pathExists8) => {
+var listMirrorAgentPaths = async (mirrorRoot, pathExists9) => {
   const entries = await Promise.all(
     AGENT_LAYER_PATHS.map(async (path) => {
-      if (await pathExists8(join44(mirrorRoot, path))) {
+      if (await pathExists9(join47(mirrorRoot, path))) {
         return path;
       }
       return null;
@@ -20859,29 +21410,29 @@ var listMirrorAgentPaths = async (mirrorRoot, pathExists8) => {
   return entries.filter((path) => path !== null);
 };
 var copyAgentLayerPath = async (options) => {
-  const { mirrorRoot, cwd, path, copy, pathExists: pathExists8 } = options;
-  const src = join44(mirrorRoot, path);
-  const dest = join44(cwd, path);
+  const { mirrorRoot, cwd, path, copy, pathExists: pathExists9 } = options;
+  const src = join47(mirrorRoot, path);
+  const dest = join47(cwd, path);
   if (path !== ".vybekiit") {
     await copy(src, dest, { recursive: true, force: true });
     return;
   }
-  const { readdir: readdir8, stat, mkdir: mkdir10 } = await import("fs/promises");
+  const { readdir: readdir10, stat: stat3, mkdir: mkdir12 } = await import("fs/promises");
   const walk = async (rel) => {
     const relNorm = rel.split("\\").join("/");
     if (isAgentLayerExtensionPath(relNorm)) {
       return;
     }
-    const srcPath = join44(mirrorRoot, relNorm);
-    const destPath = join44(cwd, relNorm);
-    if (!await pathExists8(srcPath)) {
+    const srcPath = join47(mirrorRoot, relNorm);
+    const destPath = join47(cwd, relNorm);
+    if (!await pathExists9(srcPath)) {
       return;
     }
-    const info = await stat(srcPath);
+    const info = await stat3(srcPath);
     if (info.isDirectory()) {
-      await mkdir10(destPath, { recursive: true });
-      const entries = await readdir8(srcPath);
-      await Promise.all(entries.map((entry) => walk(join44(relNorm, entry))));
+      await mkdir12(destPath, { recursive: true });
+      const entries = await readdir10(srcPath);
+      await Promise.all(entries.map((entry) => walk(join47(relNorm, entry))));
       return;
     }
     await copy(srcPath, destPath, { force: true });
@@ -20905,21 +21456,21 @@ var readGoalIndexBeforeSync = async (pathsToSync, cwd, deps) => {
   if (!pathsToSync.includes(".vybekiit")) {
     return;
   }
-  const goalIndexPath = join44(cwd, ".vybekiit/agent/goal-index.md");
+  const goalIndexPath = join47(cwd, ".vybekiit/agent/goal-index.md");
   if (!await deps.pathExists(goalIndexPath)) {
     return;
   }
-  return await readFile16(goalIndexPath, "utf8");
+  return await readFile19(goalIndexPath, "utf8");
 };
 var mergeGoalIndexAfterSync = async (cwd, goalIndexBefore) => {
   if (goalIndexBefore === void 0) {
     return;
   }
-  const goalIndexPath = join44(cwd, ".vybekiit/agent/goal-index.md");
-  const synced = await readFile16(goalIndexPath, "utf8");
+  const goalIndexPath = join47(cwd, ".vybekiit/agent/goal-index.md");
+  const synced = await readFile19(goalIndexPath, "utf8");
   const merged = mergeGoalIndexOnSync(synced, goalIndexBefore);
   if (merged !== synced) {
-    await writeFile11(goalIndexPath, merged, "utf8");
+    await writeFile13(goalIndexPath, merged, "utf8");
   }
 };
 var refreshGeneratedInstructionSections = async (cwd, template, deps) => {
@@ -20930,14 +21481,14 @@ var refreshGeneratedInstructionSections = async (cwd, template, deps) => {
   const rendered = applyAgentLayerSections(fileContents, { template });
   const writes = Object.entries(rendered).map(async ([file, content]) => {
     if (fileContents[file] !== void 0 && content !== fileContents[file]) {
-      await writeFile11(join44(cwd, file), content, "utf8");
+      await writeFile13(join47(cwd, file), content, "utf8");
     }
   });
   await Promise.all(writes);
   return true;
 };
 var refreshPlatformInstructionFiles = async (cwd, deps) => {
-  if (!await deps.pathExists(join44(cwd, "skills-lock.json"))) {
+  if (!await deps.pathExists(join47(cwd, "skills-lock.json"))) {
     return "missing-lock";
   }
   try {
@@ -20947,7 +21498,7 @@ var refreshPlatformInstructionFiles = async (cwd, deps) => {
     return "failed";
   }
 };
-var runSyncAgentLayer = async (args, cwd = process22.cwd(), deps = defaultDeps) => {
+var runSyncAgentLayer = async (args, cwd = process25.cwd(), deps = defaultDeps3) => {
   const [explicit] = args;
   const template = await resolveSyncTemplate(explicit, cwd);
   if (template === null) {
@@ -20966,7 +21517,7 @@ var runSyncAgentLayer = async (args, cwd = process22.cwd(), deps = defaultDeps)
     });
     const { cleanup: resolvedCleanup, source } = resolved;
     cleanup = resolvedCleanup;
-    const mirrorRoot = join44(source, template);
+    const mirrorRoot = join47(source, template);
     const mirrorPaths = await listMirrorAgentPaths(mirrorRoot, deps.pathExists);
     const plan = planAgentLayerSync(mirrorPaths);
     const lines = [formatAgentLayerSyncSummary(plan)];
@@ -21002,7 +21553,7 @@ var runSyncAgentLayer = async (args, cwd = process22.cwd(), deps = defaultDeps)
 };
 
 // src/commands/updateKit.ts
-import process23 from "process";
+import process26 from "process";
 import { Effect as Effect30 } from "effect";
 var runUpdateKit = async (args = []) => {
   const apply = args.includes("--apply");
@@ -21030,7 +21581,7 @@ var runUpdateKit = async (args = []) => {
 var runUpdateKitCommand = async (args) => {
   const result = await runUpdateKit(args);
   for (const line of result.lines) {
-    process23.stdout.write(`${line}
+    process26.stdout.write(`${line}
 `);
   }
   return result.exitCode;
@@ -21038,7 +21589,7 @@ var runUpdateKitCommand = async (args) => {
 
 // src/doctor/ensureTool.ts
 import { spawnSync as spawnSync8 } from "child_process";
-import process24 from "process";
+import process27 from "process";
 var toPlatform2 = (platform) => platform === "darwin" || platform === "win32" || platform === "linux" ? platform : null;
 var succeeds2 = (command, args) => spawnSync8(command, [...args], { stdio: "ignore" }).status === 0;
 var errorCode2 = (error) => error !== void 0 && "code" in error && typeof error.code === "string" ? error.code : void 0;
@@ -21061,9 +21612,9 @@ var ensureTool = (name, log = console) => {
   if (tool === void 0) {
     return { tool: name, known: false, installed: false, installedNow: false, authed: null };
   }
-  const platform = toPlatform2(process24.platform);
+  const platform = toPlatform2(process27.platform);
   if (!platform) {
-    log.error(`[doctor] This operating system (${process24.platform}) isn't supported yet.`);
+    log.error(`[doctor] This operating system (${process27.platform}) isn't supported yet.`);
     return { tool: name, known: true, installed: false, installedNow: false, authed: null };
   }
   const present = succeeds2(tool.name, tool.versionArgs);
@@ -21107,9 +21658,9 @@ var formatEnsureResult = (result) => {
 };
 
 // src/prompts/envWizard.ts
-import { readFile as readFile17 } from "fs/promises";
-import { join as join45 } from "path";
-import { cancel as cancel2, isCancel as isCancel2, text } from "@clack/prompts";
+import { readFile as readFile20 } from "fs/promises";
+import { join as join48 } from "path";
+import { cancel as cancel2, isCancel as isCancel3, text } from "@clack/prompts";
 var ENV_KEY_PATTERN = /^[A-Z][A-Z0-9_]*$/;
 var parseExampleEnvKeys = (raw) => raw.split("\n").reduce((keys, line) => {
   const separatorIndex = line.indexOf("=");
@@ -21160,19 +21711,19 @@ ${nextLine}
 `;
 };
 var runEnvWizard = async (cwd = process.cwd()) => {
-  const examplePath = join45(cwd, ".env.example");
+  const examplePath = join48(cwd, ".env.example");
   let raw;
   try {
-    raw = await readFile17(examplePath, "utf8");
+    raw = await readFile20(examplePath, "utf8");
   } catch {
     process.stderr.write("No .env.example in this folder.\n");
     return 1;
   }
   const keys = parseExampleEnvKeys(raw);
-  const envPath = join45(cwd, ".env");
+  const envPath = join48(cwd, ".env");
   let envContent = "";
   try {
-    envContent = await readFile17(envPath, "utf8");
+    envContent = await readFile20(envPath, "utf8");
   } catch {
   }
   for (const key of keys) {
@@ -21184,19 +21735,19 @@ var runEnvWizard = async (cwd = process.cwd()) => {
       defaultValue: current,
       placeholder: current
     });
-    if (isCancel2(value)) {
+    if (isCancel3(value)) {
       cancel2("Cancelled.");
       return 1;
     }
     envContent = upsertEnvLine(envContent, key, value);
   }
-  const { writeFile: writeFile12 } = await import("fs/promises");
-  await writeFile12(envPath, envContent, "utf8");
+  const { writeFile: writeFile14 } = await import("fs/promises");
+  await writeFile14(envPath, envContent, "utf8");
   return 0;
 };
 
 // src/prompts/mainMenu.ts
-import { cancel as cancel3, intro, isCancel as isCancel3, select as select2 } from "@clack/prompts";
+import { cancel as cancel3, intro, isCancel as isCancel4, select as select2 } from "@clack/prompts";
 var promptMainMenu = async () => {
   intro("Welcome to VybeKiit");
   const picked = await select2({
@@ -21229,7 +21780,7 @@ var promptMainMenu = async () => {
       }
     ]
   });
-  if (isCancel3(picked) || typeof picked !== "string") {
+  if (isCancel4(picked) || typeof picked !== "string") {
     cancel3("Cancelled.");
     return null;
   }
@@ -21240,11 +21791,11 @@ var promptMainMenu = async () => {
 };
 
 // src/cliRunner.ts
-var HERE7 = dirname14(fileURLToPath7(import.meta.url));
-var GATE_EXEMPT = /* @__PURE__ */ new Set(["doctor", "setup"]);
+var HERE7 = dirname16(fileURLToPath8(import.meta.url));
+var GATE_EXEMPT = /* @__PURE__ */ new Set(["doctor", "setup", "global-install"]);
 var readVersion = async () => {
   try {
-    const raw = await readFile18(join46(HERE7, "..", "package.json"), "utf8");
+    const raw = await readFile21(join49(HERE7, "..", "package.json"), "utf8");
     const parsed = JSON.parse(raw);
     if (parsed.version !== void 0 && parsed.version !== "") {
       return parsed.version;
@@ -21269,7 +21820,7 @@ var commandArgs = (context) => {
 };
 var writeLines2 = (lines) => {
   for (const line of lines) {
-    process25.stdout.write(`${line}
+    process28.stdout.write(`${line}
 `);
   }
 };
@@ -21285,20 +21836,20 @@ var runDoctorEnsure = (toolName, json) => {
   if (toolName === void 0 || toolName === "" || toolName.startsWith("--")) {
     const message = "Usage: vybekiit doctor --ensure <tool> [--json]";
     if (json) {
-      process25.stdout.write(`${JSON.stringify({ ok: false, error: message })}
+      process28.stdout.write(`${JSON.stringify({ ok: false, error: message })}
 `);
     } else {
-      process25.stderr.write(`${message}
+      process28.stderr.write(`${message}
 `);
     }
     return 1;
   }
   const result = ensureTool(toolName);
   if (json) {
-    process25.stdout.write(`${JSON.stringify({ ok: result.installed, ...result })}
+    process28.stdout.write(`${JSON.stringify({ ok: result.installed, ...result })}
 `);
   } else {
-    process25.stdout.write(`${formatEnsureResult(result)}
+    process28.stdout.write(`${formatEnsureResult(result)}
 `);
   }
   return result.installed ? 0 : 1;
@@ -21314,47 +21865,47 @@ var handleDoctorCommand = async (context) => {
 var handleBackendCommand = async (context) => {
   if (context.subcommand === "add-route") {
     const result = await runBackendAddRoute([...context.rest]);
-    process25.stdout.write(`${result.message}
+    process28.stdout.write(`${result.message}
 `);
     return result.exitCode;
   }
   if (context.subcommand === "add-crud") {
     const result = await runBackendAddCrud([...context.rest]);
-    process25.stdout.write(`${result.message}
+    process28.stdout.write(`${result.message}
 `);
     return result.exitCode;
   }
   if (context.subcommand === "add-upload") {
     const result = await runBackendAddUpload();
-    process25.stdout.write(`${result.message}
+    process28.stdout.write(`${result.message}
 `);
     return result.exitCode;
   }
   if (context.subcommand === "gen-contract") {
     const result = await runBackendGenContract();
-    process25.stdout.write(`${result.message}
+    process28.stdout.write(`${result.message}
 `);
     return result.exitCode;
   }
-  process25.stderr.write(
+  process28.stderr.write(
     "Unknown backend command. Try: backend add-route | add-crud | add-upload | gen-contract\n"
   );
   return 1;
 };
 var handleEnvCommand = async (context) => {
   if (context.subcommand !== "wizard") {
-    process25.stderr.write("Unknown env command. Try: vybekiit env wizard\n");
+    process28.stderr.write("Unknown env command. Try: vybekiit env wizard\n");
     return 1;
   }
   if (!isInteractive()) {
-    process25.stderr.write("env wizard requires an interactive terminal.\n");
+    process28.stderr.write("env wizard requires an interactive terminal.\n");
     return 1;
   }
   return await runEnvWizard();
 };
 var handleCreateCommand = async (context) => {
   if (context.subcommand !== "app") {
-    process25.stderr.write("Usage: vybekiit create app --web|--mobile|--extension [directory]\n");
+    process28.stderr.write("Usage: vybekiit create app --web|--mobile|--extension [directory]\n");
     return 1;
   }
   return await runCreateApp([...context.rest]);
@@ -21362,7 +21913,7 @@ var handleCreateCommand = async (context) => {
 var wantsFullHelp = (argv) => argv.includes("--all") || argv.includes("-a");
 var runMainMenuChoice = async (choice) => {
   if (choice === "help-all") {
-    process25.stdout.write(`${CLI_HELP_ALL}
+    process28.stdout.write(`${CLI_HELP_ALL}
 `);
     return 0;
   }
@@ -21389,23 +21940,24 @@ var handleAddCommand = async (context) => {
   }
   if (context.subcommand === "page-recipe") {
     const result = await runAddPageRecipe([...context.rest]);
-    process25.stdout.write(`${result.json}
+    process28.stdout.write(`${result.json}
 `);
     return result.exitCode;
   }
   if (context.subcommand === "preset") {
     const result = await runApplyPreset([...context.rest]);
-    process25.stdout.write(`${result.json}
+    process28.stdout.write(`${result.json}
 `);
     return result.exitCode;
   }
-  process25.stderr.write(
+  process28.stderr.write(
     "Unknown add command. Try: vybekiit add page-recipe <id> | add preset <id> | add bridge\n"
   );
   return 1;
 };
 var COMMAND_HANDLERS = {
   setup: async () => await runSetup(),
+  "global-install": (context) => runGlobalInstall(commandArgs(context)),
   create: handleCreateCommand,
   new: (context) => runNew(commandArgs(context)),
   drop: (context) => runDrop(commandArgs(context)),
@@ -21421,96 +21973,96 @@ var COMMAND_HANDLERS = {
   "render-agent-layer": async () => (await runRenderAgentLayer()).exitCode,
   "check-goals": async (context) => {
     const result = await runCheckGoals([...context.rest]);
-    process25.stdout.write(`${result.json}
+    process28.stdout.write(`${result.json}
 `);
     return result.exitCode;
   },
   "check-agent-layer": async (context) => {
     const result = await runCheckAgentLayer([...context.rest]);
-    process25.stdout.write(`${result.json}
+    process28.stdout.write(`${result.json}
 `);
     return result.exitCode;
   },
   "plan-readiness": async (context) => {
     const result = await runPlanReadiness([...context.rest]);
-    process25.stdout.write(`${result.json}
+    process28.stdout.write(`${result.json}
 `);
     return result.exitCode;
   },
   "plan-setup": async (context) => {
     const result = await runPlanSetup([...context.rest]);
-    process25.stdout.write(`${result.output}
+    process28.stdout.write(`${result.output}
 `);
     return result.exitCode;
   },
   "plan-data-model": async (context) => {
     const result = await runPlanDataModel([...context.rest]);
-    process25.stdout.write(`${result.json}
+    process28.stdout.write(`${result.json}
 `);
     return result.exitCode;
   },
   "apply-preset": async (context) => {
     const result = await runApplyPreset(commandArgs(context));
-    process25.stdout.write(`${result.json}
+    process28.stdout.write(`${result.json}
 `);
     return result.exitCode;
   },
   "list-presets": () => {
     const result = runListPresets();
-    process25.stdout.write(`${result.json}
+    process28.stdout.write(`${result.json}
 `);
     return result.exitCode;
   },
   "list-pieces": async (context) => {
     const result = await runListPieces(commandArgs(context));
-    process25.stdout.write(`${result.json}
+    process28.stdout.write(`${result.json}
 `);
     return result.exitCode;
   },
   "list-page-recipes": async (context) => {
     const result = await runListPageRecipes(commandArgs(context));
-    process25.stdout.write(`${result.json}
+    process28.stdout.write(`${result.json}
 `);
     return result.exitCode;
   },
   "verify-presets": async (context) => {
     const result = await runVerifyPresets(commandArgs(context));
-    process25.stdout.write(`${result.json}
+    process28.stdout.write(`${result.json}
 `);
     return result.exitCode;
   },
   "lint-extension-skill": async (context) => {
     const result = await runLintExtensionSkill([...context.rest]);
-    process25.stdout.write(`${result.json}
+    process28.stdout.write(`${result.json}
 `);
     return result.exitCode;
   },
   "doc-fallback": (context) => {
     const result = runDocFallback([...context.rest]);
-    process25.stdout.write(`${result.json}
+    process28.stdout.write(`${result.json}
 `);
     return result.exitCode;
   },
   "live-work": async (context) => {
     if (context.subcommand === "data") {
       const result = await runLiveWorkData([...context.rest]);
-      process25.stdout.write(`${result.json}
+      process28.stdout.write(`${result.json}
 `);
       return result.exitCode;
     }
     if (context.subcommand === "host") {
       const result = await runLiveWorkHost([...context.rest]);
-      process25.stdout.write(`${result.json}
+      process28.stdout.write(`${result.json}
 `);
       return result.exitCode;
     }
     if (context.subcommand === "payments") {
       const result = await runLiveWorkPayments([...context.rest]);
-      process25.stdout.write(`${result.json}
+      process28.stdout.write(`${result.json}
 `);
       return result.exitCode;
     }
-    process25.stderr.write(
+    process28.stderr.write(
       "Usage: vybekiit live-work data|host|payments [--mode=demo|dogfood|buyer] [--vendor=\u2026] [--cwd=dir] [--no-pin] [--fresh]\n"
     );
     return 1;
@@ -21518,7 +22070,7 @@ var COMMAND_HANDLERS = {
   dedup: async (context) => {
     const result = await runDedup(commandArgs(context));
     if (result.output !== "") {
-      process25.stdout.write(result.output);
+      process28.stdout.write(result.output);
     }
     return result.exitCode;
   },
@@ -21526,11 +22078,11 @@ var COMMAND_HANDLERS = {
   env: handleEnvCommand,
   scaffold: async (context) => {
     if (context.subcommand !== "backend") {
-      process25.stderr.write("Unknown scaffold command. Try: vybekiit scaffold backend\n");
+      process28.stderr.write("Unknown scaffold command. Try: vybekiit scaffold backend\n");
       return 1;
     }
-    const result = await runScaffoldBackend([...context.rest], process25.cwd());
-    process25.stdout.write(`${result.message}
+    const result = await runScaffoldBackend([...context.rest], process28.cwd());
+    process28.stdout.write(`${result.message}
 `);
     return result.exitCode;
   },
@@ -21546,17 +22098,17 @@ var runCli = async (argv) => {
       }
       return await runMainMenuChoice(choice);
     }
-    process25.stdout.write(`${CLI_HELP}
+    process28.stdout.write(`${CLI_HELP}
 `);
     return 0;
   }
   if (context.command === "help" || context.command === "--help" || context.command === "-h") {
-    process25.stdout.write(`${wantsFullHelp(argv) ? CLI_HELP_ALL : CLI_HELP}
+    process28.stdout.write(`${wantsFullHelp(argv) ? CLI_HELP_ALL : CLI_HELP}
 `);
     return 0;
   }
   if (context.command === "--version" || context.command === "-v") {
-    process25.stdout.write(`${await readVersion()}
+    process28.stdout.write(`${await readVersion()}
 `);
     return 0;
   }
@@ -21565,7 +22117,7 @@ var runCli = async (argv) => {
   }
   const handler = COMMAND_HANDLERS[context.command];
   if (handler === void 0) {
-    process25.stderr.write(
+    process28.stderr.write(
       `Unknown command: ${context.command}
 Try: vybekiit   or   vybekiit --help
 `
@@ -21576,18 +22128,10 @@ Try: vybekiit   or   vybekiit --help
 };
 
 // src/bin.ts
-var runBinEntrypoint = async () => {
-  if (process26.argv[1] === void 0 || resolve13(process26.argv[1]) !== fileURLToPath8(import.meta.url)) {
-    return;
-  }
-  try {
-    const code = await runCli(process26.argv.slice(2));
-    process26.exit(code);
-  } catch {
-    process26.exit(1);
-  }
-};
-await runBinEntrypoint();
-export {
-  runBinEntrypoint
-};
+try {
+  process29.exit(await runCli(process29.argv.slice(2)));
+} catch (error) {
+  process29.stderr.write(`vybekiit: ${error instanceof Error ? error.message : String(error)}
+`);
+  process29.exit(1);
+}