@nocobase/cli 2.1.0-beta.20 → 2.1.0-beta.21

package/dist/commands/install.js

@@ -16,6 +16,7 @@ import path from 'node:path';
 import { exit } from 'node:process';
 import { runPromptCatalog, } from "../lib/prompt-catalog.js";
 import { applyCliLocale, localeText, resolveCliLocale, translateCli, } from "../lib/cli-locale.js";
+import { resolveConfiguredEnvPath, resolveDefaultConfigScope, resolveEnvRelativePath, } from '../lib/cli-home.js';
 import { findAvailableTcpPort, validateAvailableTcpPort, validateTcpPort, validateEnvKey, } from "../lib/prompt-validators.js";
 import { formatMissingManagedAppEnvMessage } from '../lib/app-runtime.js';
 import { run, runNocoBaseCommand } from '../lib/run-npm.js';
@@ -53,7 +54,6 @@ const DEFAULT_INSTALL_ROOT_USERNAME = 'nocobase';
 const DEFAULT_INSTALL_ROOT_EMAIL = 'admin@nocobase.com';
 const DEFAULT_INSTALL_ROOT_PASSWORD = 'admin123';
 const DEFAULT_INSTALL_ROOT_NICKNAME = 'Super Admin';
-const CONFIG_SCOPE = 'project';
 const APP_HEALTH_CHECK_INTERVAL_MS = 2_000;
 const APP_HEALTH_CHECK_TIMEOUT_MS = 600_000;
 const APP_HEALTH_CHECK_REQUEST_TIMEOUT_MS = 5_000;
