@boxes-dev/dvb 1.0.49 → 1.0.50

package/dist/bin/dvb.cjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 "use strict";
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="119d7e63-fb65-5c6b-9057-03eebe3f0256")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="c7b28144-a37f-5cd7-b6e5-1af8e43047e8")}catch(e){}}();
 
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -24472,7 +24472,7 @@ var require_otlp_node_http_env_configuration = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.getNodeHttpConfigurationFromEnvironment = void 0;
-    var fs27 = require("fs");
+    var fs28 = require("fs");
     var path35 = require("path");
     var core_1 = require_src3();
     var api_1 = require_src();
@@ -24537,7 +24537,7 @@ var require_otlp_node_http_env_configuration = __commonJS({
       const filePath = signalSpecificPath ?? nonSignalSpecificPath;
       if (filePath != null) {
         try {
-          return fs27.readFileSync(path35.resolve(process.cwd(), filePath));
+          return fs28.readFileSync(path35.resolve(process.cwd(), filePath));
         } catch {
           api_1.diag.warn(warningMessage);
           return void 0;
@@ -36584,14 +36584,14 @@ var require_tls_helpers = __commonJS({
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.CIPHER_SUITES = void 0;
     exports2.getDefaultRootsData = getDefaultRootsData;
-    var fs27 = require("fs");
+    var fs28 = require("fs");
     exports2.CIPHER_SUITES = process.env.GRPC_SSL_CIPHER_SUITES;
     var DEFAULT_ROOTS_FILE_PATH = process.env.GRPC_DEFAULT_SSL_ROOTS_FILE_PATH;
     var defaultRootsData = null;
     function getDefaultRootsData() {
       if (DEFAULT_ROOTS_FILE_PATH) {
         if (defaultRootsData === null) {
-          defaultRootsData = fs27.readFileSync(DEFAULT_ROOTS_FILE_PATH);
+          defaultRootsData = fs28.readFileSync(DEFAULT_ROOTS_FILE_PATH);
         }
         return defaultRootsData;
       }
@@ -41602,7 +41602,7 @@ var require_fetch = __commonJS({
     module2.exports = fetch2;
     var asPromise = require_aspromise();
     var inquire2 = require_inquire();
-    var fs27 = inquire2("fs");
+    var fs28 = inquire2("fs");
     function fetch2(filename, options, callback) {
       if (typeof options === "function") {
         callback = options;
@@ -41611,8 +41611,8 @@ var require_fetch = __commonJS({
         options = {};
       if (!callback)
         return asPromise(fetch2, this, filename, options);
-      if (!options.xhr && fs27 && fs27.readFile)
-        return fs27.readFile(filename, function fetchReadFileCallback(err, contents) {
+      if (!options.xhr && fs28 && fs28.readFile)
+        return fs28.readFile(filename, function fetchReadFileCallback(err, contents) {
           return err && typeof XMLHttpRequest !== "undefined" ? fetch2.xhr(filename, options, callback) : err ? callback(err) : callback(null, options.binary ? contents : contents.toString("utf8"));
         });
       return fetch2.xhr(filename, options, callback);
@@ -47886,7 +47886,7 @@ var require_util4 = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.addCommonProtos = exports2.loadProtosWithOptionsSync = exports2.loadProtosWithOptions = void 0;
-    var fs27 = require("fs");
+    var fs28 = require("fs");
     var path35 = require("path");
     var Protobuf = require_protobufjs();
     function addIncludePathResolver(root, includePaths) {
@@ -47898,7 +47898,7 @@ var require_util4 = __commonJS({
         for (const directory of includePaths) {
           const fullPath = path35.join(directory, target);
           try {
-            fs27.accessSync(fullPath, fs27.constants.R_OK);
+            fs28.accessSync(fullPath, fs28.constants.R_OK);
             return fullPath;
           } catch (err) {
             continue;
@@ -57720,7 +57720,7 @@ var require_certificate_provider = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.FileWatcherCertificateProvider = void 0;
-    var fs27 = require("fs");
+    var fs28 = require("fs");
     var logging = require_logging();
     var constants_1 = require_constants9();
     var util_1 = require("util");
@@ -57728,7 +57728,7 @@ var require_certificate_provider = __commonJS({
     function trace15(text) {
       logging.trace(constants_1.LogVerbosity.DEBUG, TRACER_NAME, text);
     }
-    var readFilePromise = (0, util_1.promisify)(fs27.readFile);
+    var readFilePromise = (0, util_1.promisify)(fs28.readFile);
     var FileWatcherCertificateProvider = class {
       constructor(config3) {
         this.config = config3;
@@ -61052,7 +61052,7 @@ var require_otlp_grpc_env_configuration = __commonJS({
     var core_1 = require_src28();
     var grpc_exporter_transport_1 = require_grpc_exporter_transport();
     var node_http_1 = require_index_node_http();
-    var fs27 = require("fs");
+    var fs28 = require("fs");
     var path35 = require("path");
     var api_1 = require_src();
     function fallbackIfNullishOrBlank(signalSpecific, nonSignalSpecific) {
@@ -61102,7 +61102,7 @@ var require_otlp_grpc_env_configuration = __commonJS({
       const filePath = fallbackIfNullishOrBlank(signalSpecificPath, nonSignalSpecificPath);
       if (filePath != null) {
         try {
-          return fs27.readFileSync(path35.resolve(process.cwd(), filePath));
+          return fs28.readFileSync(path35.resolve(process.cwd(), filePath));
         } catch {
           api_1.diag.warn(warningMessage);
           return void 0;
@@ -79470,14 +79470,14 @@ var require_parser = __commonJS({
             case "scalar":
             case "single-quoted-scalar":
             case "double-quoted-scalar": {
-              const fs27 = this.flowScalar(this.type);
+              const fs28 = this.flowScalar(this.type);
               if (atNextItem || it2.value) {
-                map.items.push({ start, key: fs27, sep: [] });
+                map.items.push({ start, key: fs28, sep: [] });
                 this.onKeyLine = true;
               } else if (it2.sep) {
-                this.stack.push(fs27);
+                this.stack.push(fs28);
               } else {
-                Object.assign(it2, { key: fs27, sep: [] });
+                Object.assign(it2, { key: fs28, sep: [] });
                 this.onKeyLine = true;
               }
               return;
@@ -79605,13 +79605,13 @@ var require_parser = __commonJS({
             case "scalar":
             case "single-quoted-scalar":
             case "double-quoted-scalar": {
-              const fs27 = this.flowScalar(this.type);
+              const fs28 = this.flowScalar(this.type);
               if (!it2 || it2.value)
-                fc.items.push({ start: [], key: fs27, sep: [] });
+                fc.items.push({ start: [], key: fs28, sep: [] });
               else if (it2.sep)
-                this.stack.push(fs27);
+                this.stack.push(fs28);
               else
-                Object.assign(it2, { key: fs27, sep: [] });
+                Object.assign(it2, { key: fs28, sep: [] });
               return;
             }
             case "flow-map-end":
@@ -79927,7 +79927,7 @@ var require_FileConfigFactory = __commonJS({
     exports2.setLoggerProvider = exports2.getSeverity = exports2.setMeterProvider = exports2.getTemporalityPreference = exports2.setTracerProvider = exports2.setPropagator = exports2.setAttributeLimits = exports2.setResourceAttributes = exports2.parseConfigFile = exports2.hasValidConfigFile = exports2.FileConfigFactory = void 0;
     var core_1 = require_src46();
     var configModel_1 = require_configModel();
-    var fs27 = require("fs");
+    var fs28 = require("fs");
     var yaml = require_dist();
     var utils_1 = require_utils27();
     var commonModel_1 = require_commonModel();
@@ -79949,7 +79949,7 @@ var require_FileConfigFactory = __commonJS({
     function hasValidConfigFile() {
       const configFile = (0, core_1.getStringFromEnv)("OTEL_EXPERIMENTAL_CONFIG_FILE");
       if (configFile) {
-        if (!(configFile.endsWith(".yaml") || configFile.endsWith(".yml")) || !fs27.existsSync(configFile)) {
+        if (!(configFile.endsWith(".yaml") || configFile.endsWith(".yml")) || !fs28.existsSync(configFile)) {
           api_1.diag.warn(`Config file ${configFile} set on OTEL_EXPERIMENTAL_CONFIG_FILE is not valid`);
           return false;
         }
@@ -79961,7 +79961,7 @@ var require_FileConfigFactory = __commonJS({
     function parseConfigFile(config3) {
       const supportedFileVersions = ["1.0-rc.3"];
       const configFile = (0, core_1.getStringFromEnv)("OTEL_EXPERIMENTAL_CONFIG_FILE") || "";
-      const file = fs27.readFileSync(configFile, "utf8");
+      const file = fs28.readFileSync(configFile, "utf8");
       const parsedContent = yaml.parse(file);
       if (parsedContent["file_format"] && supportedFileVersions.includes(parsedContent["file_format"])) {
         const disabled = (0, utils_1.getBooleanFromConfigFile)(parsedContent["disabled"]);
@@ -88619,8 +88619,8 @@ var init_otel = __esm({
       return trimmed && trimmed.length > 0 ? trimmed : void 0;
     };
     readBuildMetadata = () => {
-      const rawPackageVersion = "1.0.49";
-      const rawGitSha = "615e9d2c43abe0a91a2960d339e48e6dab03d070";
+      const rawPackageVersion = "1.0.50";
+      const rawGitSha = "2775fab43ab9e55ae518a9d8665bec8c7a1a7b67";
       const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
       const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
       return { packageVersion, gitSha };
@@ -120608,9 +120608,9 @@ var init_sentry = __esm({
     sentryEnabled = false;
     uncaughtExceptionMonitorInstalled = false;
     readBuildMetadata2 = () => {
-      const rawPackageVersion = "1.0.49";
-      const rawGitSha = "615e9d2c43abe0a91a2960d339e48e6dab03d070";
-      const rawSentryRelease = "boxes-dev-dvb@1.0.49+615e9d2c43abe0a91a2960d339e48e6dab03d070";
+      const rawPackageVersion = "1.0.50";
+      const rawGitSha = "2775fab43ab9e55ae518a9d8665bec8c7a1a7b67";
+      const rawSentryRelease = "boxes-dev-dvb@1.0.50+2775fab43ab9e55ae518a9d8665bec8c7a1a7b67";
       const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
       const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
       const sentryRelease = typeof rawSentryRelease === "string" ? rawSentryRelease : void 0;
@@ -127602,7 +127602,7 @@ var init_simple_client_node = __esm({
     });
     require_node_gyp_build = __commonJS2({
       "../common/temp/node_modules/.pnpm/node-gyp-build@4.8.4/node_modules/node-gyp-build/node-gyp-build.js"(exports2, module2) {
-        var fs27 = __require("fs");
+        var fs28 = __require("fs");
         var path35 = __require("path");
         var os20 = __require("os");
         var runtimeRequire = typeof __webpack_require__ === "function" ? __non_webpack_require__ : __require;
@@ -127663,7 +127663,7 @@ var init_simple_client_node = __esm({
         };
         function readdirSync(dir) {
           try {
-            return fs27.readdirSync(dir);
+            return fs28.readdirSync(dir);
           } catch (err) {
             return [];
           }
@@ -127757,7 +127757,7 @@ var init_simple_client_node = __esm({
           return typeof window !== "undefined" && window.process && window.process.type === "renderer";
         }
         function isAlpine(platform22) {
-          return platform22 === "linux" && fs27.existsSync("/etc/alpine-release");
+          return platform22 === "linux" && fs28.existsSync("/etc/alpine-release");
         }
         load2.parseTags = parseTags;
         load2.matchTags = matchTags;
@@ -144289,7 +144289,7 @@ ${canonicalBlock}
       const reportPhase = (completedPhases, detail) => {
         onPhase?.(completedPhases, totalPhases, detail);
       };
-      reportPhase(0, "fixing ownership and permissions");
+      reportPhase(0, "fix ownership/permissions");
       const permissionsScript = [
         "set -euo pipefail",
         "if [ -d /home/sprite ]; then",
@@ -144316,7 +144316,7 @@ ${canonicalBlock}
           details ? `devbox bootstrap failed: ${details}` : `devbox bootstrap failed (exit ${permsResult.exitCode})`
         );
       }
-      reportPhase(1, "setting IPv4 localhost preference");
+      reportPhase(1, "prefer IPv4 localhost");
       const ipv4PreferenceScript = [
         "set -euo pipefail",
         'if ! sudo -n grep -q "ipv4first" /etc/gai.conf 2>/dev/null; then',
@@ -145008,9 +145008,9 @@ chmod 755 ${WEZTERM_MUX_RUNNER_PATH}`,
       const reportPhase = (completedPhases, detail) => {
         onPhase?.(completedPhases, totalPhases, detail);
       };
-      reportPhase(0, "downloading daemon package");
+      reportPhase(0, "download package");
       const { buffer } = await fetchDaemonBinary(release2, onDownloadProgress);
-      reportPhase(1, "uploading daemon package");
+      reportPhase(1, "upload package");
       if (onUploadProgress) {
         await client.writeFile(spriteName, DAEMON_TARBALL, buffer, {
           onProgress: onUploadProgress
@@ -145018,13 +145018,13 @@ chmod 755 ${WEZTERM_MUX_RUNNER_PATH}`,
       } else {
         await client.writeFile(spriteName, DAEMON_TARBALL, buffer);
       }
-      reportPhase(2, "uploading daemon config");
+      reportPhase(2, "upload config");
       await client.writeFile(
         spriteName,
         DAEMON_CONFIG_FILE,
         Buffer.from(buildDaemonConfig(convexUrl, heartbeatToken))
       );
-      reportPhase(3, "installing daemon on sprite");
+      reportPhase(3, "install daemon");
       const result = await client.exec(
         spriteName,
         [
@@ -145056,7 +145056,7 @@ chmod 755 ${WEZTERM_MUX_RUNNER_PATH}`,
       if (result.exitCode !== 0) {
         throw new Error(result.stderr || result.stdout || "Daemon install failed.");
       }
-      reportPhase(4, "ensuring daemon service");
+      reportPhase(4, "ensure daemon service");
       await ensureSpriteDaemonService({ client, spriteName });
       reportPhase(5, "completed");
     };
@@ -146475,7 +146475,7 @@ ${bottom}
 });
 
 // src/devbox/commands/init/codex/local.ts
-var import_node_child_process9, import_node_fs8, import_promises21, import_node_os10, import_node_path23, stripAnsi3, extractBoldText2, normalizeProgressMessage, toRecord, extractProgressFromJsonLine, extractThreadIdFromJsonLine, buildRetryPrompt, runCodexExec, runLocalSetupEnvSecretsScan, runLocalSetupExternalScan, runLocalSetupExtraArtifactsScan, runLocalServicesScan, toPosixPath, toRepoRelativePath, countSecretVars, buildEnvFileHint, buildExternalDependencyLabel, promptForPlanApproval, promptForServicesApproval;
+var import_node_child_process9, import_node_fs8, import_promises21, import_node_os10, import_node_path23, stripAnsi3, extractBoldText2, normalizeProgressMessage, toRecord, extractProgressFromJsonLine, extractThreadIdFromJsonLine, isRelayUsageLimitExceeded, buildRetryPrompt, runCodexExec, runLocalSetupEnvSecretsScan, runLocalSetupExternalScan, runLocalSetupExtraArtifactsScan, runLocalServicesScan, toPosixPath, toRepoRelativePath, countSecretVars, buildEnvFileHint, buildExternalDependencyLabel, promptForPlanApproval, promptForServicesApproval;
 var init_local = __esm({
   "src/devbox/commands/init/codex/local.ts"() {
     "use strict";
@@ -146542,6 +146542,7 @@ var init_local = __esm({
       const threadId2 = record.thread_id;
       return typeof threadId2 === "string" && threadId2.length > 0 ? threadId2 : null;
     };
+    isRelayUsageLimitExceeded = (value) => /usage limit exceeded/i.test(value) && /(?:relay\.boxes\.dev\/v1\/responses|\/v1\/responses)/i.test(value);
     buildRetryPrompt = (basePrompt, retryFeedback) => retryFeedback ? [
       basePrompt,
       "",
@@ -146683,6 +146684,15 @@ var init_local = __esm({
               return;
             }
             const detail = stderr.trim() || stdout.trim();
+            if (isRelayUsageLimitExceeded(`${stderr}
+${stdout}`)) {
+              reject(
+                new Error(
+                  "Codex scan failed: OpenAI usage limit exceeded. Run `dvb setup --codex-auth byo` to use your own Codex auth, then retry with `dvb init --resume`."
+                )
+              );
+              return;
+            }
             const suffix = detail ? `: ${detail}` : "";
             reject(
               new Error(`codex exec failed (exit ${code2 ?? "unknown"})${suffix}`)
@@ -147436,7 +147446,7 @@ var init_artifacts = __esm({
 });
 
 // src/devbox/commands/init/progress.ts
-var noopStatus, CLACK_PROGRESS_SIZE, formatBytes, normalizeByteProgress, normalizePhaseProgress, runInitStep;
+var noopStatus, CLACK_PROGRESS_SIZE, INIT_PROGRESS_MAX_TEXT, INIT_PROGRESS_MIN_TEXT, INIT_PROGRESS_LINE_PADDING, getProgressTextLimit, fitProgressText, formatBytes, normalizeByteProgress, normalizePhaseProgress, runInitStep;
 var init_progress = __esm({
   "src/devbox/commands/init/progress.ts"() {
     "use strict";
@@ -147452,6 +147462,27 @@ var init_progress = __esm({
       }
     };
     CLACK_PROGRESS_SIZE = 24;
+    INIT_PROGRESS_MAX_TEXT = 64;
+    INIT_PROGRESS_MIN_TEXT = 24;
+    INIT_PROGRESS_LINE_PADDING = CLACK_PROGRESS_SIZE + 6;
+    getProgressTextLimit = () => {
+      const columns = process.stdout.columns ?? 0;
+      if (!Number.isFinite(columns) || columns <= 0) {
+        return INIT_PROGRESS_MAX_TEXT;
+      }
+      const widthBound = Math.max(
+        INIT_PROGRESS_MIN_TEXT,
+        columns - INIT_PROGRESS_LINE_PADDING
+      );
+      return Math.min(INIT_PROGRESS_MAX_TEXT, widthBound);
+    };
+    fitProgressText = (value) => {
+      const normalized = value.replace(/\s+/g, " ").trim();
+      const limit = getProgressTextLimit();
+      if (normalized.length <= limit) return normalized;
+      if (limit <= 3) return normalized.slice(0, limit);
+      return `${normalized.slice(0, limit - 3).trimEnd()}...`;
+    };
     formatBytes = (value) => {
       if (!Number.isFinite(value) || value <= 0) return "0 B";
       const units = ["B", "KB", "MB", "GB", "TB"];
@@ -147525,14 +147556,15 @@ var init_progress = __esm({
         activeProgress = null;
       };
       const ensureSpinnerRunning = (text) => {
+        const formatted = fitProgressText(text);
         if (activeMode === "spinner") {
-          sp.message(text);
+          sp.message(formatted);
           return;
         }
         if (activeMode === "progress") {
           clearActiveProgress();
         }
-        sp.start(text);
+        sp.start(formatted);
         activeMode = "spinner";
       };
       const updateClackProgress = ({
@@ -147542,14 +147574,15 @@ var init_progress = __esm({
         value,
         message
       }) => {
+        const formattedMessage = fitProgressText(message);
         const currentProgress = activeMode === "progress" ? activeProgress : null;
         const canReuse = currentProgress && currentProgress.kind === kind && currentProgress.title === progressTitle && currentProgress.max === max && value >= currentProgress.value;
         if (canReuse && currentProgress) {
           const delta = value - currentProgress.value;
           if (delta > 0) {
-            currentProgress.bar.advance(delta, message);
+            currentProgress.bar.advance(delta, formattedMessage);
           } else {
-            currentProgress.bar.message(message);
+            currentProgress.bar.message(formattedMessage);
           }
           currentProgress.value = value;
           return;
@@ -147560,7 +147593,7 @@ var init_progress = __esm({
           clearActiveProgress();
         }
         const bar = Kt({ max, size: CLACK_PROGRESS_SIZE });
-        bar.start(message);
+        bar.start(formattedMessage);
         activeMode = "progress";
         activeProgress = {
           kind,
@@ -147570,7 +147603,7 @@ var init_progress = __esm({
           bar
         };
         if (value > 0) {
-          bar.advance(value, message);
+          bar.advance(value, formattedMessage);
           activeProgress.value = value;
         }
       };
@@ -147598,12 +147631,13 @@ var init_progress = __esm({
       const ok = (message) => {
         if (finalized) return;
         const finalText = message ?? finalSuccess;
+        const formatted = fitProgressText(finalText);
         if (activeMode === "progress" && activeProgress) {
-          activeProgress.bar.stop(finalText);
+          activeProgress.bar.stop(formatted);
           activeProgress = null;
         } else {
-          ensureSpinnerRunning(finalText);
-          sp.stop(finalText);
+          ensureSpinnerRunning(formatted);
+          sp.stop(formatted);
         }
         activeMode = "none";
         finalized = true;
@@ -147611,12 +147645,13 @@ var init_progress = __esm({
       const fail = (message) => {
         if (finalized) return;
         const finalText = message ?? title;
+        const formatted = fitProgressText(finalText);
         if (activeMode === "progress" && activeProgress) {
-          activeProgress.bar.error(finalText);
+          activeProgress.bar.error(formatted);
           activeProgress = null;
         } else {
-          ensureSpinnerRunning(finalText);
-          sp.error(finalText);
+          ensureSpinnerRunning(formatted);
+          sp.error(formatted);
         }
         activeMode = "none";
         finalized = true;
@@ -147674,7 +147709,7 @@ var init_codex = __esm({
     }) => {
       const authBytes = await readLocalCodexAuthCache();
       if (!authBytes) return false;
-      status.stage("Syncing local Codex auth cache");
+      status.stage("Syncing Codex auth cache");
       const remoteAuthPath = "/home/sprite/.codex/auth.json";
       const ensureDir2 = await client.exec(spriteAlias, [
         "/bin/bash",
@@ -147727,7 +147762,7 @@ var init_codex = __esm({
       remoteArtifactsPartsDescriptorPath,
       status
     }) => {
-      status.stage("Preparing setup upload");
+      status.stage("Preparing setup files");
       const setupDirResult = await client.exec(spriteAlias, [
         "/bin/bash",
         "--noprofile",
@@ -147787,7 +147822,7 @@ var init_codex = __esm({
             expectedBundleSha: descriptor.bundleSha256,
             parts
           };
-          status.stage("Preparing split setup artifacts upload");
+          status.stage("Prep split artifact upload");
           const cleanupScript = [
             "set -euo pipefail",
             `bundle=${shellQuote3(remoteArtifactsBundlePath)}`,
@@ -147817,19 +147852,19 @@ var init_codex = __esm({
           }
           uploadItems.push(
             {
-              label: `setup artifacts manifest (${import_node_path25.default.basename(localArtifactsManifestPath)})`,
+              label: `artifacts manifest (${import_node_path25.default.basename(localArtifactsManifestPath)})`,
               localPath: localArtifactsManifestPath,
               remotePath: remoteArtifactsManifestPath
             },
             {
-              label: `setup artifacts parts descriptor (${import_node_path25.default.basename(localArtifactsPartsDescriptorPath)})`,
+              label: `artifacts parts (${import_node_path25.default.basename(localArtifactsPartsDescriptorPath)})`,
               localPath: localArtifactsPartsDescriptorPath,
               remotePath: remoteArtifactsPartsDescriptorPath
             }
           );
           for (const part of parts) {
             uploadItems.push({
-              label: `setup artifacts part ${part.index + 1}/${parts.length}`,
+              label: `artifacts part ${part.index + 1}/${parts.length}`,
               localPath: part.localPath,
               remotePath: part.remotePath
             });
@@ -147837,12 +147872,12 @@ var init_codex = __esm({
         } else {
           uploadItems.push(
             {
-              label: "setup artifacts bundle",
+              label: "artifacts bundle",
               localPath: localArtifactsBundlePath,
               remotePath: remoteArtifactsBundlePath
             },
             {
-              label: `setup artifacts manifest (${import_node_path25.default.basename(localArtifactsManifestPath)})`,
+              label: `artifacts manifest (${import_node_path25.default.basename(localArtifactsManifestPath)})`,
               localPath: localArtifactsManifestPath,
               remotePath: remoteArtifactsManifestPath
             }
@@ -147880,7 +147915,7 @@ var init_codex = __esm({
         updateProgress(fileData.length, detail);
       }
       if (splitArtifacts && remoteArtifactsBundlePath) {
-        status.stage("Assembling setup artifacts on remote");
+        status.stage("Assembling artifacts on remote");
         const assembledTmpPath = `${remoteArtifactsBundlePath}.tmp-assemble-${(0, import_node_crypto11.randomUUID)()}`;
         const assembleScript = [
           "set -euo pipefail",
@@ -147965,7 +148000,7 @@ var init_codex = __esm({
       emitCodexOutput = true
     }) => {
       if (!proxyOptions) {
-        status.stage("Checking Codex login");
+        status.stage("Check Codex login");
         let loggedIn = await isRemoteCodexLoggedIn(client, spriteAlias);
         if (!loggedIn) {
           const synced = await syncLocalCodexAuthCacheToSprite({
@@ -148063,7 +148098,7 @@ codex login`
           if (portReloadError) {
             throw portReloadError;
           }
-          status.stage("Checking Codex login");
+          status.stage("Check Codex login");
           const loggedInAfter = await isRemoteCodexLoggedIn(client, spriteAlias);
           if (!loggedInAfter) {
             throw new Error(
@@ -148075,7 +148110,7 @@ codex login`
           }
         }
       }
-      status.stage("Applying setup plan");
+      status.stage("Apply setup plan");
       const remotePrompt = await renderRemoteApplyPrompt({
         setupPath: remoteSetupPath,
         artifactsBundle: remoteArtifactsBundlePath,
@@ -148088,7 +148123,7 @@ codex login`
       const proxyCodexHome = proxyRoot ? `${proxyRoot}/codex-home` : null;
       const proxyConfigPath = proxyCodexHome ? `${proxyCodexHome}/config.toml` : null;
       if (proxyOptions && proxyRoot && proxyTokenPath && proxyConfigPath) {
-        status.stage("Preparing Codex proxy context");
+        status.stage("Preparing Codex proxy");
         const codexHomePath = proxyCodexHome ?? `${proxyRoot}/codex-home`;
         try {
           const prepResult = await client.exec(spriteAlias, [
@@ -148200,8 +148235,8 @@ codex login`
             remoteCodexCommand
           ],
           onProgress: (message) => {
-            const base = "Applying setup plan";
-            status.stage(`${base} \u2014 ${message}`);
+            const base = "Apply setup plan";
+            status.stage(`${base} - ${message}`);
           }
         });
       } finally {
@@ -148761,7 +148796,7 @@ var init_setupPlanFlow = __esm({
             });
           } else {
             const log3 = zt({
-              title: "Analyzing local environment",
+              title: "Analyzing local env",
               limit: 1,
               spacing: 0
             });
@@ -148812,10 +148847,10 @@ var init_setupPlanFlow = __esm({
                 updateServices
               });
               active = false;
-              log3.success("Analyzing local environment");
+              log3.success("Analyzing local env");
             } catch (error2) {
               active = false;
-              log3.error("Analyzing local environment");
+              log3.error("Analyzing local env");
               throw error2;
             }
           }
@@ -148915,13 +148950,13 @@ var init_setupPlanFlow = __esm({
                     envSecretsMissing
                   ),
                   ...initCodexProxyOptions ? { proxyOptions: initCodexProxyOptions } : {},
-                  onProgress: (message) => status.stage(`Regenerating env/secrets scan - ${message}`)
+                  onProgress: (message) => status.stage(`Rescan env/secrets - ${message}`)
                 });
                 saveScanThreadId("envSecretsThreadId", threadId2);
               },
               read: async () => await readSetupEnvSecretsPlan(setupEnvSecretsScanPath),
               outputPath: setupEnvSecretsScanPath,
-              update: (message) => status.stage(`Regenerating env/secrets scan - ${message}`),
+              update: (message) => status.stage(`Rescan env/secrets - ${message}`),
               shouldRetry: (scan) => shouldRetryCodexScan(
                 scan.scanFullyCompleted,
                 scan.envFiles,
@@ -148959,13 +148994,13 @@ var init_setupPlanFlow = __esm({
                     externalMissing
                   ),
                   ...initCodexProxyOptions ? { proxyOptions: initCodexProxyOptions } : {},
-                  onProgress: (message) => status.stage(`Regenerating external scan - ${message}`)
+                  onProgress: (message) => status.stage(`Rescan external - ${message}`)
                 });
                 saveScanThreadId("externalThreadId", threadId2);
               },
               read: async () => await readSetupExternalPlan(setupExternalScanPath),
               outputPath: setupExternalScanPath,
-              update: (message) => status.stage(`Regenerating external scan - ${message}`),
+              update: (message) => status.stage(`Rescan external - ${message}`),
               shouldRetry: (scan) => shouldRetryCodexScan(
                 scan.scanFullyCompleted,
                 scan.externalDependencies,
@@ -148998,13 +149033,13 @@ var init_setupPlanFlow = __esm({
                     extraArtifactsMissing
                   ),
                   ...initCodexProxyOptions ? { proxyOptions: initCodexProxyOptions } : {},
-                  onProgress: (message) => status.stage(`Regenerating extra artifacts scan - ${message}`)
+                  onProgress: (message) => status.stage(`Rescan extra artifacts - ${message}`)
                 });
                 saveScanThreadId("extraArtifactsThreadId", threadId2);
               },
               read: async () => await readSetupExtraArtifactsPlan(setupExtraArtifactsScanPath),
               outputPath: setupExtraArtifactsScanPath,
-              update: (message) => status.stage(`Regenerating extra artifacts scan - ${message}`),
+              update: (message) => status.stage(`Rescan extra artifacts - ${message}`),
               shouldRetry: (scan) => shouldRetryCodexScan(scan.scanFullyCompleted, scan.extraArtifacts)
             });
             nextPlan = {
@@ -149230,7 +149265,7 @@ var init_setupPlanFlow = __esm({
                   ...needsExtraArtifacts ? ["extra artifacts"] : []
                 ];
                 status.stage(
-                  `Found ${missingArtifacts.length} missing setup artifact path(s); regenerating ${scanLabels.join(", ")} scan(s) (${attempt}/${SETUP_ARTIFACT_REGEN_MAX_ATTEMPTS})`
+                  `Missing setup paths; rescan ${scanLabels.join(", ")} (${attempt}/${SETUP_ARTIFACT_REGEN_MAX_ATTEMPTS})`
                 );
                 planForArtifacts = await regenerateSetupPlanForMissingArtifacts({
                   plan: planForArtifacts,
@@ -149497,7 +149532,7 @@ var init_provisionFlow = __esm({
           });
           await runInitStep({
             enabled: progressEnabled,
-            title: "Preparing remote directories",
+            title: "Preparing remote dirs",
             fn: async ({ status }) => {
               status.stage("Checking remote git");
               const gitCheck = await client.exec(spriteAlias, [
@@ -149521,7 +149556,7 @@ var init_provisionFlow = __esm({
                 remoteDirs.add(import_node_path29.default.posix.dirname(mapping.dest));
               }
               if (remoteDirs.size > 0) {
-                status.stage("Preparing remote directories");
+                status.stage("Preparing remote dirs");
                 const prepResult = await client.exec(spriteAlias, [
                   "/bin/bash",
                   "-lc",
@@ -151089,7 +151124,7 @@ var init_finalizeFlow = __esm({
       }
       const owner = checkResult.stdout.trim();
       if (!owner || owner === "sprite") return;
-      status.stage("Fixing workdir ownership");
+      status.stage("Fixing workdir owner");
       const chownResult = await client.exec(spriteAlias, [
         "/bin/bash",
         "-lc",
@@ -151108,7 +151143,7 @@ var init_finalizeFlow = __esm({
       workdir,
       status
     }) => {
-      status.stage("Configuring git safe.directory");
+      status.stage("Configuring git safe dir");
       logger7.info("init_git_safe_directory_configure_start", {
         box: spriteAlias,
         workdir
@@ -151212,11 +151247,11 @@ var init_finalizeFlow = __esm({
       const expandedWorkdir = expandHome2(workdir);
       await runInitStep({
         enabled: progressEnabled,
-        title: "Ensuring workdir ownership",
+        title: "Ensuring workdir owner",
         fn: async ({ status }) => {
           await retryInitStep2({
             status,
-            title: "Ensuring workdir ownership",
+            title: "Ensuring workdir owner",
             fn: async () => await ensureWorkdirOwnership({
               client,
               spriteAlias,
@@ -151232,7 +151267,7 @@ var init_finalizeFlow = __esm({
       if (!skipGitSafeDirectory) {
         await runInitStep({
           enabled: progressEnabled,
-          title: "Configuring git safe.directory",
+          title: "Configuring git safe dir",
           fn: async ({ status }) => {
             await ensureGitSafeDirectory({
               client,
@@ -151252,7 +151287,7 @@ var init_finalizeFlow = __esm({
       if (!skipSshAuth) {
         const { remoteOrigin, remoteInfo } = await runInitStep({
           enabled: progressEnabled,
-          title: "Checking git remote for SSH auth",
+          title: "Checking git SSH remote",
           fn: async () => {
             const remoteOrigin2 = await readRemoteOrigin(
               client,
@@ -151318,7 +151353,7 @@ var init_finalizeFlow = __esm({
             } else {
               await runInitStep({
                 enabled: progressEnabled,
-                title: "Updating remote devbox checkout to SSH git remote",
+                title: "Switching remote git to SSH",
                 fn: async () => {
                   await setRemoteOrigin(
                     client,
@@ -151410,7 +151445,7 @@ var init_finalizeFlow = __esm({
       if (!skipServicesConfig) {
         await runInitStep({
           enabled: progressEnabled,
-          title: "Writing devbox.toml services",
+          title: "Writing services config",
           fn: async () => {
             await writeRemoteServicesToml({
               client,
@@ -151478,7 +151513,7 @@ var init_finalizeFlow = __esm({
           enabled: progressEnabled,
           title: "Staging setup artifacts",
           fn: async ({ status }) => {
-            status.stage("Copying repo artifacts and staging external files");
+            status.stage("Staging repo + external artifacts");
             await stageRemoteSetupArtifacts({
               client,
               spriteAlias,
@@ -151493,12 +151528,12 @@ var init_finalizeFlow = __esm({
       if (!skipCodexApply) {
         await runInitStep({
           enabled: progressEnabled,
-          title: "Snapshotting filesystem (pre-setup)",
+          title: "Snapshot FS (pre-setup)",
           fn: async ({ status, fail, ok }) => {
             try {
               const checkpoint = await retryInitStep2({
                 status,
-                title: "Snapshotting filesystem (pre-setup)",
+                title: "Snapshot FS (pre-setup)",
                 fn: async () => await recordCodexCheckpoint({
                   client,
                   canonical,
@@ -151516,7 +151551,7 @@ var init_finalizeFlow = __esm({
                 phase: "pre-codex-setup",
                 error: error2 instanceof Error ? error2.message : String(error2)
               });
-              fail("Snapshotting filesystem (pre-setup) (failed)");
+              fail("Snapshot FS (pre-setup) (failed)");
               throw error2;
             }
           }
@@ -151524,7 +151559,7 @@ var init_finalizeFlow = __esm({
         if (!skipServicesEnable) {
           await runInitStep({
             enabled: progressEnabled,
-            title: "Enabling devbox services",
+            title: "Enabling services",
             fn: async ({ status }) => {
               await enableRemoteServices({
                 client,
@@ -151562,12 +151597,12 @@ var init_finalizeFlow = __esm({
         );
         await runInitStep({
           enabled: progressEnabled,
-          title: "Snapshotting filesystem (post-setup)",
+          title: "Snapshot FS (post-setup)",
           fn: async ({ status, fail, ok }) => {
             try {
               const checkpoint = await retryInitStep2({
                 status,
-                title: "Snapshotting filesystem (post-setup)",
+                title: "Snapshot FS (post-setup)",
                 fn: async () => await recordCodexCheckpoint({
                   client,
                   canonical,
@@ -151585,7 +151620,7 @@ var init_finalizeFlow = __esm({
                 phase: "post-codex-setup",
                 error: error2 instanceof Error ? error2.message : String(error2)
               });
-              fail("Snapshotting filesystem (post-setup) (failed)");
+              fail("Snapshot FS (post-setup) (failed)");
               throw error2;
             }
           }
@@ -151657,6 +151692,7 @@ var init_init = __esm({
     init_repo2();
     init_remote();
     init_ensureMux();
+    init_installOptions();
     init_registry2();
     init_state();
     init_mountSsh();
@@ -152040,7 +152076,7 @@ var init_init = __esm({
           }
           await runInitStep({
             enabled: progressEnabled,
-            title: "Destroying existing devbox (--force)",
+            title: "Destroying devbox (--force)",
             fn: async ({ status }) => {
               logger7.info("init_force_destroy_start", {
                 box: forceCanonical,
@@ -152066,7 +152102,7 @@ var init_init = __esm({
                 if (!confirmedDestroy) {
                   throw new Error("Force init canceled.");
                 }
-                status.stage("Destroying existing devbox (--force)");
+                status.stage("Destroying devbox (--force)");
               }
               if (spriteExists) {
                 logger7.info("init_force_destroy_confirmed", {
@@ -152163,7 +152199,7 @@ var init_init = __esm({
                 } else {
                   const suffix = fingerprint.slice(0, 6);
                   nextCanonical = `${nextCanonical}-${suffix}`;
-                  status.stage("Resolving devbox name");
+                  status.stage("Resolving name");
                   const second = await createSprite(nextCanonical);
                   if (second.kind === "exists") {
                     throw new Error(`Sprite already exists: ${nextCanonical}`);
@@ -152291,7 +152327,7 @@ var init_init = __esm({
                 if (!release2) {
                   throw new Error("No sprite daemon release available.");
                 }
-                status.stage("Issuing daemon heartbeat token");
+                status.stage("Issuing daemon token");
                 const heartbeatToken = await issueSpriteDaemonToken(
                   controlPlaneToken,
                   alias
@@ -152313,7 +152349,7 @@ var init_init = __esm({
                         title: "Installing sprite daemon",
                         uploadedBytes: downloadedBytes,
                         totalBytes,
-                        detail: "downloading daemon package"
+                        detail: "downloading package"
                       });
                     },
                     onUploadProgress: (uploadedBytes, totalBytes) => {
@@ -152321,7 +152357,7 @@ var init_init = __esm({
                         title: "Installing sprite daemon",
                         uploadedBytes,
                         totalBytes,
-                        detail: "uploading daemon package"
+                        detail: "uploading package"
                       });
                     },
                     onPhase: (completedPhases, totalPhases, detail) => {
@@ -152348,12 +152384,12 @@ var init_init = __esm({
         }
         await runInitStep({
           enabled: progressEnabled,
-          title: "Ensuring sprite daemon service",
+          title: "Ensuring daemon service",
           fn: async ({ status, fail }) => {
             try {
               await retryInitStep({
                 status,
-                title: "Ensuring sprite daemon service",
+                title: "Ensuring daemon service",
                 fn: async () => await ensureSpriteDaemonService({
                   client,
                   spriteName: alias
@@ -152365,7 +152401,7 @@ var init_init = __esm({
                 box: canonical,
                 error: String(error2)
               });
-              fail("Ensuring sprite daemon service (failed)");
+              fail("Ensuring daemon service (failed)");
               throw error2;
             }
           }
@@ -152374,12 +152410,12 @@ var init_init = __esm({
         if (!skipSshdConfig) {
           await runInitStep({
             enabled: progressEnabled,
-            title: "Configuring SSH mount access",
+            title: "SSH mount setup",
             fn: async ({ status, fail }) => {
               const totalPhases = 5;
               const setPhase = (completedPhases, detail) => {
                 status.phaseProgress({
-                  title: "Configuring SSH mount access",
+                  title: "SSH mount setup",
                   completedPhases,
                   totalPhases,
                   detail
@@ -152388,17 +152424,17 @@ var init_init = __esm({
               try {
                 await retryInitStep({
                   status,
-                  title: "Configuring SSH mount access",
+                  title: "SSH mount setup",
                   fn: async () => {
-                    setPhase(0, "ensuring local mount key (1/5)");
+                    setPhase(0, "ensure mount key");
                     await ensureLocalMountKey();
-                    setPhase(1, "ensuring known_hosts file (2/5)");
+                    setPhase(1, "ensure known_hosts");
                     await ensureKnownHostsFile();
-                    setPhase(2, "reading mount public key (3/5)");
+                    setPhase(2, "read mount key");
                     const publicKey = await readLocalMountPublicKey();
-                    setPhase(3, "bootstrapping remote sshd access (4/5)");
+                    setPhase(3, "bootstrap sshd");
                     await ensureRemoteMountAccess(client, alias, publicKey);
-                    setPhase(4, "ensuring sshd service (5/5)");
+                    setPhase(4, "ensure sshd service");
                     await ensureSshdService(client, alias);
                     setPhase(5, "completed");
                   }
@@ -152409,27 +152445,38 @@ var init_init = __esm({
                   box: canonical,
                   error: String(error2)
                 });
-                fail("Configuring SSH mount access (failed)");
+                fail("SSH mount setup (failed)");
                 throw error2;
               }
             }
           });
         }
-        const weztermMuxPresent = await runInitStep({
+        const localWeztermVersion = await resolveLocalWeztermVersion();
+        if (!localWeztermVersion) {
+          logger7.info("wezterm_mux_skipped_local_missing", { box: canonical });
+          if (!parsed.json) {
+            console.log(
+              "WezTerm not installed locally; skipping optional mux server setup."
+            );
+          }
+        }
+        const weztermMuxPresent = localWeztermVersion ? await runInitStep({
           enabled: progressEnabled,
-          title: "Ensuring WezTerm mux server (optional)",
+          title: "Ensure WezTerm mux (opt)",
           fn: async ({ status, fail }) => {
             try {
               const installResult = await retryInitStep({
                 status,
-                title: "Ensuring WezTerm mux server",
+                title: "Ensuring WezTerm mux",
                 fn: async () => !shouldResume || !initState?.steps.weztermMuxInstalled ? await ensureWeztermMuxInstalled({
                   client,
                   spriteName: alias,
+                  installOptions: { version: localWeztermVersion },
                   allowResolveAsset: true
                 }) : await ensureWeztermMuxInstalled({
                   client,
                   spriteName: alias,
+                  installOptions: { version: localWeztermVersion },
                   // If the mux is missing on resume, we still need to resolve a GitHub asset.
                   allowResolveAsset: true
                 })
@@ -152443,7 +152490,7 @@ var init_init = __esm({
                 box: canonical,
                 error: error2 instanceof Error ? error2.message : String(error2)
               });
-              fail("Ensuring WezTerm mux server (optional) (failed)");
+              fail("Ensure WezTerm mux (opt) (failed)");
               if (!parsed.json) {
                 const message = error2 instanceof Error && error2.message ? error2.message : String(error2);
                 console.warn(
@@ -152454,16 +152501,16 @@ Tip: re-run with DEVBOX_LOG_LEVEL=info to see Sprite exec logs on stderr.`
               return false;
             }
           }
-        });
+        }) : false;
         if (weztermMuxPresent && (!shouldResume || !initState?.steps.weztermMuxServiceEnsured)) {
           await runInitStep({
             enabled: progressEnabled,
-            title: "Ensuring WezTerm mux service (optional)",
+            title: "Ensure WezTerm mux svc (opt)",
             fn: async ({ status, fail }) => {
               try {
                 await retryInitStep({
                   status,
-                  title: "Ensuring WezTerm mux service",
+                  title: "Ensuring WezTerm mux svc",
                   fn: async () => await ensureWeztermMuxService({
                     client,
                     spriteName: alias
@@ -152477,7 +152524,7 @@ Tip: re-run with DEVBOX_LOG_LEVEL=info to see Sprite exec logs on stderr.`
                   box: canonical,
                   error: error2 instanceof Error ? error2.message : String(error2)
                 });
-                fail("Ensuring WezTerm mux service (optional) (failed)");
+                fail("Ensure WezTerm mux svc (opt) (failed)");
                 if (!parsed.json) {
                   const message = error2 instanceof Error && error2.message ? error2.message : String(error2);
                   console.warn(
@@ -157379,12 +157426,15 @@ var init_updateNotice = __esm({
 // src/devbox/cli.ts
 var cli_exports = {};
 __export(cli_exports, {
-  main: () => main2
+  main: () => main2,
+  resolveEmptyInvocationMode: () => resolveEmptyInvocationMode
 });
-var printUsage, main2;
+var import_promises33, hasProjectState, resolveEmptyInvocationMode, printOnboardingHint, printUsage, main2;
 var init_cli = __esm({
   "src/devbox/cli.ts"() {
     "use strict";
+    import_promises33 = __toESM(require("node:fs/promises"), 1);
+    init_src();
     init_connect2();
     init_daemon();
     init_destroy();
@@ -157404,6 +157454,39 @@ var init_cli = __esm({
     init_wezterm();
     init_completions();
     init_updateNotice();
+    init_colors();
+    hasProjectState = async (projectsDir) => {
+      try {
+        const entries = await import_promises33.default.readdir(projectsDir, { withFileTypes: true });
+        return entries.some((entry) => entry.isDirectory());
+      } catch (error2) {
+        if (error2 instanceof Error && "code" in error2 && error2.code === "ENOENT") {
+          return false;
+        }
+        throw error2;
+      }
+    };
+    resolveEmptyInvocationMode = async ({
+      homeDir
+    } = {}) => {
+      const config3 = await loadConfig(homeDir ? { homeDir } : void 0);
+      if (!config3) {
+        return "setup_hint";
+      }
+      const initializedAnyRepo = await hasProjectState(
+        resolveDevboxProjectsDir(homeDir)
+      );
+      return initializedAnyRepo ? "show_usage" : "init_hint";
+    };
+    printOnboardingHint = (mode) => {
+      const command = mode === "setup_hint" ? "`dvb setup`" : "`dvb init`";
+      const suffix = mode === "setup_hint" ? " to get started." : " at the root of your repo to set up your first devbox.";
+      console.log(
+        `${colors.bold("Welcome to ")}${colors.style("boxes.dev!", ["bold", "green"])}${colors.bold(" Run ")}${colors.style(command, ["bold", "cyan"])}${colors.bold(suffix)}`
+      );
+      console.log("");
+      console.log("Use `dvb --help` to see all commands.");
+    };
     printUsage = () => {
       console.log("Usage:");
       console.log("  dvb --version");
@@ -157466,7 +157549,21 @@ var init_cli = __esm({
     main2 = async () => {
       const args = process.argv.slice(2);
       await maybePrintUpgradeNotice(args);
-      if (args.length === 0 || args[0] === "--help" || args[0] === "-h") {
+      if (args.length === 0) {
+        try {
+          const mode = await resolveEmptyInvocationMode(
+            process.env.HOME ? { homeDir: process.env.HOME } : void 0
+          );
+          if (mode === "setup_hint" || mode === "init_hint") {
+            printOnboardingHint(mode);
+            return;
+          }
+        } catch {
+        }
+        printUsage();
+        return;
+      }
+      if (args[0] === "--help" || args[0] === "-h") {
         printUsage();
         return;
       }
@@ -157791,4 +157888,4 @@ smol-toml/dist/index.js:
 */
 //# sourceMappingURL=dvb.cjs.map
 
-//# debugId=119d7e63-fb65-5c6b-9057-03eebe3f0256
+//# debugId=c7b28144-a37f-5cd7-b6e5-1af8e43047e8