@rudderhq/cli 0.4.0 → 0.4.1

package/README.md

@@ -84,10 +84,18 @@ The fastest path installs the per-user portable Rudder Desktop app and prepares
 npx @rudderhq/cli@latest start
 ```
 
+For a server or headless host where the Desktop app should not be installed,
+prepare only the server runtime and persistent CLI:
+
+```bash
+npx @rudderhq/cli@latest start --server-only
+```
+
 After the persistent CLI is available, the direct `rudder` form is the same command surface:
 
 ```bash
 rudder start
+rudder start --server-only
 ```
 
 ### Develop Rudder

package/dist/index.js

@@ -614,6 +614,7 @@ var init_instance = __esm({
     }).strict();
     patchInstanceNotificationSettingsSchema = instanceNotificationSettingsSchema.partial();
     instanceLangfuseSettingsSchema = z.object({
+      installed: z.boolean().default(false),
       enabled: z.boolean().default(false),
       baseUrl: z.string().url().default("http://localhost:3000"),
       publicKey: z.string().default(""),
@@ -3223,6 +3224,7 @@ var init_config_schema = __esm({
       })
     });
     langfuseConfigSchema = z28.object({
+      installed: z28.boolean().optional(),
       enabled: z28.boolean().default(false),
       baseUrl: z28.string().url().default("http://localhost:3000"),
       publicKey: z28.string().optional(),
@@ -15288,7 +15290,8 @@ async function runStartPhase(message, successMessage, task, progressPhase) {
 }
 async function startCommand(opts) {
   const installCli = opts.cli !== false;
-  const installDesktop = opts.desktop !== false;
+  const serverOnly = opts.serverOnly === true;
+  const installDesktop = !serverOnly && opts.desktop !== false;
   const installRuntime = opts.runtime !== false;
   const repo = opts.repo?.trim() || DEFAULT_DESKTOP_RELEASE_REPO;
   const version = opts.targetVersion?.trim() || opts.version?.trim() || resolveCurrentCliVersion();
@@ -15301,9 +15304,9 @@ async function startCommand(opts) {
     });
   }
   if (!installCli && !installDesktop && !installRuntime) {
-    throw new Error("Nothing to start. Remove --no-cli, --no-runtime, or --no-desktop.");
+    throw new Error("Nothing to start. Remove --no-cli, --no-runtime, --no-desktop, or --server-only.");
   }
-  p15.intro(pc15.bgCyan(pc15.black(" rudder start ")));
+  p15.intro(pc15.bgCyan(pc15.black(serverOnly ? " rudder start --server-only " : " rudder start ")));
   if (opts.versionCheck !== false) {
     const updateNotice = await getCliUpdateNotice(version);
     if (updateNotice) p15.log.warn(updateNotice);
@@ -15531,6 +15534,9 @@ async function startCommand(opts) {
         );
       }
     });
+  } else if (serverOnly) {
+    p15.log.step("Server-only install");
+    p15.log.message("Desktop app installation was skipped. Start the server with `rudder run` and open the printed local URL in a browser.");
   }
   p15.outro(pc15.green("Rudder start complete."));
 }
@@ -15601,7 +15607,7 @@ function createProgram() {
     });
     loadRudderEnvFile(options.config);
   });
-  program.command("start").description("Start Rudder Desktop and prepare the matching persistent CLI").option("--no-cli", "Skip persistent CLI installation").option("--no-runtime", "Skip Rudder runtime installation").option("--no-desktop", "Skip desktop app installation").option("--version <version>", "Rudder version to start (default: current CLI version)").option("--target-version <version>", "Rudder version to start; avoids the root CLI version flag").option("--repo <owner/repo>", "GitHub repository that hosts desktop releases").option("--output-dir <path>", "Directory for downloaded desktop release assets").option("--desktop-install-dir <path>", "Directory for the portable Desktop install").option("--no-open", "Install Desktop without launching it").option("--wait-for-active-runs", "Wait for active Rudder runs to finish before replacing Desktop", false).option("--desktop-progress-json", "Emit newline-delimited Desktop update progress events").option("--desktop-wait-for-apply", "Wait for an apply signal after downloading and verifying the Desktop update", false).option("--no-version-check", "Skip checking npm for a newer Rudder CLI version").option("--dry-run", "Print the start actions without changing the machine", false).action(startCommand);
+  program.command("start").description("Start Rudder Desktop and prepare the matching persistent CLI").option("--server-only", "Prepare the Rudder server runtime and persistent CLI without installing Desktop").option("--no-cli", "Skip persistent CLI installation").option("--no-runtime", "Skip Rudder runtime installation").option("--no-desktop", "Skip desktop app installation").option("--version <version>", "Rudder version to start (default: current CLI version)").option("--target-version <version>", "Rudder version to start; avoids the root CLI version flag").option("--repo <owner/repo>", "GitHub repository that hosts desktop releases").option("--output-dir <path>", "Directory for downloaded desktop release assets").option("--desktop-install-dir <path>", "Directory for the portable Desktop install").option("--no-open", "Install Desktop without launching it").option("--wait-for-active-runs", "Wait for active Rudder runs to finish before replacing Desktop", false).option("--desktop-progress-json", "Emit newline-delimited Desktop update progress events").option("--desktop-wait-for-apply", "Wait for an apply signal after downloading and verifying the Desktop update", false).option("--no-version-check", "Skip checking npm for a newer Rudder CLI version").option("--dry-run", "Print the start actions without changing the machine", false).action(startCommand);
   program.command("onboard").description("Interactive first-run setup wizard").option("-c, --config <path>", "Path to config file").option("-d, --data-dir <path>", DATA_DIR_OPTION_HELP).option("-y, --yes", "Accept defaults (quickstart + start immediately)", false).option("--run", "Start Rudder immediately after saving config", false).action(onboard);
   program.command("doctor").description("Run diagnostic checks on your Rudder setup").option("-c, --config <path>", "Path to config file").option("-d, --data-dir <path>", DATA_DIR_OPTION_HELP).option("--repair", "Attempt to repair issues automatically").alias("--fix").option("-y, --yes", "Skip repair confirmation prompts").action(async (opts) => {
     await doctor(opts);