@nocobase/cli 2.1.0-alpha.16 → 2.1.0-alpha.18

package/LICENSE.txt

@@ -0,0 +1,107 @@
+Updated Date: February 24, 2026
+
+NocoBase License Agreement
+
+NOCOBASE PTE. LTD.，a Singaporean Exempt Private Company Limited by Shares with its principal place of business located at 112 ROBINSON ROAD, #03-01, SINGAPORE ("The Company") https://www.nocobase.com/ issues this License Agreement ("Agreement") to you. You, as an individual or a company ("The User"), will be deemed to voluntarily accept all terms of this Agreement by using NocoBase (including but not limited to obtaining NocoBase source code or installation package in any form, installing and using NocoBase, purchasing NocoBase commercial license and services, purchasing NocoBase commercial plugins). If the User does not agree to any term of this Agreement, or cannot accurately understand our interpretation of the relevant terms, please stop using it immediately.
+
+This Agreement applies to any use, quotation, contract, invoice, and all software delivered by the Company. The User and the Company or NocoBase's agents can no longer sign a separate license agreement for the sale and delivery of the software.
+
+The Company reserves the right to formulate and modify this Agreement from time to time as needed. If there are changes, the Company will announce them in the form of website announcements, without further individual notification. The changed Agreement will automatically take effect once it is announced, becoming part of this Agreement.
+
+==============
+1. Definitions
+==============
+
+1.1 "Software" refers to the NocoBase kernel and plugins placed in the same code repository as the kernel, including their source code, installation packages, images, and all their modifications, updates, and upgrades.
+
+1.2 "Community Edition" refers to the free version of the Software provided to the User through public channels.
+
+1.3 "Commercial Edition" refers to the paid version of the Software purchased by the User from the Company or its agents, downloaded through exclusive channels, and includes additional benefits. It consists of three versions: Standard Edition, Professional Edition, and Enterprise Edition.
+
+1.4 "Upper Layer Application" refers to a specific business use case application serving internal or external customers of the User, developed based on Software and Commercial Plugins, such as ERP/CRM.
+
+1.5 "Customer" refers to the clients who purchase the User's Upper Layer Application.
+
+1.6 "Third-Party Open Source Software" refers to open source software provided with Software and Commercial Plugins. They are licensed through various published open source software licenses or copyright notices accompanying such software.
+
+===================================
+2. Intellectual Property Protection
+===================================
+
+Except for Third-Party Open Source Software, the Company owns all copyrights, trademark rights, patent rights, trade secrets, and other intellectual property rights of the Software, and has registered and protected them in relevant countries and regions according to the "Paris Convention" or "TRIPS Agreement", ensuring that the intellectual property rights of the Software and Commercial Plugins are internationally recognized and protected.
+
+=============
+3. Disclaimer
+=============
+
+3.1 The User shall not use the Software and Commercial Plugins to engage in activities that contravene applicable laws and regulations or offend against public order or religious prohibitions. All legal liabilities and consequences arising from the User’s use shall be borne by the User.
+
+3.2 The Company shall not be liable for any direct, indirect, special, incidental, or consequential damages (including but not limited to loss of profits, business interruption, data loss, or business information disclosure) caused by the User's use of the Software and Commercial Plugins, even if it has been previously informed of the possibility of such damages.
+
+===============
+4. License Type
+===============
+
+4.1 This Agreement serves as the unified license agreement for NocoBase Software, applying to both the Community Edition and the Commercial Editions.
+
+4.2 This Agreement incorporates and references the full text of the Apache License, Version 2.0 ("Apache-2.0", available at: https://www.apache.org/licenses/LICENSE-2.0 ). Users must comply with the Apache-2.0 License as well as the supplementary terms set forth in this Agreement. In case of any inconsistency between Apache-2.0 and this Agreement, the supplementary terms of this Agreement shall prevail.
+
+================================================
+5. Rights and Obligations of Open Source License
+================================================
+
+5.1 The Software can be used for commercial purposes.
+
+5.2 It is not allowed to remove or change the brand, name, link, version number, license, and other information about NocoBase on the Software interface, except for the main LOGO in the upper left corner of the page.
+
+5.3 It is not allowed to remove or change all intellectual property statements about NocoBase in the code.
+
+5.4 It is not allowed to provide to the public any form of no-code, zero-code, low-code, AI platform SaaS/PaaS products using the original or modified Software.
+
+===============================
+6. Rights of Commercial License
+===============================
+
+6.1 Obtain a permanent commercial license of the Software.
+
+6.2 Get software upgrades and exclusive technical support during the upgrade validity period.
+
+6.3 The licensed Software can be used for commercial purposes with no restrictions on the number of applications and users.
+
+6.4 Can remove or change the brand, name, link, version number, license, and other information about NocoBase on the Software interface.
+
+6.5 The User holding a Professional or Enterprise Edition License can sell Upper Layer Application to its Customers.
+
+6.6 If there are other agreements in the contract for the above rights, the contract agreement shall prevail.
+
+====================================
+7. Obligations of Commercial License
+====================================
+
+7.1 It is not allowed to remove or change all intellectual property statements about NocoBase in the code.
+
+7.2 It is not allowed to sell, transfer, lease, share, gift, or distribute the Commercial License.
+
+7.3 It is not allowed to sell, transfer, lease, share, or distribute any form of no-code, zero-code, low-code, AI platform, or developer tools developed based on Software.
+
+7.4 It is not allowed to provide any form of no-code, zero-code, low-code, AI platform SaaS/PaaS products to the public using the original or modified Software.
+
+7.5 It is not allowed for the User holding a Standard Edition license to sell Upper Layer Application to Customers without a Commercial license.
+
+7.6 It is not allowed for the User holding a Professional or Enterprise Edition license to sell Upper Layer Application to Customers without a Commercial license with access to further development and configuration.
+
+7.7 If there is a violation of the above obligations or the terms of this Agreement, the rights owned by the User will be immediately terminated, the paid fees will not be refunded, and the Company reserves the right to pursue the User's legal responsibility.
+
+7.8 If there are other agreements in the contract for the above obligations, the contract agreement shall prevail.
+
+=============================================================
+8.  Legal Jurisdiction, Interpretation, and Dispute Resolution
+=============================================================
+
+8.1 Except for Mainland China, the interpretation, application, and all matters related to this agreement are subject to the jurisdiction of Singapore law.
+
+8.2 Any dispute related to this Agreement should first be resolved through friendly negotiation. If the negotiation fails to resolve the dispute, the dispute should be submitted to the International Chamber of Commerce (ICC) for arbitration. The arbitration venue should be Singapore, conducted in English.
+
+8.3 All terms and conditions of this Agreement shall be deemed enforceable to the maximum extent permitted by applicable law. If any term of this Agreement is deemed invalid by any applicable law, the invalidity of that term does not affect the validity of any other term of this Agreement, and it should be deemed that the invalid term has been modified as much as possible to make it valid and enforceable, or if the term cannot be modified, it should be deemed to have been deleted from this Agreement.
+
+8.4 The arbitration award is final, binding on both parties, and can be enforced in any court with jurisdiction.

package/README.md

@@ -1,99 +1,170 @@
-# NocoBase
+# NocoBase CTL
 
-<video width="100%" controls>
-  <source src="https://github.com/user-attachments/assets/4d11a87b-00e2-48f3-9bf7-389d21072d13" type="video/mp4">
-</video>
+NocoBase CTL is a command-line tool for managing and controlling NocoBase applications. Its relationship with multiple NocoBase App instances is shown below:
 
-<p align="center">
-<a href="https://trendshift.io/repositories/4112" target="_blank"><img src="https://trendshift.io/api/badge/repositories/4112" alt="nocobase%2Fnocobase | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
-<a href="https://www.producthunt.com/posts/nocobase?embed=true&utm_source=badge-top-post-topic-badge&utm_medium=badge&utm_souce=badge-nocobase" target="_blank"><img src="https://api.producthunt.com/widgets/embed-image/v1/top-post-topic-badge.svg?post_id=456520&theme=light&period=weekly&topic_id=267" alt="NocoBase - Scalability&#0045;first&#0044;&#0032;open&#0045;source&#0032;no&#0045;code&#0032;platform | Product Hunt" style="width: 250px; height: 54px;" width="250" height="54" /></a>
-</p>
+```
+                        +----------------------+
+                        |     NocoBase CTL     |
+                        |      Controller     |
+                        +----------------------+
+                                   |
+                  +----------------+----------------+
+                  |                |                |
+                  v                v                v
+        +----------------+ +----------------+ +----------------+
+        |  NocoBase App  | |  NocoBase App  | |  NocoBase App  |
+        |      Dev       | |      Test      | |      Prod      |
+        +----------------+ +----------------+ +----------------+
+```
 
-## What is NocoBase
+NocoBase CTL combines:
 
-NocoBase is the most extensible AI-powered no-code platform.   
-Total control. Infinite extensibility. AI collaboration.  
-Enable your team to adapt quickly and cut costs dramatically.  
-No years of development. No millions wasted.  
-Deploy NocoBase in minutes — and take control of everything.
+- built-in commands for environment management and generic resource access
+- runtime-generated commands loaded from your NocoBase application's Swagger schema
 
-Homepage:  
-https://www.nocobase.com/  
+This allows the CLI to stay aligned with the target application instead of relying on a fixed command list.
 
-Online Demo:  
-https://demo.nocobase.com/new
+## Quick Start
 
-Documents:  
-https://docs.nocobase.com/
+Install NocoBase CTL globally:
 
-Forum:  
-https://forum.nocobase.com/
+```bash
+npm install -g @nocobase/ctl@latest
+```
 
-Use Cases:  
-https://www.nocobase.com/en/blog/tags/customer-stories
+Add an environment:
 
-## Release Notes
+```bash
+nb env add --name local --base-url http://localhost:13000/api
+```
 
-Our [blog](https://www.nocobase.com/en/blog/timeline) is regularly updated with release notes and provides a weekly summary.
+Add an environment with an API key:
 
-## Distinctive features
+```bash
+nb env add --name local --base-url http://localhost:13000/api --token <api-key>
+```
 
-### 1. Data model-driven, not form/table–driven
+Authenticate an environment with OAuth:
 
-Instead of being constrained by forms or tables, NocoBase adopts a data model–driven approach, separating data structure from user interface to unlock unlimited possibilities.
+```bash
+nb env auth -e local
+```
 
-- UI and data structure are fully decoupled
-- Multiple blocks and actions can be created for the same table or record in any quantity or form
-- Supports the main database, external databases, and third-party APIs as data sources
+Show the current environment:
 
-![model](https://static-docs.nocobase.com/model.png)
+```bash
+nb env
+```
 
-### 2. AI employees, integrated into your business systems
-Unlike standalone AI demos, NocoBase allows you to embed AI capabilities seamlessly into your interfaces, workflows, and data context, making AI truly useful in real business scenarios.
+List configured environments:
 
-- Define AI employees for roles such as translator, analyst, researcher, or assistant
-- Seamless AI–human collaboration in interfaces and workflows
-- Ensure AI usage is secure, transparent, and customizable for your business needs
+```bash
+nb env list
+```
 
-![AI-employee](https://static-docs.nocobase.com/ai-employee-home.png)
+Switch the current environment:
 
-### 3. What you see is what you get, incredibly easy to use
+```bash
+nb env use local
+```
 
-While enabling the development of complex business systems, NocoBase keeps the experience simple and intuitive.
+Update the runtime command cache from `swagger:get`:
 
-- One-click switch between usage mode and configuration mode
-- Pages serve as a canvas to arrange blocks and actions, similar to Notion
-- Configuration mode is designed for ordinary users, not just programmers
+```bash
+nb env update
+nb env update -e local
+```
 
-![wysiwyg](https://static-docs.nocobase.com/wysiwyg.gif)
+Use the generic resource commands:
 
-### 4. Everything is a plugin, designed for extension
-Adding more no-code features will never cover every business case. NocoBase is built for extension through its plugin-based microkernel architecture.
+```bash
+nb api resource list --resource users
+nb api resource get --resource users --filter-by-tk 1
+nb api resource create --resource users --values '{"nickname":"Ada"}'
+```
 
-- All functionalities are plugins, similar to WordPress
-- Plugins are ready to use upon installation
-- Pages, blocks, actions, APIs, and data sources can all be extended through custom plugins
+## Runtime Commands
 
-![plugins](https://static-docs.nocobase.com/plugins.png)
+When you execute a runtime command, the CLI will:
 
-## Installation
+1. resolve the target environment
+2. read the application's Swagger schema from `swagger:get`
+3. generate or reuse a cached runtime command set for that application version
+4. execute the requested command
 
-NocoBase supports three installation methods:
+If the `API documentation plugin` is disabled, the CLI will prompt to enable it.
 
-- <a target="_blank" href="https://docs.nocobase.com/welcome/getting-started/installation/docker-compose">Installing With Docker (👍Recommended)</a>
+## Environment Selection
 
-  Suitable for no-code scenarios, no code to write. When upgrading, just download the latest image and reboot.
+Use `-e, --env` to temporarily select an environment:
 
-- <a target="_blank" href="https://docs.nocobase.com/welcome/getting-started/installation/create-nocobase-app">Installing from create-nocobase-app CLI</a>
+```bash
+nb env update -e prod
+nb api resource list --resource users -e prod
+```
 
-  The business code of the project is completely independent and supports low-code development.
+This does not change the current environment unless you explicitly run:
 
-- <a target="_blank" href="https://docs.nocobase.com/welcome/getting-started/installation/git-clone">Installing from Git source code</a>
+```bash
+nb env use <name>
+```
 
-  If you want to experience the latest unreleased version, or want to participate in the contribution, you need to make changes and debug on the source code, it is recommended to choose this installation method, which requires a high level of development skills, and if the code has been updated, you can git pull the latest code.
+## Config Scope
 
-## How NocoBase works
+The `env` command supports two config scopes:
 
-<video width="100%" controls>
-  <source src="https://github.com/user-attachments/assets/8d183b44-9bb5-4792-b08f-bc08fe8dfaaf" type="video/mp4">
-</video>
+- `project`: use `./.nocobase-ctl` in the current working directory
+- `global`: use the global `.nocobase-ctl` directory
+
+Use `-s, --scope` to select one explicitly:
+
+```bash
+nb env list -s project
+nb env add -s global --name prod --base-url http://example.com/api --token <api-key>
+nb env auth -e prod -s global
+nb env use local -s project
+```
+
+If you do not pass `--scope`, the CLI uses automatic resolution:
+
+1. current working directory if `./.nocobase-ctl` exists
+2. `NOCOBASE_HOME_CLI`
+3. your home directory
+
+## Built-in Commands
+
+Current built-in topics:
+
+- `env`
+- `api`
+
+Check available commands at any time:
+
+```bash
+nb --help
+nb env --help
+nb api resource --help
+```
+
+## Common Flags
+
+- `-e, --env`: temporary environment selection
+- `-s, --scope`: config scope for `env` commands
+- `--role`: role override, sent as `X-Role`
+- `-t, --token`: API key override
+- `-j, --json-output`: print raw JSON response
+
+Example:
+
+```bash
+nb env update -e prod -s global
+nb api resource list --resource users -e prod -j
+nb api resource list --resource users -e prod --role admin
+```
+
+## Local Data
+
+The CLI stores its local state in `.nocobase-ctl`, including:
+
+- `config.json`: environment definitions and current selection
+- `versions/<version>/commands.json`: cached runtime commands for a generated version

package/bin/run.cmd

@@ -0,0 +1,3 @@
+@echo off
+
+node "%~dp0\run" %*

package/bin/run.js

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+
+import { spawnSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const root = path.resolve(__dirname, '..');
+const realRoot = fs.realpathSync(root);
+const isSourcePackage = realRoot.split(path.sep).join('/').endsWith('/packages/core/cli');
+
+/**
+ * In the monorepo, plain `node` cannot load `.ts`. Re-exec once with `--import tsx`
+ * (same effect as a dedicated dev entry with `#!/usr/bin/env -S node --import tsx`).
+ */
+function reexecWithTsx() {
+  const result = spawnSync(
+    process.execPath,
+    ['--import', 'tsx', '--disable-warning=ExperimentalWarning', ...process.argv.slice(1)],
+    {
+      stdio: 'inherit',
+      env: {
+        ...process.env,
+        _NOCO_CLI_TSX_CHILD: '1',
+        NODE_ENV: 'development',
+      },
+    },
+  );
+  process.exit(result.status === null ? 1 : result.status);
+}
+
+if (isSourcePackage && !process.env._NOCO_CLI_TSX_CHILD) {
+  reexecWithTsx();
+}
+
+const bootstrapPath = isSourcePackage
+  ? path.join(root, 'src/lib/bootstrap.ts')
+  : path.join(root, 'dist/lib/bootstrap.js');
+const { ensureRuntimeFromArgv } = await import(pathToFileURL(bootstrapPath).href);
+const { flush, run, settings } = await import('@oclif/core');
+
+if (isSourcePackage) {
+  settings.debug = true;
+}
+
+function getCommandToken(argv) {
+  for (const token of argv) {
+    if (!token || token.startsWith('-')) {
+      continue;
+    }
+
+    return token;
+  }
+
+  return undefined;
+}
+
+function formatCliEntryError(error, argv) {
+  const message = error instanceof Error ? error.message : String(error);
+  const missingCommandMatch = message.match(/^Command (.+) not found\.$/);
+  if (missingCommandMatch) {
+    const commandToken = getCommandToken(argv) ?? missingCommandMatch[1];
+    return [
+      `Unknown command: \`${commandToken}\`.`,
+      'If this is a built-in command or a typo, run `nb --help` to inspect available commands.',
+      `If \`${commandToken}\` should be a runtime command from your NocoBase app, run \`nb env update\` and try again.`,
+    ].join('\n');
+  }
+
+  return message;
+}
+
+try {
+  const argv = process.argv.slice(2);
+  if (argv[0] === 'api') {
+    await ensureRuntimeFromArgv(argv, {
+      configFile: path.join(root, 'nocobase-ctl.config.json'),
+    });
+  }
+  await run(argv, import.meta.url);
+  flush();
+} catch (error) {
+  const message = formatCliEntryError(error, process.argv.slice(2));
+  console.error(message);
+  process.exitCode = 1;
+}

package/dist/commands/api/index.js

@@ -0,0 +1,8 @@
+import { Command } from '@oclif/core';
+export default class Api extends Command {
+    static summary = 'Work with NocoBase APIs, environments, resources, and runtime commands';
+    static id = 'api';
+    async run() {
+        this.log('Use `nb api --help` to view available subcommands.');
+    }
+}

package/dist/commands/env/add.js

@@ -0,0 +1,53 @@
+import { Command, Flags } from '@oclif/core';
+import { upsertEnv } from '../../lib/auth-store.js';
+import { formatCliHomeScope } from '../../lib/cli-home.js';
+import { isInteractiveTerminal, printVerbose, promptText, setVerboseMode } from '../../lib/ui.js';
+export default class EnvAdd extends Command {
+    static summary = 'Add or update a NocoBase environment';
+    static id = 'env add';
+    static flags = {
+        verbose: Flags.boolean({
+            description: 'Show detailed progress output',
+            default: false,
+        }),
+        name: Flags.string({
+            description: 'Environment name',
+            default: 'default',
+        }),
+        scope: Flags.string({
+            char: 's',
+            description: 'Config scope',
+            options: ['project', 'global'],
+        }),
+        'base-url': Flags.string({
+            description: 'NocoBase API base URL, for example http://localhost:13000/api',
+        }),
+        token: Flags.string({
+            char: 't',
+            description: 'API key',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(EnvAdd);
+        setVerboseMode(flags.verbose);
+        const name = flags.name || 'default';
+        const scope = flags.scope;
+        const baseUrl = flags['base-url'] ||
+            (isInteractiveTerminal()
+                ? await promptText('Base URL', { defaultValue: 'http://localhost:13000/api' })
+                : '');
+        if (Object.keys(flags).includes('token') && !flags.token) {
+            flags.token = isInteractiveTerminal() ? await promptText('API key (optional)', { secret: true }) : '';
+            if (!flags.token) {
+                this.error('API key cannot be empty if --token flag is provided without a value.');
+            }
+        }
+        const token = flags.token;
+        if (!baseUrl) {
+            this.error('Missing base URL. Pass `--base-url <url>` or run in a TTY to enter it interactively.');
+        }
+        printVerbose(`Saving env "${name}" with base URL ${baseUrl}`);
+        await upsertEnv(name, baseUrl, token, { scope });
+        this.log(`Saved env "${name}" and set it as current${scope ? ` in ${formatCliHomeScope(scope)} scope` : ''}.`);
+    }
+}

package/dist/commands/env/auth.js

@@ -0,0 +1,36 @@
+import { Command, Flags } from '@oclif/core';
+import { formatCliHomeScope } from '../../lib/cli-home.js';
+import { authenticateEnvWithOauth } from '../../lib/env-auth.js';
+import { failTask, startTask, succeedTask } from '../../lib/ui.js';
+export default class EnvAuth extends Command {
+    static summary = 'Authenticate an environment with OAuth';
+    static id = 'env auth';
+    static flags = {
+        env: Flags.string({
+            char: 'e',
+            description: 'Environment name',
+        }),
+        scope: Flags.string({
+            char: 's',
+            description: 'Config scope',
+            options: ['project', 'global'],
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(EnvAuth);
+        const scope = flags.scope;
+        const envLabel = flags.env ?? 'current';
+        startTask(`Authenticating env: ${envLabel}${scope ? ` (${formatCliHomeScope(scope)})` : ''}`);
+        try {
+            await authenticateEnvWithOauth({
+                envName: flags.env,
+                scope,
+            });
+            succeedTask(`Authenticated env "${envLabel}" with OAuth${scope ? ` in ${formatCliHomeScope(scope)} scope` : ''}.`);
+        }
+        catch (error) {
+            failTask(`Failed to authenticate env "${envLabel}".`);
+            throw error;
+        }
+    }
+}

package/dist/commands/env/index.js

@@ -0,0 +1,27 @@
+import { Command, Flags } from '@oclif/core';
+import { getCurrentEnvName, getEnv } from '../../lib/auth-store.js';
+import { formatCliHomeScope } from '../../lib/cli-home.js';
+import { renderTable } from '../../lib/ui.js';
+export default class Env extends Command {
+    static summary = 'Show the current environment';
+    static id = 'env';
+    static flags = {
+        scope: Flags.string({
+            char: 's',
+            description: 'Config scope',
+            options: ['project', 'global'],
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(Env);
+        const scope = flags.scope;
+        const envName = await getCurrentEnvName({ scope });
+        const env = await getEnv(envName, { scope });
+        if (!env?.baseUrl) {
+            this.log(`No current env is configured${scope ? ` in ${formatCliHomeScope(scope)} scope` : ''}.`);
+            this.log('Run `nb env add --name <name> --base-url <url>` to add one.');
+            return;
+        }
+        this.log(renderTable(['Name', 'Base URL', 'Auth', 'Runtime'], [[envName, env?.baseUrl ?? '', env?.auth?.type ?? '', env?.runtime?.version ?? '']]));
+    }
+}

package/dist/commands/env/list.js

@@ -0,0 +1,31 @@
+import { Command, Flags } from '@oclif/core';
+import { listEnvs } from '../../lib/auth-store.js';
+import { formatCliHomeScope } from '../../lib/cli-home.js';
+import { renderTable } from '../../lib/ui.js';
+export default class EnvList extends Command {
+    static summary = 'List configured environments';
+    static id = 'env list';
+    static flags = {
+        scope: Flags.string({
+            char: 's',
+            description: 'Config scope',
+            options: ['project', 'global'],
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(EnvList);
+        const scope = flags.scope;
+        const { currentEnv, envs } = await listEnvs({ scope });
+        const names = Object.keys(envs).sort();
+        if (!names.length) {
+            this.log(`No envs configured${scope ? ` in ${formatCliHomeScope(scope)} scope` : ''}.`);
+            this.log('Run `nb env add --name <name> --base-url <url>` to add one.');
+            return;
+        }
+        const rows = names.map((name) => {
+            const env = envs[name];
+            return [name === currentEnv ? '*' : '', name, env.baseUrl ?? '', env.auth?.type ?? '', env.runtime?.version ?? ''];
+        });
+        this.log(renderTable(['Current', 'Name', 'Base URL', 'Auth', 'Runtime'], rows));
+    }
+}

package/dist/commands/env/remove.js

@@ -0,0 +1,54 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { getCurrentEnvName, removeEnv } from '../../lib/auth-store.js';
+import { formatCliHomeScope } from '../../lib/cli-home.js';
+import { confirmAction, isInteractiveTerminal, printVerbose, setVerboseMode } from '../../lib/ui.js';
+export default class EnvRemove extends Command {
+    static id = 'env remove';
+    static summary = 'Remove a configured environment';
+    static flags = {
+        force: Flags.boolean({
+            char: 'f',
+            description: 'Remove without confirmation',
+            default: false,
+        }),
+        verbose: Flags.boolean({
+            description: 'Show detailed progress output',
+            default: false,
+        }),
+        scope: Flags.string({
+            char: 's',
+            description: 'Config scope',
+            options: ['project', 'global'],
+        }),
+    };
+    static args = {
+        name: Args.string({
+            description: 'Configured environment name',
+            required: true,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(EnvRemove);
+        setVerboseMode(flags.verbose);
+        const scope = flags.scope;
+        const currentEnv = await getCurrentEnvName({ scope });
+        if (args.name === currentEnv && !flags.force) {
+            if (!isInteractiveTerminal()) {
+                this.error('Refusing to remove the current env without confirmation. Re-run with `--force`.');
+            }
+            const confirmed = await confirmAction(`Remove current env "${args.name}"?`, { defaultValue: false });
+            if (!confirmed) {
+                this.log('Canceled.');
+                return;
+            }
+        }
+        printVerbose(`Removing env "${args.name}"`);
+        const result = await removeEnv(args.name, { scope });
+        this.log(`Removed env "${result.removed}"${scope ? ` from ${formatCliHomeScope(scope)} scope` : ''}.`);
+        if (result.hasEnvs) {
+            this.log(`Current env: ${result.currentEnv}`);
+            return;
+        }
+        this.log('No envs configured.');
+    }
+}