clever-tools 4.10.0 → 5.0.0

package/src/commands/global.commands.js

@@ -39,8 +39,18 @@ import { domainFavouriteSetCommand } from './domain/domain.favourite.set.command
 import { domainFavouriteUnsetCommand } from './domain/domain.favourite.unset.command.js';
 import { domainOverviewCommand } from './domain/domain.overview.command.js';
 import { domainRmCommand } from './domain/domain.rm.command.js';
+import { drainCheckCommand } from './drain/drain.check.command.js';
 import { drainCommand } from './drain/drain.command.js';
+import { drainCreateBetterstackCommand } from './drain/drain.create.betterstack.command.js';
 import { drainCreateCommand } from './drain/drain.create.command.js';
+import { drainCreateDatadogCommand } from './drain/drain.create.datadog.command.js';
+import { drainCreateElasticsearchCommand } from './drain/drain.create.elasticsearch.command.js';
+import { drainCreateNewRelicCommand } from './drain/drain.create.newrelic.command.js';
+import { drainCreateOvhTcpCommand } from './drain/drain.create.ovh-tcp.command.js';
+import { drainCreateRawHttpCommand } from './drain/drain.create.raw-http.command.js';
+import { drainCreateSplunkCommand } from './drain/drain.create.splunk.command.js';
+import { drainCreateSyslogTcpCommand } from './drain/drain.create.syslog-tcp.command.js';
+import { drainCreateSyslogUdpCommand } from './drain/drain.create.syslog-udp.command.js';
 import { drainDisableCommand } from './drain/drain.disable.command.js';
 import { drainEnableCommand } from './drain/drain.enable.command.js';
 import { drainGetCommand } from './drain/drain.get.command.js';
