@oiioii/cli 0.1.8 → 0.1.11

package/README.md

@@ -15,7 +15,9 @@ human-readable output and a stable JSON envelope for AI agents and automation.
 | `auth login` | Browser authorization for terminal/Codex/WorkBuddy/Kimi/Claude Code/DeepSeek, or explicit API Key persistence | Implemented |
 | `auth status` | Check configured authentication without exposing the API Key | Implemented |
 | `auth logout` | Remove locally persisted authentication without exposing the API Key | Implemented |
-| `workspace create/set/current/rename` | Create, configure, inspect, and rename workspaces | Implemented |
+| `workspace create/set/current/rename/open/delete` | Create, configure, inspect, and rename workspaces, including folder and subgroup placement | Implemented |
+| `workspaces list` / `workspace list` | List visible workspaces with names, conversation counts, pagination, and search in production | Implemented |
+| `workspace folder` / `workspace subgroup list` | Manage workspace folders and discover visible subgroup creation choices | Implemented |
 | `workspace assets list/download` | List workspace assets and download ready resources | Implemented |
 | `workspace canvas create` | Create ordered blank nodes, prompts, references, and groups without client-side layout | Implemented |
 | `workspace canvas node update` | Update prompt, generation parameters, and references on an empty canvas node | Implemented |
@@ -135,7 +137,7 @@ The default backend URL and browser authorization page are embedded into the gen
 
 | Build command | Environment | Embedded default backend | Authorization page |
 |---|---|---|---|
-| `npm run build:production` | production | `https://api.oiioii.ai` (optional `OIIOII_PRODUCTION_BASE_URL` override) | `https://oiioii.tv/auth/cli` |
+| `npm run build:production` | production | `https://api.oiioii.ai` (optional `OIIOII_PRODUCTION_BASE_URL` override) | `https://oiioii.ai/auth/cli` |
 | `npm run build:test` | test | `OIIOII_TEST_BASE_URL` from `.env` | Build-specific test authorization page |
 | `npm run build:local` | local | `http://localhost:4000` | `http://localhost:3000/auth/cli` |
 
@@ -261,6 +263,56 @@ oiioii workspace set <workspace_id> --json
 oiioii workspace current --json
 ```
 
+Open a workspace in the browser, or retrieve its URL without opening a browser:
+
+```bash
+oiioii workspace open <workspace_id>
+oiioii workspace open --no-browser --json
+```
+
+Workspace URLs use the authorization page's origin and `/space/<workspace_id>`:
+`https://oiioii.ai/space/<workspace_id>` in production. Omit the ID to use the
+active workspace. The browser uses its own login session; no API key is added to
+the URL.
+
+List workspaces or move one workspace to the recycle bin:
+
+```bash
+oiioii workspaces list --limit 20 --search "Project" --json
+oiioii workspace list --cursor <next_cursor> --json
+oiioii workspace delete <workspace_id> --json
+```
+
+Deletion uses the same lifecycle permission as the Web: the account owner or the
+workspace subgroup leader. It is soft deletion, and retries preserve the original
+trash timestamp. Omit the ID to delete the active workspace. These commands require
+a backend with `GET /v1/workspaces` and `POST /v1/workspace/delete`; they do not
+fall back to debug or the legacy text-list endpoint.
+
+Folder and subgroup placement is optional. Omit `--subgroup` to use the account's default subgroup, or pass `--public` to request public placement; `--public` and `--subgroup` cannot be combined. Sub-accounts can create only in their permitted subgroup. Creation preserves the active workspace unless `--set-current` is supplied.
+
+```bash
+oiioii workspace subgroup list --json
+oiioii workspace folder list --limit 20 --json
+oiioii workspace folder create --name "Project folder" --subgroup <subgroup_id> --json
+oiioii workspace create --name "New project" --folder <folder_id> --subgroup <subgroup_id> --json
+oiioii workspace create --name "Public project" --public --json
+oiioii workspace folder get <folder_id> --json
+oiioii workspace folder workspaces <folder_id> --limit 20 --json
+oiioii workspace folder move <folder_id> --workspace-id <workspace_id> --json
+oiioii workspace folder remove --workspace-id <workspace_id> --json
+oiioii workspace folder rename <folder_id> --name "Renamed folder" --json
+oiioii workspace folder favorite <folder_id> --json
+oiioii workspace folder unfavorite <folder_id> --json
+oiioii workspace folder trash <folder_id> --json
+oiioii workspace folder restore <folder_id> --json
+oiioii workspace folder purge <folder_id> --json
+```
+
+Folder writes and library asset deletion use POST. Upgrade the backend to one that provides the POST folder update/placement/purge and library deletion routes before upgrading the CLI. The backend retains its legacy PATCH, PUT, and DELETE routes for older clients.
+
+List responses include `has_more` and, when more rows exist, `next_cursor`. Pass that cursor using `--cursor` to fetch the next page. Trashing/restoring a folder applies to its contained projects; `purge` permanently deletes a trashed folder and its projects.
+
 Rename the active workspace, or pass an explicit workspace ID:
 
 ```bash