feat(core): add command to download cloud client (#34333)

Cammisuli · nx-cloud[bot] · web-flow · commit 7df9d96dac50 · 2026-02-05T10:42:55.000-05:00
## Current Behavior  The only way to download the cloud client is to run a specific cloud command or a task with cloud configured. ## Expected Behavior  A new command is added where we only download the cloud client with: ``` nx download-cloud-client ``` ## Related Issue(s)  Fixes # --------- Co-authored-by: nx-cloud[bot] <71083854+nx-cloud[bot]@users.noreply.github.com>
diff --git a/packages/nx/src/command-line/nx-cloud/download-cloud-client/command-object.ts b/packages/nx/src/command-line/nx-cloud/download-cloud-client/command-object.ts
@@ -0,0 +1,15 @@
+import { CommandModule } from 'yargs';
+import { withVerbose } from '../../yargs-utils/shared-options';
+
+export const yargsDownloadCloudClientCommand: CommandModule = {
+  command: 'download-cloud-client',
+  describe: 'Download the Nx Cloud client.',
+  builder: (yargs) => withVerbose(yargs),
+  handler: async (args: any) => {
+    process.exit(
+      await (
+        await import('./download-cloud-client')
+      ).downloadCloudClientHandler(args)
+    );
+  },
+};
diff --git a/packages/nx/src/command-line/nx-cloud/download-cloud-client/download-cloud-client.ts b/packages/nx/src/command-line/nx-cloud/download-cloud-client/download-cloud-client.ts
@@ -0,0 +1,32 @@
+import { readNxJson } from '../../../config/nx-json';
+import { verifyOrUpdateNxCloudClient } from '../../../nx-cloud/update-manager';
+import { getCloudOptions } from '../../../nx-cloud/utilities/get-cloud-options';
+import { isNxCloudUsed } from '../../../utils/nx-cloud-utils';
+import { handleErrors } from '../../../utils/handle-errors';
+import { output } from '../../../utils/output';
+import { warnNotConnectedToCloud } from '../utils';
+
+export interface DownloadCloudClientArgs {
+  verbose?: boolean;
+}
+
+export function downloadCloudClientHandler(
+  args: DownloadCloudClientArgs
+): Promise<number> {
+  if (!isNxCloudUsed(readNxJson())) {
+    warnNotConnectedToCloud();
+    return Promise.resolve(1);
+  }
+
+  return handleErrors(args.verbose, async () => {
+    const options = getCloudOptions();
+    const result = await verifyOrUpdateNxCloudClient(options);
+
+    if (result) {
+      output.success({
+        title: 'Nx Cloud client downloaded successfully',
+        bodyLines: [`Version: ${result.version}`],
+      });
+    }
+  });
+}
diff --git a/packages/nx/src/command-line/nx-commands.ts b/packages/nx/src/command-line/nx-commands.ts
@@ -46,6 +46,7 @@ import { yargsStartCiRunCommand } from './nx-cloud/start-ci-run/command-object';
 import { yargsStartAgentCommand } from './nx-cloud/start-agent/command-object';
 import { yargsStopAllAgentsCommand } from './nx-cloud/complete-run/command-object';
 import { yargsFixCiCommand } from './nx-cloud/fix-ci/command-object';
+import { yargsDownloadCloudClientCommand } from './nx-cloud/download-cloud-client/command-object';
 import {
   yargsPrintAffectedCommand,
   yargsAffectedGraphCommand,
@@ -114,6 +115,7 @@ export const commandsObject = yargs
   .command(yargsStartAgentCommand)
   .command(yargsStopAllAgentsCommand)
   .command(yargsFixCiCommand)
+  .command(yargsDownloadCloudClientCommand)
   .command(yargsMcpCommand)
   .command(resolveConformanceCommandObject())
   .command(resolveConformanceCheckCommandObject())