@@ -268,7 +278,21 @@ export const globalCommands = {
   drain: [
     drainCommand,
     {
-      create: drainCreateCommand,
+      check: drainCheckCommand,
+      create: [
+        drainCreateCommand,
+        {
+          betterstack: drainCreateBetterstackCommand,
+          datadog: drainCreateDatadogCommand,
+          elasticsearch: drainCreateElasticsearchCommand,
+          newrelic: drainCreateNewRelicCommand,
+          'ovh-tcp': drainCreateOvhTcpCommand,
+          'raw-http': drainCreateRawHttpCommand,
+          splunk: drainCreateSplunkCommand,
+          'syslog-tcp': drainCreateSyslogTcpCommand,
+          'syslog-udp': drainCreateSyslogUdpCommand,
+        },
+      ],
       disable: drainDisableCommand,
       enable: drainEnableCommand,
       get: drainGetCommand,

package/src/commands/global.options.js

@@ -28,6 +28,14 @@ export const logsFormatOption = defineOption({
   placeholder: 'format',
 });
 
+export const accessLogsFormatOption = defineOption({
+  name: 'format',
+  schema: z.enum(['human', 'json', 'json-stream', 'clf']).default('human'),
+  description: 'Output format (clf only outputs HTTP access logs)',
+  aliases: ['F'],
+  placeholder: 'format',
+});
+
 export const beforeOption = defineOption({
   name: 'before',
   schema: z.string().transform(date).optional(),

package/src/commands/k8s/k8s.docs.md

@@ -24,7 +24,7 @@ clever k8s activity <cluster-id|cluster-name> [options]
 
 |Name|Description|
 |---|---|
-|`cluster-id|cluster-name`|Kubernetes cluster ID or name|
+|`cluster-id\|cluster-name`|Kubernetes cluster ID or name|
 
 ### ⚙️ Options
 
@@ -46,7 +46,7 @@ clever k8s add-persistent-storage <cluster-id|cluster-name> [options]
 
 |Name|Description|
 |---|---|
-|`cluster-id|cluster-name`|Kubernetes cluster ID or name|
+|`cluster-id\|cluster-name`|Kubernetes cluster ID or name|
 
 ### ⚙️ Options
 
@@ -97,7 +97,7 @@ clever k8s delete <cluster-id|cluster-name> [options]
 
 |Name|Description|
 |---|---|
-|`cluster-id|cluster-name`|Kubernetes cluster ID or name|
+|`cluster-id\|cluster-name`|Kubernetes cluster ID or name|
 
 ### ⚙️ Options
 
@@ -118,7 +118,7 @@ clever k8s get <cluster-id|cluster-name> [options]
 
 |Name|Description|
 |---|---|
-|`cluster-id|cluster-name`|Kubernetes cluster ID or name|
+|`cluster-id\|cluster-name`|Kubernetes cluster ID or name|
 
 ### ⚙️ Options
 
@@ -139,7 +139,7 @@ clever k8s get-kubeconfig <cluster-id|cluster-name> [options]
 
 |Name|Description|
 |---|---|
-|`cluster-id|cluster-name`|Kubernetes cluster ID or name|
+|`cluster-id\|cluster-name`|Kubernetes cluster ID or name|
 
 ### ⚙️ Options
 
@@ -182,7 +182,7 @@ clever k8s nodegroups create <cluster-id|cluster-name> <nodegroup-name> <flavor:
 
 |Name|Description|
 |---|---|
-|`cluster-id|cluster-name`|Kubernetes cluster ID or name|
+|`cluster-id\|cluster-name`|Kubernetes cluster ID or name|
 |`nodegroup-name`|Node group name (lowercase RFC 1123, max 63 chars)|
 |`flavor:count`|Node group flavor and target node count (format: <flavor>:<count>, e.g.: XS:3)|
 
@@ -209,8 +209,8 @@ clever k8s nodegroups delete <cluster-id|cluster-name> <nodegroup-id|nodegroup-n
 
 |Name|Description|
 |---|---|
-|`cluster-id|cluster-name`|Kubernetes cluster ID or name|
-|`nodegroup-id|nodegroup-name`|Kubernetes node group ID or name|
+|`cluster-id\|cluster-name`|Kubernetes cluster ID or name|
+|`nodegroup-id\|nodegroup-name`|Kubernetes node group ID or name|
 
 ### ⚙️ Options
 
@@ -231,8 +231,8 @@ clever k8s nodegroups get <cluster-id|cluster-name> <nodegroup-id|nodegroup-name
 
 |Name|Description|
 |---|---|
-|`cluster-id|cluster-name`|Kubernetes cluster ID or name|
-|`nodegroup-id|nodegroup-name`|Kubernetes node group ID or name|
+|`cluster-id\|cluster-name`|Kubernetes cluster ID or name|
+|`nodegroup-id\|nodegroup-name`|Kubernetes node group ID or name|
 
 ### ⚙️ Options
 
@@ -253,7 +253,7 @@ clever k8s nodegroups list <cluster-id|cluster-name> [options]
 
 |Name|Description|
 |---|---|
-|`cluster-id|cluster-name`|Kubernetes cluster ID or name|
+|`cluster-id\|cluster-name`|Kubernetes cluster ID or name|
 
 ### ⚙️ Options
 
@@ -274,8 +274,8 @@ clever k8s nodegroups update <cluster-id|cluster-name> <nodegroup-id|nodegroup-n
 
 |Name|Description|
 |---|---|
-|`cluster-id|cluster-name`|Kubernetes cluster ID or name|
-|`nodegroup-id|nodegroup-name`|Kubernetes node group ID or name|
+|`cluster-id\|cluster-name`|Kubernetes cluster ID or name|
+|`nodegroup-id\|nodegroup-name`|Kubernetes node group ID or name|
 
 ### ⚙️ Options
 
@@ -317,7 +317,7 @@ clever k8s update <cluster-id|cluster-name> [options]
 
 |Name|Description|
 |---|---|
-|`cluster-id|cluster-name`|Kubernetes cluster ID or name|
+|`cluster-id\|cluster-name`|Kubernetes cluster ID or name|
 
 ### ⚙️ Options
 
@@ -342,7 +342,7 @@ clever k8s version <cluster-id|cluster-name> [options]
 
 |Name|Description|
 |---|---|
-|`cluster-id|cluster-name`|Kubernetes cluster ID or name|
+|`cluster-id\|cluster-name`|Kubernetes cluster ID or name|
 
 ### ⚙️ Options
 
@@ -363,7 +363,7 @@ clever k8s version check <cluster-id|cluster-name> [options]
 
 |Name|Description|
 |---|---|
-|`cluster-id|cluster-name`|Kubernetes cluster ID or name|
+|`cluster-id\|cluster-name`|Kubernetes cluster ID or name|
 
 ### ⚙️ Options
 
@@ -384,7 +384,7 @@ clever k8s version update <cluster-id|cluster-name> [options]
 
 |Name|Description|
 |---|---|
-|`cluster-id|cluster-name`|Kubernetes cluster ID or name|
+|`cluster-id\|cluster-name`|Kubernetes cluster ID or name|
 
 ### ⚙️ Options
 

package/src/commands/keycloak/keycloak.docs.md

@@ -30,7 +30,7 @@ clever keycloak disable-ng <addon-id|addon-name>
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ## ➡️ `clever keycloak enable-ng` <kbd>Since 3.13.0</kbd>
 
@@ -44,7 +44,7 @@ clever keycloak enable-ng <addon-id|addon-name>
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ## ➡️ `clever keycloak get` <kbd>Since 3.13.0</kbd>
 
@@ -58,7 +58,7 @@ clever keycloak get <addon-id|addon-name> [options]
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ### ⚙️ Options
 
@@ -78,7 +78,7 @@ clever keycloak open <addon-id|addon-name>
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ## ➡️ `clever keycloak open logs` <kbd>Since 3.13.0</kbd>
 
@@ -92,7 +92,7 @@ clever keycloak open logs <addon-id|addon-name>
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ## ➡️ `clever keycloak open webui` <kbd>Since 3.13.0</kbd>
 
@@ -106,7 +106,7 @@ clever keycloak open webui <addon-id|addon-name>
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ## ➡️ `clever keycloak rebuild` <kbd>Since 3.13.0</kbd>
 
@@ -120,7 +120,7 @@ clever keycloak rebuild <addon-id|addon-name>
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ## ➡️ `clever keycloak restart` <kbd>Since 3.13.0</kbd>
 
@@ -134,7 +134,7 @@ clever keycloak restart <addon-id|addon-name>
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ## ➡️ `clever keycloak version` <kbd>Since 3.13.0</kbd>
 
@@ -148,7 +148,7 @@ clever keycloak version <addon-id|addon-name> [options]
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ### ⚙️ Options
 
@@ -168,7 +168,7 @@ clever keycloak version check <addon-id|addon-name> [options]
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ### ⚙️ Options
 
@@ -188,7 +188,7 @@ clever keycloak version update <addon-id|addon-name> [options]
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ### ⚙️ Options
 

package/src/commands/kv/kv.docs.md

@@ -16,7 +16,7 @@ clever kv <kv-id|addon-id|addon-name> <command> [options]
 
 |Name|Description|
 |---|---|
-|`kv-id|addon-id|addon-name`|Add-on/Real ID (or name, if unambiguous) of a Materia KV or Redis® add-on|
+|`kv-id\|addon-id\|addon-name`|Add-on/Real ID (or name, if unambiguous) of a Materia KV or Redis® add-on|
 |`command`|The raw command to send to the Materia KV or Redis® add-on|
 
 ### ⚙️ Options

package/src/commands/link/link.docs.md

@@ -12,7 +12,7 @@ clever link <app-id|app-name> [options]
 
 |Name|Description|
 |---|---|
-|`app-id|app-name`|Application ID (or name, if unambiguous)|
+|`app-id\|app-name`|Application ID (or name, if unambiguous)|
 
 ### ⚙️ Options
 

package/src/commands/login/login.command.js

@@ -56,7 +56,17 @@ async function loginViaConsole(apiHost, consoleTokenUrl) {
 
   Logger.debug('Try to login to Clever Cloud…');
   Logger.println(`Opening ${styleText('blue', consoleUrl.toString())} in your browser to log you in…`);
-  await open(consoleUrl.toString(), { wait: false });
+  function warnBrowserLaunchFailed(error) {
+    Logger.warn(`Failed to open your browser automatically (${error.message}).`);
+    Logger.println('Open the URL above manually to continue logging in.');
+  }
+
+  try {
+    const browserProcess = await open(consoleUrl.toString(), { wait: false });
+    browserProcess.once('error', warnBrowserLaunchFailed);
+  } catch (error) {
+    warnBrowserLaunchFailed(error);
+  }
 
   return pollOauthData(cliPollUrl.toString());
 }

package/src/commands/matomo/matomo.docs.md

@@ -30,7 +30,7 @@ clever matomo get <addon-id|addon-name> [options]
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ### ⚙️ Options
 
@@ -50,7 +50,7 @@ clever matomo open <addon-id|addon-name>
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ## ➡️ `clever matomo open logs` <kbd>Since 3.13.0</kbd>
 
@@ -64,7 +64,7 @@ clever matomo open logs <addon-id|addon-name>
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ## ➡️ `clever matomo open webui` <kbd>Since 3.13.0</kbd>
 
@@ -78,7 +78,7 @@ clever matomo open webui <addon-id|addon-name>
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ## ➡️ `clever matomo rebuild` <kbd>Since 3.13.0</kbd>
 
@@ -92,7 +92,7 @@ clever matomo rebuild <addon-id|addon-name>
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ## ➡️ `clever matomo restart` <kbd>Since 3.13.0</kbd>
 
@@ -106,4 +106,4 @@ clever matomo restart <addon-id|addon-name>
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|

package/src/commands/metabase/metabase.docs.md

@@ -30,7 +30,7 @@ clever metabase get <addon-id|addon-name> [options]
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ### ⚙️ Options
 
@@ -50,7 +50,7 @@ clever metabase open <addon-id|addon-name>
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ## ➡️ `clever metabase open logs` <kbd>Since 3.13.0</kbd>
 
@@ -64,7 +64,7 @@ clever metabase open logs <addon-id|addon-name>
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ## ➡️ `clever metabase open webui` <kbd>Since 3.13.0</kbd>
 
@@ -78,7 +78,7 @@ clever metabase open webui <addon-id|addon-name>
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ## ➡️ `clever metabase rebuild` <kbd>Since 3.13.0</kbd>
 
@@ -92,7 +92,7 @@ clever metabase rebuild <addon-id|addon-name>
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ## ➡️ `clever metabase restart` <kbd>Since 3.13.0</kbd>
 
@@ -106,7 +106,7 @@ clever metabase restart <addon-id|addon-name>
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ## ➡️ `clever metabase version` <kbd>Since 3.13.0</kbd>
 
@@ -120,7 +120,7 @@ clever metabase version <addon-id|addon-name> [options]
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ### ⚙️ Options
 
@@ -140,7 +140,7 @@ clever metabase version check <addon-id|addon-name> [options]
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ### ⚙️ Options
 
@@ -160,7 +160,7 @@ clever metabase version update <addon-id|addon-name> [options]
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ### ⚙️ Options
 

package/src/commands/ng/ng.docs.md

@@ -55,7 +55,7 @@ clever ng create external <external-peer-label> <ng-id|ng-label> <public-key> [o
 |Name|Description|
 |---|---|
 |`external-peer-label`|External peer label|
-|`ng-id|ng-label`|Network Group ID or label|
+|`ng-id\|ng-label`|Network Group ID or label|
 |`public-key`|WireGuard public key of the external peer to link to a Network Group|
 
 ### ⚙️ Options
@@ -76,7 +76,7 @@ clever ng delete <ng-id|ng-label> [options]
 
 |Name|Description|
 |---|---|
-|`ng-id|ng-label`|Network Group ID or label|
+|`ng-id\|ng-label`|Network Group ID or label|
 
 ### ⚙️ Options
 
@@ -96,8 +96,8 @@ clever ng delete external <peer-id|peer-label> <ng-id|ng-label> [options]
 
 |Name|Description|
 |---|---|
-|`peer-id|peer-label`|External peer ID or label|
-|`ng-id|ng-label`|Network Group ID or label|
+|`peer-id\|peer-label`|External peer ID or label|
+|`ng-id\|ng-label`|Network Group ID or label|
 
 ### ⚙️ Options
 
@@ -117,7 +117,7 @@ clever ng get <id|label> [options]
 
 |Name|Description|
 |---|---|
-|`id|label`|ID or Label of a Network Group, a member or an (external) peer|
+|`id\|label`|ID or Label of a Network Group, a member or an (external) peer|
 
 ### ⚙️ Options
 
@@ -139,8 +139,8 @@ clever ng get-config <peer-id|peer-label> <ng-id|ng-label> [options]
 
 |Name|Description|
 |---|---|
-|`peer-id|peer-label`|External peer ID or label|
-|`ng-id|ng-label`|Network Group ID or label|
+|`peer-id\|peer-label`|External peer ID or label|
+|`ng-id\|ng-label`|Network Group ID or label|
 
 ### ⚙️ Options
 
@@ -161,7 +161,7 @@ clever ng link <id> <ng-id|ng-label> [options]
 |Name|Description|
 |---|---|
 |`id`|ID of a resource to (un)link to a Network Group|
-|`ng-id|ng-label`|Network Group ID or label|
+|`ng-id\|ng-label`|Network Group ID or label|
 
 ### ⚙️ Options
 
@@ -181,7 +181,7 @@ clever ng search <id|label> [options]
 
 |Name|Description|
 |---|---|
-|`id|label`|ID or Label of a Network Group, a member or an (external) peer|
+|`id\|label`|ID or Label of a Network Group, a member or an (external) peer|
 
 ### ⚙️ Options
 
@@ -204,7 +204,7 @@ clever ng unlink <id> <ng-id|ng-label> [options]
 |Name|Description|
 |---|---|
 |`id`|ID of a resource to (un)link to a Network Group|
-|`ng-id|ng-label`|Network Group ID or label|
+|`ng-id\|ng-label`|Network Group ID or label|
 
 ### ⚙️ Options
 

package/src/commands/oauth-consumers/oauth-consumers.docs.md

@@ -46,7 +46,7 @@ clever oauth-consumers delete <consumer-key|consumer-name> [options]
 
 |Name|Description|
 |---|---|
-|`consumer-key|consumer-name`|OAuth consumer key (or name, if unambiguous)|
+|`consumer-key\|consumer-name`|OAuth consumer key (or name, if unambiguous)|
 
 ### ⚙️ Options
 
@@ -66,7 +66,7 @@ clever oauth-consumers get <consumer-key|consumer-name> [options]
 
 |Name|Description|
 |---|---|
-|`consumer-key|consumer-name`|OAuth consumer key (or name, if unambiguous)|
+|`consumer-key\|consumer-name`|OAuth consumer key (or name, if unambiguous)|
 
 ### ⚙️ Options
 
@@ -101,7 +101,7 @@ clever oauth-consumers open <consumer-key|consumer-name>
 
 |Name|Description|
 |---|---|
-|`consumer-key|consumer-name`|OAuth consumer key (or name, if unambiguous)|
+|`consumer-key\|consumer-name`|OAuth consumer key (or name, if unambiguous)|
 
 ## ➡️ `clever oauth-consumers update` <kbd>Since 4.8.0</kbd>
 
@@ -115,7 +115,7 @@ clever oauth-consumers update <consumer-key|consumer-name> [options]
 
 |Name|Description|
 |---|---|
-|`consumer-key|consumer-name`|OAuth consumer key (or name, if unambiguous)|
+|`consumer-key\|consumer-name`|OAuth consumer key (or name, if unambiguous)|
 
 ### ⚙️ Options
 

package/src/commands/otoroshi/otoroshi.docs.md

@@ -30,7 +30,7 @@ clever otoroshi disable-ng <addon-id|addon-name>
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ## ➡️ `clever otoroshi enable-ng` <kbd>Since 3.13.0</kbd>
 
@@ -44,7 +44,7 @@ clever otoroshi enable-ng <addon-id|addon-name>
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ## ➡️ `clever otoroshi get` <kbd>Since 3.13.0</kbd>
 
@@ -58,7 +58,7 @@ clever otoroshi get <addon-id|addon-name> [options]
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ### ⚙️ Options
 
@@ -78,7 +78,7 @@ clever otoroshi get-config <addon-id|addon-name>
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ## ➡️ `clever otoroshi open` <kbd>Since 3.13.0</kbd>
 
@@ -92,7 +92,7 @@ clever otoroshi open <addon-id|addon-name>
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ## ➡️ `clever otoroshi open logs` <kbd>Since 3.13.0</kbd>
 
@@ -106,7 +106,7 @@ clever otoroshi open logs <addon-id|addon-name>
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ## ➡️ `clever otoroshi open swaggerui` <kbd>Since 4.9.0</kbd>
 
@@ -120,7 +120,7 @@ clever otoroshi open swaggerui <addon-id|addon-name>
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ## ➡️ `clever otoroshi open webui` <kbd>Since 3.13.0</kbd>
 
@@ -134,7 +134,7 @@ clever otoroshi open webui <addon-id|addon-name>
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ## ➡️ `clever otoroshi rebuild` <kbd>Since 3.13.0</kbd>
 
@@ -148,7 +148,7 @@ clever otoroshi rebuild <addon-id|addon-name>
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ## ➡️ `clever otoroshi restart` <kbd>Since 3.13.0</kbd>
 
@@ -162,7 +162,7 @@ clever otoroshi restart <addon-id|addon-name>
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ## ➡️ `clever otoroshi version` <kbd>Since 3.13.0</kbd>
 
@@ -176,7 +176,7 @@ clever otoroshi version <addon-id|addon-name> [options]
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ### ⚙️ Options
 
@@ -196,7 +196,7 @@ clever otoroshi version check <addon-id|addon-name> [options]
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ### ⚙️ Options
 
@@ -216,7 +216,7 @@ clever otoroshi version update <addon-id|addon-name> [options]
 
 |Name|Description|
 |---|---|
-|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+|`addon-id\|addon-name`|Add-on ID (or name, if unambiguous)|
 
 ### ⚙️ Options
 

package/src/commands/profile/profile.switch.command.js

@@ -75,6 +75,10 @@ async function resolveTargetProfile(profiles, requestedAlias) {
     name: formatProfile(profile),
     value: profile.alias,
   }));
-  const selectedAlias = await selectAnswer('Select a profile:', choices);
+  const selectedAlias = await selectAnswer(
+    'Select a profile:',
+    choices,
+    'Use --alias <name> to select a profile directly.',
+  );
   return profiles.find((profile) => profile.alias === selectedAlias);
 }