@@ -137,6 +137,11 @@ function argvHasToken(argv, tokens) {
 function isInstallDbDialect(value) {
     return INSTALL_DB_DIALECTS.includes(value);
 }
+function downloadVersionPromptValue(version) {
+    return version === 'latest' || version === 'beta' || version === 'alpha'
+        ? version
+        : 'other';
+}
 function supportsBuiltinDbDialect(value) {
     const dialect = String(value ?? '').trim();
     return Object.prototype.hasOwnProperty.call(DEFAULT_INSTALL_BUILTIN_DB_IMAGES, dialect);
@@ -303,6 +308,7 @@ export default class Install extends Command {
             required: false,
         }),
         'builtin-db': Flags.boolean({
+            allowNo: true,
             description: 'Create and connect a CLI-managed built-in database for the app',
             default: false,
         }),
@@ -569,7 +575,7 @@ export default class Install extends Command {
         if (argvHasToken(argv, ['--fetch-source'])) {
             preset.fetchSource = flags['fetch-source'];
         }
-        if (argvHasToken(argv, ['--builtin-db'])) {
+        if (argvHasToken(argv, ['--builtin-db', '--no-builtin-db'])) {
             preset.builtinDb = flags['builtin-db'];
         }
         if (flags['db-dialect'] !== undefined) {
@@ -588,6 +594,7 @@ export default class Install extends Command {
             const v = String(flags['db-host'] ?? '').trim();
             if (v) {
                 preset.dbHost = v;
+                preset.builtinDb = false;
             }
         }
         if (flags['db-port'] !== undefined) {
@@ -682,7 +689,14 @@ export default class Install extends Command {
         };
         const downloadPreset = {
             ...(source ? { source } : {}),
-            ...(downloadVersion ? { version: downloadVersion } : {}),
+            ...(downloadVersion
+                ? {
+                    version: downloadVersionPromptValue(downloadVersion),
+                    ...(downloadVersionPromptValue(downloadVersion) === 'other'
+                        ? { otherVersion: downloadVersion }
+                        : {}),
+                }
+                : {}),
             ...(dockerRegistry ? { dockerRegistry } : {}),
             ...(dockerPlatform ? { dockerPlatform } : {}),
             ...(gitUrl ? { gitUrl } : {}),
@@ -746,7 +760,7 @@ export default class Install extends Command {
         if (!parsed.resume) {
             return undefined;
         }
-        const env = await getEnv(parsed.env, { scope: CONFIG_SCOPE });
+        const env = await getEnv(parsed.env, { scope: resolveDefaultConfigScope() });
         if (!env) {
             throw new Error(formatMissingManagedAppEnvMessage(parsed.env));
         }
@@ -861,7 +875,11 @@ export default class Install extends Command {
             preset.source = String(flags.source).trim();
         }
         if (flags.version !== undefined) {
-            preset.version = String(flags.version).trim() || 'latest';
+            const version = String(flags.version).trim() || 'latest';
+            preset.version = downloadVersionPromptValue(version);
+            if (preset.version === 'other') {
+                preset.otherVersion = version;
+            }
         }
         if (flags['docker-registry'] !== undefined) {
             const value = String(flags['docker-registry'] ?? '').trim();
@@ -891,7 +909,10 @@ export default class Install extends Command {
             preset.npmRegistry =
                 typeof flags['npm-registry'] === 'string' ? flags['npm-registry'] : '';
         }
-        if (argvHasToken(argv, ['--replace', '-r'])) {
+        if (flags.resume && !argvHasToken(argv, ['--replace', '-r'])) {
+            preset.replace = true;
+        }
+        else if (argvHasToken(argv, ['--replace', '-r'])) {
             preset.replace = flags.replace;
         }
         if (argvHasToken(argv, ['--dev-dependencies', '--no-dev-dependencies', '-D'])) {
@@ -933,7 +954,7 @@ export default class Install extends Command {
             : Install.defaultWorkspaceName();
     }
     static async ensureWorkspaceName() {
-        return await ensureWorkspaceName(Install.defaultWorkspaceName(), { scope: CONFIG_SCOPE });
+        return await ensureWorkspaceName(Install.defaultWorkspaceName(), { scope: resolveDefaultConfigScope() });
     }
     static buildBuiltinDbNetworkName(envName, workspaceName) {
         return Install.buildBuiltinDbResourcePrefix(envName, workspaceName);
@@ -982,9 +1003,11 @@ export default class Install extends Command {
                 && dbHostInput !== 'localhost'
                 ? dbHostInput
                 : containerName);
+        const storagePath = resolveConfiguredEnvPath(params.storagePath)
+            ?? resolveEnvRelativePath(defaultInstallStoragePath(params.envName));
         if (dbDialect === 'postgres') {
             const image = String(params.builtinDbImage ?? '').trim() || defaultBuiltinDbImageForDialect(dbDialect);
-            const dataDir = path.resolve(params.storagePath, 'db', 'postgres');
+            const dataDir = path.resolve(storagePath, 'db', 'postgres');
             const args = [
                 'run',
                 '-d',
@@ -1028,7 +1051,7 @@ export default class Install extends Command {
         }
         if (dbDialect === 'mysql') {
             const image = String(params.builtinDbImage ?? '').trim() || defaultBuiltinDbImageForDialect(dbDialect);
-            const dataDir = path.resolve(params.storagePath, 'db', 'mysql');
+            const dataDir = path.resolve(storagePath, 'db', 'mysql');
             const dbUser = String(params.dbUser ?? DEFAULT_INSTALL_DB_USER).trim() || DEFAULT_INSTALL_DB_USER;
             const dbDatabase = String(params.dbDatabase ?? defaultDbDatabase).trim() || defaultDbDatabase;
             const dbPassword = String(params.dbPassword ?? DEFAULT_INSTALL_DB_PASSWORD) || DEFAULT_INSTALL_DB_PASSWORD;
@@ -1074,7 +1097,7 @@ export default class Install extends Command {
         }
         if (dbDialect === 'mariadb') {
             const image = String(params.builtinDbImage ?? '').trim() || defaultBuiltinDbImageForDialect(dbDialect);
-            const dataDir = path.resolve(params.storagePath, 'db', 'mariadb');
+            const dataDir = path.resolve(storagePath, 'db', 'mariadb');
             const dbUser = String(params.dbUser ?? DEFAULT_INSTALL_DB_USER).trim() || DEFAULT_INSTALL_DB_USER;
             const dbDatabase = String(params.dbDatabase ?? defaultDbDatabase).trim() || defaultDbDatabase;
             const dbPassword = String(params.dbPassword ?? DEFAULT_INSTALL_DB_PASSWORD) || DEFAULT_INSTALL_DB_PASSWORD;
@@ -1120,7 +1143,7 @@ export default class Install extends Command {
         }
         if (dbDialect === 'kingbase') {
             const image = String(params.builtinDbImage ?? '').trim() || defaultBuiltinDbImageForDialect(dbDialect);
-            const dataDir = path.resolve(params.storagePath, 'db', 'kingbase');
+            const dataDir = path.resolve(storagePath, 'db', 'kingbase');
             const dbUser = String(params.dbUser ?? DEFAULT_INSTALL_DB_USER).trim() || DEFAULT_INSTALL_DB_USER;
             const dbDatabase = String(params.dbDatabase ?? defaultDbDatabase).trim() || defaultDbDatabase;
             const dbPassword = String(params.dbPassword ?? DEFAULT_INSTALL_DB_PASSWORD) || DEFAULT_INSTALL_DB_PASSWORD;
@@ -1269,12 +1292,12 @@ export default class Install extends Command {
         });
         p.log.step(`Preparing built-in ${plan.dbDialect} database`);
         await this.ensureDockerNetwork(plan.networkName);
-        await this.removeDockerContainerIfForced({
+        const existingContainerKept = await this.removeDockerContainerIfForced({
             containerName: plan.containerName,
             displayName: `built-in ${plan.dbDialect} container`,
             force: params.force,
         });
-        if (Install.shouldPublishBuiltinDbPort(params.downloadResults.source)) {
+        if (!existingContainerKept && Install.shouldPublishBuiltinDbPort(params.downloadResults.source)) {
             const portError = await validateAvailableTcpPort(plan.dbPort);
             if (portError) {
                 throw new Error(`Built-in ${plan.dbDialect} needs host port ${plan.dbPort}, but ${portError}`);
@@ -1291,8 +1314,9 @@ export default class Install extends Command {
             || defaultDockerRegistryForLang(process.env.NB_LOCALE);
         const version = String(downloadResultsValue(params.downloadResults, 'version') ?? '').trim() || 'latest';
         const appPort = String(params.appResults.appPort ?? DEFAULT_INSTALL_APP_PORT).trim() || DEFAULT_INSTALL_APP_PORT;
-        const storagePath = path.resolve(String(params.appResults.storagePath ?? '').trim()
-            || defaultInstallStoragePath(params.envName));
+        const storagePath = resolveConfiguredEnvPath(String(params.appResults.storagePath ?? '').trim()
+            || defaultInstallStoragePath(params.envName))
+            ?? resolveEnvRelativePath(defaultInstallStoragePath(params.envName));
         const dbDialect = String(params.dbResults.dbDialect ?? 'postgres').trim() || 'postgres';
         const dbHost = String(params.dbResults.dbHost ?? DEFAULT_INSTALL_DB_HOST).trim() || DEFAULT_INSTALL_DB_HOST;
         const dbPort = String(params.dbResults.dbPort ?? defaultDbPortForDialect(dbDialect)).trim()
@@ -1387,12 +1411,16 @@ export default class Install extends Command {
     }
     static buildDownloadArgvFromResults(results, options) {
         const argv = ['-y', '--no-intro'];
+        const source = String(results.source ?? '').trim();
         if (options?.verbose) {
             argv.push('--verbose');
         }
         Install.pushDownloadArgIfValue(argv, '--source', results.source);
-        Install.pushDownloadArgIfValue(argv, '--version', results.version);
-        Install.pushDownloadArgIfValue(argv, '--output-dir', results.outputDir);
+        Install.pushDownloadArgIfValue(argv, '--version', downloadResultsValue(results, 'version'));
+        Install.pushDownloadArgIfValue(argv, '--output-dir', source === 'npm' || source === 'git'
+            ? (resolveConfiguredEnvPath(results.outputDir)
+                ?? resolveConfiguredEnvPath(String(results.outputDir ?? '').trim() || defaultInstallAppRootPath(results.env)))
+            : results.outputDir);
         Install.pushDownloadArgIfValue(argv, '--git-url', results.gitUrl);
         Install.pushDownloadArgIfValue(argv, '--docker-registry', results.dockerRegistry);
         Install.pushDownloadArgIfValue(argv, '--docker-platform', results.dockerPlatform);
@@ -1422,7 +1450,12 @@ export default class Install extends Command {
         const outputDir = String(params.downloadResults.outputDir ?? '').trim()
             || String(params.appResults.appRootPath ?? '').trim()
             || defaultInstallAppRootPath(params.envName);
-        return path.resolve(process.cwd(), outputDir);
+        return resolveConfiguredEnvPath(outputDir) ?? resolveEnvRelativePath(defaultInstallAppRootPath(params.envName));
+    }
+    static resolveLocalProjectConfigPath(params) {
+        return (String(params.downloadResults.outputDir ?? '').trim()
+            || String(params.appResults.appRootPath ?? '').trim()
+            || defaultInstallAppRootPath(params.envName));
     }
     commandStdio(verbose) {
         return verbose ? 'inherit' : 'ignore';
@@ -1442,18 +1475,24 @@ export default class Install extends Command {
             downloadResults: params.downloadResults,
             verbose: params.verbose,
         });
-        const projectRoot = Install.resolveLocalProjectRoot({
+        const downloadedProjectRoot = Install.resolveLocalProjectRoot({
             envName: params.envName,
             appResults: params.appResults,
             downloadResults: params.downloadResults,
             downloadCommandResult: result,
         });
-        params.appResults.appRootPath = projectRoot;
-        return projectRoot;
+        params.appResults.appRootPath = Install.resolveLocalProjectConfigPath({
+            envName: params.envName,
+            appResults: params.appResults,
+            downloadResults: params.downloadResults,
+        });
+        return downloadedProjectRoot;
     }
     static buildLocalAppEnvVars(params) {
-        const storagePath = path.resolve(String(params.appResults.storagePath ?? '').trim()
-            || defaultInstallStoragePath(params.envName));
+        const configuredStoragePath = String(params.appResults.storagePath ?? '').trim()
+            || defaultInstallStoragePath(params.envName);
+        const storagePath = resolveConfiguredEnvPath(configuredStoragePath)
+            ?? resolveEnvRelativePath(defaultInstallStoragePath(params.envName));
         const dbDialect = String(params.dbResults.dbDialect ?? 'postgres').trim()
             || 'postgres';
         const appKey = crypto.randomBytes(32).toString('hex');
@@ -1646,8 +1685,6 @@ export default class Install extends Command {
         const argv = [
             params.envName,
             '--no-intro',
-            '--scope',
-            CONFIG_SCOPE,
             '--api-base-url',
             apiBaseUrl,
             '--auth-type',
@@ -1760,7 +1797,6 @@ export default class Install extends Command {
             },
             values: {
                 name: envName,
-                scope: 'project',
                 ...(resumePreset?.envAddPreset ?? {}),
             },
             yes,
@@ -1884,5 +1920,8 @@ export default class Install extends Command {
     }
 }
 function downloadResultsValue(downloadResults, key) {
+    if (key === 'version' && String(downloadResults.version ?? '').trim() === 'other') {
+        return downloadResults.otherVersion;
+    }
     return downloadResults[key];
 }

package/dist/commands/logs.js

@@ -49,13 +49,20 @@ export default class Logs extends Command {
         if (!runtime) {
             this.error(formatMissingManagedAppEnvMessage(requestedEnv));
         }
-        if (runtime.kind === 'remote') {
+        if (runtime.kind === 'http') {
             this.error([
                 `Can't show runtime logs for "${runtime.envName}" from this machine.`,
                 'This env only has an API connection, so there is no saved local app or Docker container to read logs from.',
                 'Connect it to a local checkout or reinstall it with npm, git, or Docker if you want CLI-managed logs.',
             ].join('\n'));
         }
+        if (runtime.kind === 'ssh') {
+            this.error([
+                `Can't show runtime logs for "${runtime.envName}" yet.`,
+                'SSH env support is reserved but not implemented yet.',
+                'Use a local or Docker env for CLI-managed logs for now.',
+            ].join('\n'));
+        }
         const tail = String(flags.tail ?? 100);
         const follow = flags.follow !== false;
         printInfo(follow

package/dist/commands/pm/list.js

@@ -11,7 +11,7 @@ import { formatMissingManagedAppEnvMessage, resolveManagedAppRuntime, runDockerN
 export default class PmList extends Command {
     static args = {};
     static summary = 'List plugins for the selected env';
-    static description = 'List installed plugins in the selected env (npm/git runs locally, Docker runs inside the saved app container, remote envs fall back to the API)';
+    static description = 'List installed plugins in the selected env (npm/git runs locally, Docker runs inside the saved app container, HTTP envs fall back to the API)';
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> -e local',
@@ -49,6 +49,13 @@ export default class PmList extends Command {
             }
             return;
         }
+        if (runtime.kind === 'ssh') {
+            this.error([
+                `Can't list plugins for "${runtime.envName}" yet.`,
+                'SSH env support is reserved but not implemented yet.',
+                'Use a local, Docker, or HTTP env for plugin inspection right now.',
+            ].join('\n'));
+        }
         await this.config.runCommand('api:pm:list', ['--mode=summary']);
     }
 }

package/dist/commands/ps.js

@@ -10,12 +10,15 @@ import { Command, Flags } from '@oclif/core';
 import { buildDockerDbContainerName, dockerContainerExists, dockerContainerIsRunning, formatMissingManagedAppEnvMessage, resolveManagedAppRuntime, } from '../lib/app-runtime.js';
 import { listEnvs } from '../lib/auth-store.js';
 import { renderTable } from '../lib/ui.js';
+function resolveApiBaseUrl(config) {
+    return String(config.apiBaseUrl ?? config.baseUrl ?? config.apibaseUrl ?? '').trim();
+}
 function appUrl(runtime) {
     const port = String(runtime.env.config.appPort ?? '').trim();
     if (port) {
         return `http://127.0.0.1:${port}`;
     }
-    const baseUrl = String(runtime.env.config.baseUrl ?? '').trim();
+    const baseUrl = resolveApiBaseUrl(runtime.env.config);
     return baseUrl.replace(/\/api\/?$/, '');
 }
 async function isLocalAppHealthy(runtime) {
@@ -47,30 +50,30 @@ async function dockerStatus(containerName) {
 }
 async function dbStatus(runtime) {
     if (!runtime.env.config.builtinDb) {
-        return runtime.kind === 'remote' ? 'external' : '-';
+        return runtime.kind === 'http' ? 'external' : '-';
     }
-    if (runtime.kind === 'remote') {
+    if (runtime.kind === 'http') {
         return 'external';
     }
+    if (runtime.kind === 'ssh') {
+        return '-';
+    }
     const dbDialect = String(runtime.env.config.dbDialect ?? 'postgres').trim() || 'postgres';
     const containerName = buildDockerDbContainerName(runtime.envName, dbDialect, runtime.workspaceName);
     return await dockerStatus(containerName);
 }
-async function appStatus(runtime) {
-    if (runtime.kind === 'remote') {
-        return 'remote';
+async function runtimeStatus(runtime) {
+    if (runtime.kind === 'http') {
+        return 'http';
+    }
+    if (runtime.kind === 'ssh') {
+        return 'ssh';
     }
     if (runtime.kind === 'docker') {
         return await dockerStatus(runtime.containerName);
     }
     return await isLocalAppHealthy(runtime) ? 'running' : 'stopped';
 }
-function sourceLabel(runtime) {
-    if (runtime.kind === 'remote') {
-        return 'remote';
-    }
-    return runtime.source;
-}
 export default class Ps extends Command {
     static description = 'Show NocoBase runtime status for configured envs without starting or stopping anything.';
     static examples = [
@@ -105,12 +108,12 @@ export default class Ps extends Command {
             }
             rows.push([
                 runtime.envName,
-                sourceLabel(runtime),
-                await appStatus(runtime),
+                runtime.kind,
+                await runtimeStatus(runtime),
                 await dbStatus(runtime),
                 appUrl(runtime),
             ]);
         }
-        this.log(renderTable(['Env', 'Source', 'App', 'Database', 'URL'], rows));
+        this.log(renderTable(['Env', 'Kind', 'Status', 'Database', 'URL'], rows));
     }
 }

package/dist/commands/self/check.js

@@ -59,7 +59,7 @@ export default class SelfCheck extends Command {
             ['Update available', status.updateAvailable ? 'yes' : 'no'],
         ]));
         if (status.updateAvailable && status.updatable) {
-            printInfo('Run `nb self update` to update the CLI.');
+            printInfo('Run `nb self update`.');
         }
         else if (status.updateAvailable && status.updateBlockedReason) {
             printInfo(status.updateBlockedReason);

package/dist/commands/self/update.js

@@ -7,7 +7,7 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 import { Command, Flags } from '@oclif/core';
-import { confirmAction } from '../../lib/ui.js';
+import { confirmAction, setVerboseMode } from '../../lib/ui.js';
 import { formatSelfUpdateUnavailableMessage, formatUnsupportedSelfUpdateMessage, inspectSelfStatus, updateSelf, } from '../../lib/self-manager.js';
 export default class SelfUpdate extends Command {
     static summary = 'Update the globally installed NocoBase CLI';
@@ -32,9 +32,14 @@ export default class SelfUpdate extends Command {
             description: 'Output the result as JSON',
             default: false,
         }),
+        verbose: Flags.boolean({
+            description: 'Show detailed update output',
+            default: false,
+        }),
     };
     async run() {
         const { flags } = await this.parse(SelfUpdate);
+        setVerboseMode(flags.verbose);
         const status = await inspectSelfStatus({
             channel: flags.channel,
         });
@@ -53,6 +58,7 @@ export default class SelfUpdate extends Command {
         }
         const result = await updateSelf({
             channel: flags.channel,
+            verbose: flags.verbose,
         });
         if (flags.json) {
             this.log(JSON.stringify({
@@ -68,9 +74,13 @@ export default class SelfUpdate extends Command {
             return;
         }
         if (result.action === 'noop') {
-            this.log(`NocoBase CLI is already up to date at ${result.status.currentVersion}.`);
+            this.log(flags.verbose
+                ? `NocoBase CLI is already up to date at ${result.status.currentVersion}.`
+                : `NocoBase CLI is up to date: ${result.status.currentVersion}.`);
             return;
         }
-        this.log(`Updated NocoBase CLI from ${result.status.currentVersion} using ${result.packageSpec}${result.targetVersion ? ` (latest ${result.status.channel} resolves to ${result.targetVersion})` : ''}.`);
+        this.log(flags.verbose
+            ? `Updated NocoBase CLI from ${result.status.currentVersion} using ${result.packageSpec}${result.targetVersion ? ` (latest ${result.status.channel} resolves to ${result.targetVersion})` : ''}.`
+            : `Updated NocoBase CLI: ${result.status.currentVersion} -> ${result.targetVersion}.`);
     }
 }

package/dist/commands/skills/check.js

@@ -10,8 +10,8 @@ import { Command, Flags } from '@oclif/core';
 import { inspectSkillsStatus } from '../../lib/skills-manager.js';
 import { printInfo, renderTable } from '../../lib/ui.js';
 export default class SkillsCheck extends Command {
-    static summary = 'Check the NocoBase AI coding skills installed for this workspace';
-    static description = 'Inspect the current workspace for NocoBase AI coding skills and report whether they are managed by the CLI and whether an update is available.';
+    static summary = 'Check the globally installed NocoBase AI coding skills';
+    static description = 'Inspect the global NocoBase AI coding skills and report whether they are managed by the CLI and whether an update is available.';
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> --json',
@@ -29,11 +29,15 @@ export default class SkillsCheck extends Command {
             this.log(JSON.stringify({
                 ok: true,
                 kind: 'skills',
+                globalRoot: status.globalRoot,
                 workspaceRoot: status.workspaceRoot,
                 installed: status.installed,
                 managedByNb: status.managedByNb,
                 sourcePackage: status.sourcePackage,
+                npmPackageName: status.npmPackageName,
                 installedSkillNames: status.installedSkillNames,
+                installedVersion: status.installedVersion,
+                latestVersion: status.latestVersion,
                 installedRef: status.installedRef,
                 latestRef: status.latestRef,
                 updateAvailable: status.updateAvailable,
@@ -43,18 +47,20 @@ export default class SkillsCheck extends Command {
             return;
         }
         this.log(renderTable(['Field', 'Value'], [
-            ['Workspace', status.workspaceRoot],
+            ['Skills home', status.globalRoot],
             ['Installed', status.installed ? 'yes' : 'no'],
             ['Managed by nb', status.managedByNb ? 'yes' : 'no'],
             ['Installed skills', status.installedSkillNames.length ? status.installedSkillNames.join(', ') : '(none)'],
+            ['Installed version', status.installedVersion ?? '(unknown)'],
+            ['Latest version', status.latestVersion ?? '(unknown)'],
             ['Update available', status.updateAvailable === null ? 'unknown' : status.updateAvailable ? 'yes' : 'no'],
         ]));
         if (!status.installed) {
-            printInfo('Run `nb skills install` to install the NocoBase AI coding skills for this workspace.');
+            printInfo('Run `nb skills install` to install the NocoBase AI coding skills globally.');
             return;
         }
         if (status.updateAvailable) {
-            printInfo('Run `nb skills update` to refresh the NocoBase AI coding skills for this workspace.');
+            printInfo('Run `nb skills update` to refresh the global NocoBase AI coding skills.');
         }
         if (status.registryError) {
             printInfo(`Update check warning: ${status.registryError}`);

package/dist/commands/skills/index.js

@@ -8,7 +8,7 @@
  */
 import { Command, loadHelpClass } from '@oclif/core';
 export default class Skills extends Command {
-    static summary = 'Inspect or synchronize NocoBase AI coding skills for this workspace';
+    static summary = 'Inspect or synchronize global NocoBase AI coding skills';
     async run() {
         await this.parse(Skills);
         const Help = await loadHelpClass(this.config);

package/dist/commands/skills/install.js

@@ -7,11 +7,11 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 import { Command, Flags } from '@oclif/core';
-import { confirmAction } from '../../lib/ui.js';
+import { confirmAction, setVerboseMode } from '../../lib/ui.js';
 import { installNocoBaseSkills } from '../../lib/skills-manager.js';
 export default class SkillsInstall extends Command {
-    static summary = 'Install the NocoBase AI coding skills for this workspace';
-    static description = 'Install the NocoBase AI coding skills for the current workspace. If they are already installed, this command does not update them.';
+    static summary = 'Install the NocoBase AI coding skills globally';
+    static description = 'Install the NocoBase AI coding skills globally. If they are already installed, this command does not update them.';
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> --yes',
@@ -27,32 +27,45 @@ export default class SkillsInstall extends Command {
             description: 'Output the result as JSON',
             default: false,
         }),
+        verbose: Flags.boolean({
+            description: 'Show detailed install output',
+            default: false,
+        }),
     };
     async run() {
         const { flags } = await this.parse(SkillsInstall);
+        setVerboseMode(flags.verbose);
         if (!flags.yes) {
-            const confirmed = await confirmAction('Install the NocoBase AI coding skills for this workspace?', { defaultValue: true });
+            const confirmed = await confirmAction('Install the NocoBase AI coding skills globally?', { defaultValue: true });
             if (!confirmed) {
                 this.log('Skipped skills install.');
                 return;
             }
         }
-        const result = await installNocoBaseSkills();
+        const result = await installNocoBaseSkills({
+            verbose: flags.verbose,
+        });
         if (flags.json) {
             this.log(JSON.stringify({
                 ok: true,
                 kind: 'skills',
                 action: result.action,
+                globalRoot: result.status.globalRoot,
                 workspaceRoot: result.status.workspaceRoot,
                 installedSkillNames: result.status.installedSkillNames,
+                installedVersion: result.status.installedVersion,
                 installedRef: result.status.installedRef,
             }, null, 2));
             return;
         }
         if (result.action === 'noop') {
-            this.log('NocoBase AI coding skills are already installed for this workspace. Run `nb skills update` to refresh them.');
+            this.log(flags.verbose
+                ? 'NocoBase AI coding skills are already installed globally. Run `nb skills update` to refresh them.'
+                : 'NocoBase AI coding skills are already installed globally.');
             return;
         }
-        this.log('Installed the NocoBase AI coding skills for this workspace.');
+        this.log(flags.verbose
+            ? 'Installed the NocoBase AI coding skills globally.'
+            : 'Installed NocoBase AI coding skills globally.');
     }
 }

package/dist/commands/skills/update.js

@@ -7,11 +7,11 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 import { Command, Flags } from '@oclif/core';
-import { confirmAction } from '../../lib/ui.js';
+import { confirmAction, setVerboseMode } from '../../lib/ui.js';
 import { updateNocoBaseSkills } from '../../lib/skills-manager.js';
 export default class SkillsUpdate extends Command {
-    static summary = 'Update the NocoBase AI coding skills for this workspace';
-    static description = 'Refresh the NocoBase AI coding skills for the current workspace. This command only updates an existing nocobase/skills install.';
+    static summary = 'Update the globally installed NocoBase AI coding skills';
+    static description = 'Refresh the globally installed NocoBase AI coding skills. This command only updates an existing @nocobase/skills install.';
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> --yes',
@@ -27,32 +27,45 @@ export default class SkillsUpdate extends Command {
             description: 'Output the result as JSON',
             default: false,
         }),
+        verbose: Flags.boolean({
+            description: 'Show detailed update output',
+            default: false,
+        }),
     };
     async run() {
         const { flags } = await this.parse(SkillsUpdate);
+        setVerboseMode(flags.verbose);
         if (!flags.yes) {
-            const confirmed = await confirmAction('Update the NocoBase AI coding skills for this workspace?', { defaultValue: true });
+            const confirmed = await confirmAction('Update the globally installed NocoBase AI coding skills?', { defaultValue: true });
             if (!confirmed) {
                 this.log('Skipped skills update.');
                 return;
             }
         }
-        const result = await updateNocoBaseSkills();
+        const result = await updateNocoBaseSkills({
+            verbose: flags.verbose,
+        });
         if (flags.json) {
             this.log(JSON.stringify({
                 ok: true,
                 kind: 'skills',
                 action: result.action,
+                globalRoot: result.status.globalRoot,
                 workspaceRoot: result.status.workspaceRoot,
                 installedSkillNames: result.status.installedSkillNames,
+                installedVersion: result.status.installedVersion,
                 installedRef: result.status.installedRef,
             }, null, 2));
             return;
         }
         if (result.action === 'noop') {
-            this.log('NocoBase AI coding skills are already up to date for this workspace.');
+            this.log(flags.verbose
+                ? 'NocoBase AI coding skills are already up to date globally.'
+                : 'NocoBase AI coding skills are up to date.');
             return;
         }
-        this.log('Updated the NocoBase AI coding skills for this workspace.');
+        this.log(flags.verbose
+            ? 'Updated the global NocoBase AI coding skills.'
+            : 'Updated NocoBase AI coding skills globally.');
     }
 }

package/dist/commands/start.js

@@ -111,13 +111,20 @@ export default class Start extends Command {
         if (!runtime) {
             this.error(formatMissingManagedAppEnvMessage(requestedEnv));
         }
-        if (runtime.kind === 'remote') {
+        if (runtime.kind === 'http') {
             this.error([
                 `Can't start "${runtime.envName}" from this machine.`,
                 'This env only has an API connection, so there is no saved local app or Docker runtime to launch here.',
                 'Connect it to a local checkout or reinstall it with npm, git, or Docker if you want CLI-managed start and stop.',
             ].join('\n'));
         }
+        if (runtime.kind === 'ssh') {
+            this.error([
+                `Can't start "${runtime.envName}" yet.`,
+                'SSH env support is reserved but not implemented yet.',
+                'Use a local or Docker env if you need CLI-managed start and stop right now.',
+            ].join('\n'));
+        }
         if (runtime.kind === 'docker') {
             const unsupportedFlags = [
                 flags.quickstart ? '--quickstart' : undefined,