@coze/cli 0.3.2 → 0.3.3-alpha.05e9c5

package/README.md

@@ -96,6 +96,8 @@ View and switch workspaces to set the default Space ID for subsequent commands.
 | `coze space list`           | List all spaces under the current organization |
 | `coze space use <space_id>` | Set the default workspace                      |
 
+> By default, when no Space ID is configured, the CLI auto-selects the **first** available space. Install the [`default-space` plugin](#coze-plugin--plugin-management) to instead resolve the **default workspace configured on the server** for the current organization.
+
 ### `coze code` — Coze Coding
 
 #### Project
@@ -836,6 +838,40 @@ coze config set upgrade.channel beta   # track the beta channel
 
 Upgrade checks are automatically skipped in CI (the `CI` env var is set), for dev/local builds, and when `COZE_CLI_NO_UPDATE_NOTIFIER` is set. Version checks are throttled to at most once every **4 hours**; a failed background upgrade is retried at most once every **10 minutes**. In JSON output the hint is attached as `_notice.update` with a ready-to-run `command` field. See [`docs/design/auto-upgrade-and-skill-sync.md`](docs/design/auto-upgrade-and-skill-sync.md) for the full auto-upgrade and bundled-skill design.
 
+### `coze plugin` — Plugin Management
+
+Manage opt-in CLI plugins. A plugin's feature is enabled **only after the plugin is installed**; otherwise the CLI behaves exactly as before. "Installing" a plugin simply writes a switch to the local configuration (`plugins.<id>.enabled`) — no network access required, so these commands work without login.
+
+| Command                          | Description                                          |
+| -------------------------------- | ---------------------------------------------------- |
+| `coze plugin list`               | List all available plugins and their installed status |
+| `coze plugin install <id>`       | Install (enable) a plugin                            |
+| `coze plugin uninstall <id>`     | Uninstall (disable) a plugin                         |
+
+```bash
+# List plugins and whether each is installed
+coze plugin list
+
+# Enable the default-space plugin
+coze plugin install default-space
+
+# Disable it again
+coze plugin uninstall default-space
+```
+
+#### Built-in plugin: `default-space`
+
+Once installed, when you have **not** explicitly passed `--space-id`, the CLI resolves the **default workspace configured on the server** (for the current organization) instead of auto-selecting the first available space.
+
+Resolution priority (highest to lowest):
+
+1. `--space-id` command-line flag
+2. Server-side default workspace (when `default-space` is installed and the organization has one set)
+3. Stored `spaceId` in configuration
+4. First available space (fallback)
+
+> The default workspace is an organization-scoped concept. Under a personal account (no organization context), the plugin does nothing and the CLI falls back to the existing behavior.
+
 ### Other Commands
 
 | Command      | Description                                                       |