@serve.zone/cli 5.3.0 → 5.5.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serve.zone/cli",
-  "version": "5.3.0",
+  "version": "5.5.1",
   "type": "module",
   "description": "",
   "exports": {
@@ -9,11 +9,11 @@
     }
   },
   "dependencies": {
-    "@serve.zone/api": "5.3.0",
-    "@serve.zone/interfaces": "5.3.0",
-    "@push.rocks/projectinfo": "^5.0.1",
-    "@push.rocks/qenv": "^6.1.3",
-    "@push.rocks/smartcli": "^4.0.11"
+    "@serve.zone/api": "^5.3.5",
+    "@serve.zone/interfaces": "^5.5.0",
+    "@push.rocks/projectinfo": "^5.1.0",
+    "@push.rocks/qenv": "^6.1.4",
+    "@push.rocks/smartcli": "^4.0.21"
   },
   "devDependencies": {
     "@git.zone/tsbuild": "2.1.67"
@@ -27,13 +27,13 @@
     "dist_ts_web/**/*",
     "assets/**/*",
     "cli.js",
-    "npmextra.json",
+    ".smartconfig.json",
     "readme.md"
   ],
   "bin": {
     "servezone": "./cli.js"
   },
   "scripts": {
-    "build": "tsbuild tsfolders --allowimplicitany"
+    "build": "tsbuild tsfolders"
   }
 }

package/readme.md

@@ -1,358 +1,105 @@
-# @serve.zone/cli 🚀
+# @serve.zone/cli
 
-**Command-line interface for Cloudly.** Manage your multi-cloud infrastructure from the terminal with powerful, intuitive commands.
+`@serve.zone/cli` is the published Cloudly CLI submodule. It provides the `servezone` binary and currently acts as a thin environment-driven client for connecting to a Cloudly control plane and listing clusters through `@serve.zone/api`.
 
-## 🎯 What is @serve.zone/cli?
+## Issue Reporting and Security
 
-The Cloudly CLI brings the full power of the Cloudly platform to your terminal. Whether you're automating deployments, managing secrets, or monitoring services, the CLI provides a streamlined interface for all your cloud operations.
+For reporting bugs, issues, or security vulnerabilities, please visit [community.foss.global/](https://community.foss.global/). This is the central community hub for all issue reporting. Developers who sign and comply with our contribution agreement and go through identification can also get a [code.foss.global/](https://code.foss.global/) account to submit Pull Requests directly.
 
-## ✨ Features
+## Current Scope
 
-- **⚡ Fast & Efficient** - Optimized for speed and minimal resource usage
-- **🔐 Secure Authentication** - Token-based authentication with secure storage
-- **📝 Intuitive Commands** - Clear, consistent command structure
-- **🎨 Formatted Output** - Beautiful, readable output with color coding
-- **🔄 Scriptable** - Perfect for CI/CD pipelines and automation
-- **📊 Comprehensive** - Access to all Cloudly features from the terminal
+This submodule is intentionally small in the current codebase:
 
-## 🚀 Installation
+- Reads `CLOUDLY_URL` through `@push.rocks/qenv`.
+- Authenticates with either `CLOUDLY_TOKEN` or `CLOUDLY_USERNAME` plus `CLOUDLY_PASSWORD`.
+- Starts a `CloudlyApiClient` registered as `cli`.
+- Creates a `CliClient` wrapper around the API client.
+- Calls `CliClient.getClusters()` and prints the result.
 
-### Global Installation (Recommended)
+It is not currently a full command tree for services, secrets, deployments, logs, profiles, or shell completion. Those flows should be implemented against `@serve.zone/api` before documenting them as CLI commands.
 
-```bash
-pnpm add -g @serve.zone/cli
-```
-
-### Local Installation
-
-```bash
-pnpm add @serve.zone/cli
-```
-
-## 🎬 Quick Start
-
-```bash
-# Configure your Cloudly instance
-servezone config --url https://cloudly.example.com
-
-# Login with your service token
-servezone login --token your-service-token
-
-# List your clusters
-servezone clusters list
-
-# Deploy a service
-servezone deploy --cluster production --image myapp:latest
-```
-
-## 🔑 Authentication
-
-### Initial Setup
-
-```bash
-# Set your Cloudly instance URL
-servezone config --url https://cloudly.example.com
-
-# Authenticate with a service token
-servezone login --token YOUR_SERVICE_TOKEN
-
-# Or use environment variables
-export CLOUDLY_URL=https://cloudly.example.com
-export CLOUDLY_TOKEN=YOUR_SERVICE_TOKEN
-```
-
-### Managing Profiles
-
-```bash
-# Create a profile for different environments
-servezone profile create production --url https://prod.cloudly.com
-servezone profile create staging --url https://stage.cloudly.com
-
-# Switch between profiles
-servezone profile use production
-
-# List all profiles
-servezone profile list
-```
-
-## 📚 Core Commands
-
-### 🌐 Cluster Management
-
-```bash
-# List all clusters
-servezone clusters list
-
-# Get cluster details
-servezone clusters info production-cluster
-
-# Create a new cluster
-servezone clusters create \
-  --name production-cluster \
-  --region eu-central \
-  --nodes 3
-
-# Scale a cluster
-servezone clusters scale production-cluster --nodes 5
-
-# Delete a cluster
-servezone clusters delete staging-cluster
-```
-
-### 🐳 Service Deployment
-
-```bash
-# Deploy a service
-servezone deploy \
-  --cluster production \
-  --name api-service \
-  --image myapp:2.0.0 \
-  --replicas 3 \
-  --port 80:3000
-
-# Update a service
-servezone service update api-service \
-  --image myapp:2.1.0 \
-  --replicas 5
-
-# Scale a service
-servezone service scale api-service --replicas 10
-
-# Remove a service
-servezone service remove api-service
-```
-
-### 🔐 Secret Management
-
-```bash
-# Create a secret
-servezone secrets create \
-  --name database-url \
-  --value "postgres://user:pass@host/db"
-
-# Create a secret group
-servezone secrets create-group \
-  --name api-secrets \
-  --secret DATABASE_URL=postgres://... \
-  --secret REDIS_URL=redis://...
-
-# List secrets
-servezone secrets list
-
-# Get secret value
-servezone secrets get database-url
-
-# Delete a secret
-servezone secrets delete old-secret
-```
-
-### 📦 Image Management
-
-```bash
-# List images
-servezone images list
-
-# Push a new image
-servezone images push \
-  --name myapp \
-  --version 2.0.0 \
-  --file ./myapp.tar
-
-# Tag an image
-servezone images tag myapp:2.0.0 myapp:latest
-
-# Delete an image
-servezone images delete myapp:1.0.0
-```
-
-### 📊 Monitoring & Logs
-
-```bash
-# View service logs
-servezone logs api-service
-
-# Follow logs in real-time
-servezone logs api-service --follow
-
-# Filter logs
-servezone logs api-service --since 1h --grep ERROR
-
-# Get service status
-servezone service status api-service
-
-# Monitor cluster health
-servezone clusters health production-cluster
-```
-
-### 🔧 DNS Management
-
-```bash
-# List DNS records
-servezone dns list --domain example.com
-
-# Create a DNS record
-servezone dns create \
-  --domain example.com \
-  --name api \
-  --type A \
-  --value 192.168.1.1
-
-# Update a DNS record
-servezone dns update api.example.com --value 192.168.1.2
-
-# Delete a DNS record
-servezone dns delete old.example.com
-```
-
-## 🎯 Advanced Usage
+## Installation
 
-### Environment Variables
+The package is published from `cloudly/ts_cliclient` via `tspublish.json` under the name `@serve.zone/cli` with the `servezone` binary.
 
-```bash
-# Set environment variables for a service
-servezone deploy \
-  --name api-service \
-  --env NODE_ENV=production \
-  --env PORT=3000 \
-  --env DATABASE_URL=@secret:database-url
-```
-
-### Configuration Files
-
-Create a `cloudly.yaml` file:
-
-```yaml
-cluster: production
-service:
-  name: api-service
-  image: myapp:latest
-  replicas: 3
-  ports:
-    - 80:3000
-  environment:
-    NODE_ENV: production
-    DATABASE_URL: "@secret:database-url"
+```sh
+pnpm add -g @serve.zone/cli
 ```
 
-Deploy using the config file:
+For local development inside the Cloudly repository, build the parent package:
 
-```bash
-servezone deploy --config cloudly.yaml
+```sh
+pnpm install
+pnpm build
 ```
 
-### Batch Operations
+## Usage
 
-```bash
-# Deploy multiple services
-servezone deploy --config services/*.yaml
+Authenticate with a machine token:
 
-# Update all services in a namespace
-servezone service update --namespace api --image-tag v2.0.0
-
-# Delete all staging resources
-servezone cleanup --environment staging
+```sh
+CLOUDLY_URL=https://cloudly.example.com \
+CLOUDLY_TOKEN=cluster-or-api-token \
+servezone
 ```
 
-## 🔄 CI/CD Integration
-
-### GitHub Actions
+Authenticate with username and password:
 
-```yaml
-- name: Deploy to Cloudly
-  run: |
-    servezone config --url ${{ secrets.CLOUDLY_URL }}
-    servezone login --token ${{ secrets.CLOUDLY_TOKEN }}
-    servezone deploy \
-      --cluster production \
-      --name api-service \
-      --image myapp:${{ github.sha }}
+```sh
+CLOUDLY_URL=https://cloudly.example.com \
+CLOUDLY_USERNAME=admin \
+CLOUDLY_PASSWORD=change-me \
+servezone
 ```
 
-### GitLab CI
+When `CLOUDLY_TOKEN` is present, the CLI requests a stateful identity and asks Cloudly to tag the WebSocket connection. When username/password are present instead, it uses Cloudly's admin login flow. If no credentials are provided, the CLI prints a warning before attempting the default cluster-list operation.
 
-```yaml
-deploy:
-  script:
-    - servezone config --url $CLOUDLY_URL
-    - servezone login --token $CLOUDLY_TOKEN
-    - servezone deploy --config cloudly.yaml
-```
+## Programmatic Use
 
-## 🎨 Output Formats
+The submodule exports the `runCli()` entry point and uses `CliClient` internally:
 
-```bash
-# JSON output for scripting
-servezone clusters list --output json
+```ts
+import { CloudlyApiClient } from '@serve.zone/api';
+import { CliClient } from './classes.cliclient.js';
 
-# YAML output
-servezone service info api-service --output yaml
+const apiClient = new CloudlyApiClient({
+  registerAs: 'cli',
+  cloudlyUrl: 'https://cloudly.example.com',
+});
 
-# Table output (default)
-servezone images list --output table
+await apiClient.start();
+await apiClient.loginWithUsernameAndPassword('admin', 'change-me');
 
-# Quiet mode (IDs only)
-servezone clusters list --quiet
+const cli = new CliClient(apiClient);
+await cli.getClusters();
 ```
 
-## 🛠️ Troubleshooting
+## Files
 
-```bash
-# Enable debug output
-servezone --debug clusters list
-
-# Check CLI version
-servezone version
-
-# Test connection
-servezone ping
-
-# View configuration
-servezone config show
-
-# Clear cache and credentials
-servezone logout --clear-cache
-```
-
-## 📝 Command Reference
-
-```bash
-servezone --help                    # Show all commands
-servezone <command> --help          # Show command-specific help
-servezone clusters --help           # Show cluster commands
-servezone service --help            # Show service commands
-servezone secrets --help            # Show secret commands
-```
-
-## 🔌 Shell Completion
-
-Enable tab completion for your shell:
-
-```bash
-# Bash
-servezone completion bash > /etc/bash_completion.d/servezone
-
-# Zsh
-servezone completion zsh > ~/.zsh/completions/_servezone
-
-# Fish
-servezone completion fish > ~/.config/fish/completions/servezone.fish
-```
+| Path | Purpose |
+| --- | --- |
+| `index.ts` | Runtime entry point for the published CLI. |
+| `classes.cliclient.ts` | Minimal client wrapper; currently exposes `getClusters()`. |
+| `plugins.ts` | Centralized imports for the submodule. |
+| `tspublish.json` | Published package name, dependencies, registry targets, and `servezone` bin metadata. |
 
 ## License and Legal Information
 
-This repository contains open-source code that is licensed under the MIT License. A copy of the MIT License can be found in the [license](license) file within this repository. 
+This repository contains open-source code licensed under the MIT License. A copy of the license can be found in the [license](../license) file.
 
 **Please note:** The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.
 
 ### Trademarks
 
-This project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH and are not included within the scope of the MIT license granted herein. Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines, and any usage must be approved in writing by Task Venture Capital GmbH.
+This project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH or third parties, and are not included within the scope of the MIT license granted herein.
+
+Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines or the guidelines of the respective third-party owners, and any usage must be approved in writing. Third-party trademarks used herein are the property of their respective owners and used only in a descriptive manner, e.g. for an implementation of an API or similar.
 
 ### Company Information
 
 Task Venture Capital GmbH  
-Registered at District court Bremen HRB 35230 HB, Germany
+Registered at District Court Bremen HRB 35230 HB, Germany
 
-For any legal inquiries or if you require further information, please contact us via email at hello@task.vc.
+For any legal inquiries or further information, please contact us via email at hello@task.vc.
 
-By using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.
+By using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.

package/ts_cliclient/index.ts

@@ -1,11 +1,28 @@
 import * as plugins from './plugins.js';
-import { CliClient } from "./classes.cliclient.js";
+import { CliClient } from './classes.cliclient.js';
 
 export const runCli = async () => {
   const cliQenv = new plugins.qenv.Qenv();
+  const cloudlyUrl = await cliQenv.getEnvVarOnDemand('CLOUDLY_URL');
+  const token = process.env.CLOUDLY_TOKEN;
+  const username = process.env.CLOUDLY_USERNAME;
+  const password = process.env.CLOUDLY_PASSWORD;
+
   const apiClient = new plugins.servezoneApi.CloudlyApiClient({
     registerAs: 'cli',
-    cloudlyUrl: await cliQenv.getEnvVarOnDemand('CLOUDLY_URL'),
+    cloudlyUrl,
   });
+  await apiClient.start();
+
+  if (token) {
+    await apiClient.getIdentityByToken(token, { tagConnection: true, statefullIdentity: true });
+  } else if (username && password) {
+    await apiClient.loginWithUsernameAndPassword(username, password);
+  } else {
+    console.log('No credentials provided. Set CLOUDLY_TOKEN or CLOUDLY_USERNAME/CLOUDLY_PASSWORD.');
+  }
+
   const cliClient = new CliClient(apiClient);
-};
+  // Default action example: list clusters when invoked without subcommands
+  await cliClient.getClusters();
+};

package/ts_cliclient/plugins.ts

@@ -14,4 +14,4 @@ import * as qenv from '@push.rocks/qenv';
 export {
   projectinfo,
   qenv,
-}
+}

package/ts_cliclient/readme.md

@@ -1,358 +1,105 @@
-# @serve.zone/cli 🚀
+# @serve.zone/cli
 
-**Command-line interface for Cloudly.** Manage your multi-cloud infrastructure from the terminal with powerful, intuitive commands.
+`@serve.zone/cli` is the published Cloudly CLI submodule. It provides the `servezone` binary and currently acts as a thin environment-driven client for connecting to a Cloudly control plane and listing clusters through `@serve.zone/api`.
 
-## 🎯 What is @serve.zone/cli?
+## Issue Reporting and Security
 
-The Cloudly CLI brings the full power of the Cloudly platform to your terminal. Whether you're automating deployments, managing secrets, or monitoring services, the CLI provides a streamlined interface for all your cloud operations.
+For reporting bugs, issues, or security vulnerabilities, please visit [community.foss.global/](https://community.foss.global/). This is the central community hub for all issue reporting. Developers who sign and comply with our contribution agreement and go through identification can also get a [code.foss.global/](https://code.foss.global/) account to submit Pull Requests directly.
 
-## ✨ Features
+## Current Scope
 
-- **⚡ Fast & Efficient** - Optimized for speed and minimal resource usage
-- **🔐 Secure Authentication** - Token-based authentication with secure storage
-- **📝 Intuitive Commands** - Clear, consistent command structure
-- **🎨 Formatted Output** - Beautiful, readable output with color coding
-- **🔄 Scriptable** - Perfect for CI/CD pipelines and automation
-- **📊 Comprehensive** - Access to all Cloudly features from the terminal
+This submodule is intentionally small in the current codebase:
 
-## 🚀 Installation
+- Reads `CLOUDLY_URL` through `@push.rocks/qenv`.
+- Authenticates with either `CLOUDLY_TOKEN` or `CLOUDLY_USERNAME` plus `CLOUDLY_PASSWORD`.
+- Starts a `CloudlyApiClient` registered as `cli`.
+- Creates a `CliClient` wrapper around the API client.
+- Calls `CliClient.getClusters()` and prints the result.
 
-### Global Installation (Recommended)
+It is not currently a full command tree for services, secrets, deployments, logs, profiles, or shell completion. Those flows should be implemented against `@serve.zone/api` before documenting them as CLI commands.
 
-```bash
-pnpm add -g @serve.zone/cli
-```
-
-### Local Installation
-
-```bash
-pnpm add @serve.zone/cli
-```
-
-## 🎬 Quick Start
-
-```bash
-# Configure your Cloudly instance
-servezone config --url https://cloudly.example.com
-
-# Login with your service token
-servezone login --token your-service-token
-
-# List your clusters
-servezone clusters list
-
-# Deploy a service
-servezone deploy --cluster production --image myapp:latest
-```
-
-## 🔑 Authentication
-
-### Initial Setup
-
-```bash
-# Set your Cloudly instance URL
-servezone config --url https://cloudly.example.com
-
-# Authenticate with a service token
-servezone login --token YOUR_SERVICE_TOKEN
-
-# Or use environment variables
-export CLOUDLY_URL=https://cloudly.example.com
-export CLOUDLY_TOKEN=YOUR_SERVICE_TOKEN
-```
-
-### Managing Profiles
-
-```bash
-# Create a profile for different environments
-servezone profile create production --url https://prod.cloudly.com
-servezone profile create staging --url https://stage.cloudly.com
-
-# Switch between profiles
-servezone profile use production
-
-# List all profiles
-servezone profile list
-```
-
-## 📚 Core Commands
-
-### 🌐 Cluster Management
-
-```bash
-# List all clusters
-servezone clusters list
-
-# Get cluster details
-servezone clusters info production-cluster
-
-# Create a new cluster
-servezone clusters create \
-  --name production-cluster \
-  --region eu-central \
-  --nodes 3
-
-# Scale a cluster
-servezone clusters scale production-cluster --nodes 5
-
-# Delete a cluster
-servezone clusters delete staging-cluster
-```
-
-### 🐳 Service Deployment
-
-```bash
-# Deploy a service
-servezone deploy \
-  --cluster production \
-  --name api-service \
-  --image myapp:2.0.0 \
-  --replicas 3 \
-  --port 80:3000
-
-# Update a service
-servezone service update api-service \
-  --image myapp:2.1.0 \
-  --replicas 5
-
-# Scale a service
-servezone service scale api-service --replicas 10
-
-# Remove a service
-servezone service remove api-service
-```
-
-### 🔐 Secret Management
-
-```bash
-# Create a secret
-servezone secrets create \
-  --name database-url \
-  --value "postgres://user:pass@host/db"
-
-# Create a secret group
-servezone secrets create-group \
-  --name api-secrets \
-  --secret DATABASE_URL=postgres://... \
-  --secret REDIS_URL=redis://...
-
-# List secrets
-servezone secrets list
-
-# Get secret value
-servezone secrets get database-url
-
-# Delete a secret
-servezone secrets delete old-secret
-```
-
-### 📦 Image Management
-
-```bash
-# List images
-servezone images list
-
-# Push a new image
-servezone images push \
-  --name myapp \
-  --version 2.0.0 \
-  --file ./myapp.tar
-
-# Tag an image
-servezone images tag myapp:2.0.0 myapp:latest
-
-# Delete an image
-servezone images delete myapp:1.0.0
-```
-
-### 📊 Monitoring & Logs
-
-```bash
-# View service logs
-servezone logs api-service
-
-# Follow logs in real-time
-servezone logs api-service --follow
-
-# Filter logs
-servezone logs api-service --since 1h --grep ERROR
-
-# Get service status
-servezone service status api-service
-
-# Monitor cluster health
-servezone clusters health production-cluster
-```
-
-### 🔧 DNS Management
-
-```bash
-# List DNS records
-servezone dns list --domain example.com
-
-# Create a DNS record
-servezone dns create \
-  --domain example.com \
-  --name api \
-  --type A \
-  --value 192.168.1.1
-
-# Update a DNS record
-servezone dns update api.example.com --value 192.168.1.2
-
-# Delete a DNS record
-servezone dns delete old.example.com
-```
-
-## 🎯 Advanced Usage
+## Installation
 
-### Environment Variables
+The package is published from `cloudly/ts_cliclient` via `tspublish.json` under the name `@serve.zone/cli` with the `servezone` binary.
 
-```bash
-# Set environment variables for a service
-servezone deploy \
-  --name api-service \
-  --env NODE_ENV=production \
-  --env PORT=3000 \
-  --env DATABASE_URL=@secret:database-url
-```
-
-### Configuration Files
-
-Create a `cloudly.yaml` file:
-
-```yaml
-cluster: production
-service:
-  name: api-service
-  image: myapp:latest
-  replicas: 3
-  ports:
-    - 80:3000
-  environment:
-    NODE_ENV: production
-    DATABASE_URL: "@secret:database-url"
+```sh
+pnpm add -g @serve.zone/cli
 ```
 
-Deploy using the config file:
+For local development inside the Cloudly repository, build the parent package:
 
-```bash
-servezone deploy --config cloudly.yaml
+```sh
+pnpm install
+pnpm build
 ```
 
-### Batch Operations
+## Usage
 
-```bash
-# Deploy multiple services
-servezone deploy --config services/*.yaml
+Authenticate with a machine token:
 
-# Update all services in a namespace
-servezone service update --namespace api --image-tag v2.0.0
-
-# Delete all staging resources
-servezone cleanup --environment staging
+```sh
+CLOUDLY_URL=https://cloudly.example.com \
+CLOUDLY_TOKEN=cluster-or-api-token \
+servezone
 ```
 
-## 🔄 CI/CD Integration
-
-### GitHub Actions
+Authenticate with username and password:
 
-```yaml
-- name: Deploy to Cloudly
-  run: |
-    servezone config --url ${{ secrets.CLOUDLY_URL }}
-    servezone login --token ${{ secrets.CLOUDLY_TOKEN }}
-    servezone deploy \
-      --cluster production \
-      --name api-service \
-      --image myapp:${{ github.sha }}
+```sh
+CLOUDLY_URL=https://cloudly.example.com \
+CLOUDLY_USERNAME=admin \
+CLOUDLY_PASSWORD=change-me \
+servezone
 ```
 
-### GitLab CI
+When `CLOUDLY_TOKEN` is present, the CLI requests a stateful identity and asks Cloudly to tag the WebSocket connection. When username/password are present instead, it uses Cloudly's admin login flow. If no credentials are provided, the CLI prints a warning before attempting the default cluster-list operation.
 
-```yaml
-deploy:
-  script:
-    - servezone config --url $CLOUDLY_URL
-    - servezone login --token $CLOUDLY_TOKEN
-    - servezone deploy --config cloudly.yaml
-```
+## Programmatic Use
 
-## 🎨 Output Formats
+The submodule exports the `runCli()` entry point and uses `CliClient` internally:
 
-```bash
-# JSON output for scripting
-servezone clusters list --output json
+```ts
+import { CloudlyApiClient } from '@serve.zone/api';
+import { CliClient } from './classes.cliclient.js';
 
-# YAML output
-servezone service info api-service --output yaml
+const apiClient = new CloudlyApiClient({
+  registerAs: 'cli',
+  cloudlyUrl: 'https://cloudly.example.com',
+});
 
-# Table output (default)
-servezone images list --output table
+await apiClient.start();
+await apiClient.loginWithUsernameAndPassword('admin', 'change-me');
 
-# Quiet mode (IDs only)
-servezone clusters list --quiet
+const cli = new CliClient(apiClient);
+await cli.getClusters();
 ```
 
-## 🛠️ Troubleshooting
+## Files
 
-```bash
-# Enable debug output
-servezone --debug clusters list
-
-# Check CLI version
-servezone version
-
-# Test connection
-servezone ping
-
-# View configuration
-servezone config show
-
-# Clear cache and credentials
-servezone logout --clear-cache
-```
-
-## 📝 Command Reference
-
-```bash
-servezone --help                    # Show all commands
-servezone <command> --help          # Show command-specific help
-servezone clusters --help           # Show cluster commands
-servezone service --help            # Show service commands
-servezone secrets --help            # Show secret commands
-```
-
-## 🔌 Shell Completion
-
-Enable tab completion for your shell:
-
-```bash
-# Bash
-servezone completion bash > /etc/bash_completion.d/servezone
-
-# Zsh
-servezone completion zsh > ~/.zsh/completions/_servezone
-
-# Fish
-servezone completion fish > ~/.config/fish/completions/servezone.fish
-```
+| Path | Purpose |
+| --- | --- |
+| `index.ts` | Runtime entry point for the published CLI. |
+| `classes.cliclient.ts` | Minimal client wrapper; currently exposes `getClusters()`. |
+| `plugins.ts` | Centralized imports for the submodule. |
+| `tspublish.json` | Published package name, dependencies, registry targets, and `servezone` bin metadata. |
 
 ## License and Legal Information
 
-This repository contains open-source code that is licensed under the MIT License. A copy of the MIT License can be found in the [license](license) file within this repository. 
+This repository contains open-source code licensed under the MIT License. A copy of the license can be found in the [license](../license) file.
 
 **Please note:** The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.
 
 ### Trademarks
 
-This project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH and are not included within the scope of the MIT license granted herein. Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines, and any usage must be approved in writing by Task Venture Capital GmbH.
+This project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH or third parties, and are not included within the scope of the MIT license granted herein.
+
+Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines or the guidelines of the respective third-party owners, and any usage must be approved in writing. Third-party trademarks used herein are the property of their respective owners and used only in a descriptive manner, e.g. for an implementation of an API or similar.
 
 ### Company Information
 
 Task Venture Capital GmbH  
-Registered at District court Bremen HRB 35230 HB, Germany
+Registered at District Court Bremen HRB 35230 HB, Germany
 
-For any legal inquiries or if you require further information, please contact us via email at hello@task.vc.
+For any legal inquiries or further information, please contact us via email at hello@task.vc.
 
-By using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.
+By using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.

package/dist_ts_cliclient/classes.cliclient.d.ts

@@ -1,6 +0,0 @@
-import { CloudlyApiClient } from '@serve.zone/api';
-export declare class CliClient {
-    cloudlyApiClient: CloudlyApiClient;
-    constructor(cloudlyApiClientArg: CloudlyApiClient);
-    getClusters(): Promise<void>;
-}

package/dist_ts_cliclient/classes.cliclient.js

@@ -1,12 +0,0 @@
-import * as plugins from './plugins.js';
-import { CloudlyApiClient } from '@serve.zone/api';
-export class CliClient {
-    constructor(cloudlyApiClientArg) {
-        this.cloudlyApiClient = cloudlyApiClientArg;
-    }
-    async getClusters() {
-        const clusters = await this.cloudlyApiClient.cluster.getClusters();
-        console.log(clusters);
-    }
-}
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5jbGljbGllbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c19jbGljbGllbnQvY2xhc3Nlcy5jbGljbGllbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxjQUFjLENBQUM7QUFDeEMsT0FBTyxFQUFFLGdCQUFnQixFQUFFLE1BQU0saUJBQWlCLENBQUM7QUFFbkQsTUFBTSxPQUFPLFNBQVM7SUFHcEIsWUFBWSxtQkFBcUM7UUFDL0MsSUFBSSxDQUFDLGdCQUFnQixHQUFHLG1CQUFtQixDQUFDO0lBQzlDLENBQUM7SUFFTSxLQUFLLENBQUMsV0FBVztRQUN0QixNQUFNLFFBQVEsR0FBRyxNQUFNLElBQUksQ0FBQyxnQkFBZ0IsQ0FBQyxPQUFPLENBQUMsV0FBVyxFQUFFLENBQUM7UUFDbkUsT0FBTyxDQUFDLEdBQUcsQ0FBQyxRQUFRLENBQUMsQ0FBQztJQUN4QixDQUFDO0NBQ0YifQ==

package/dist_ts_cliclient/index.d.ts

@@ -1 +0,0 @@
-export declare const runCli: () => Promise<void>;

package/dist_ts_cliclient/index.js

@@ -1,11 +0,0 @@
-import * as plugins from './plugins.js';
-import { CliClient } from "./classes.cliclient.js";
-export const runCli = async () => {
-    const cliQenv = new plugins.qenv.Qenv();
-    const apiClient = new plugins.servezoneApi.CloudlyApiClient({
-        registerAs: 'cli',
-        cloudlyUrl: await cliQenv.getEnvVarOnDemand('CLOUDLY_URL'),
-    });
-    const cliClient = new CliClient(apiClient);
-};
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c19jbGljbGllbnQvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxjQUFjLENBQUM7QUFDeEMsT0FBTyxFQUFFLFNBQVMsRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBRW5ELE1BQU0sQ0FBQyxNQUFNLE1BQU0sR0FBRyxLQUFLLElBQUksRUFBRTtJQUMvQixNQUFNLE9BQU8sR0FBRyxJQUFJLE9BQU8sQ0FBQyxJQUFJLENBQUMsSUFBSSxFQUFFLENBQUM7SUFDeEMsTUFBTSxTQUFTLEdBQUcsSUFBSSxPQUFPLENBQUMsWUFBWSxDQUFDLGdCQUFnQixDQUFDO1FBQzFELFVBQVUsRUFBRSxLQUFLO1FBQ2pCLFVBQVUsRUFBRSxNQUFNLE9BQU8sQ0FBQyxpQkFBaUIsQ0FBQyxhQUFhLENBQUM7S0FDM0QsQ0FBQyxDQUFDO0lBQ0gsTUFBTSxTQUFTLEdBQUcsSUFBSSxTQUFTLENBQUMsU0FBUyxDQUFDLENBQUM7QUFDN0MsQ0FBQyxDQUFDIn0=

package/dist_ts_cliclient/plugins.d.ts

@@ -1,6 +0,0 @@
-import * as servezoneApi from '@serve.zone/api';
-import * as servezoneInterfaces from '@serve.zone/interfaces';
-export { servezoneApi, servezoneInterfaces };
-import * as projectinfo from '@push.rocks/projectinfo';
-import * as qenv from '@push.rocks/qenv';
-export { projectinfo, qenv, };

package/dist_ts_cliclient/plugins.js

@@ -1,9 +0,0 @@
-// @serve.zone scope
-import * as servezoneApi from '@serve.zone/api';
-import * as servezoneInterfaces from '@serve.zone/interfaces';
-export { servezoneApi, servezoneInterfaces };
-// @push.rocks scope
-import * as projectinfo from '@push.rocks/projectinfo';
-import * as qenv from '@push.rocks/qenv';
-export { projectinfo, qenv, };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2lucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzX2NsaWNsaWVudC9wbHVnaW5zLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLG9CQUFvQjtBQUNwQixPQUFPLEtBQUssWUFBWSxNQUFNLGlCQUFpQixDQUFDO0FBQ2hELE9BQU8sS0FBSyxtQkFBbUIsTUFBTSx3QkFBd0IsQ0FBQztBQUU5RCxPQUFPLEVBQ0wsWUFBWSxFQUNaLG1CQUFtQixFQUNwQixDQUFBO0FBRUQsb0JBQW9CO0FBQ3BCLE9BQU8sS0FBSyxXQUFXLE1BQU0seUJBQXlCLENBQUM7QUFDdkQsT0FBTyxLQUFLLElBQUksTUFBTSxrQkFBa0IsQ0FBQztBQUV6QyxPQUFPLEVBQ0wsV0FBVyxFQUNYLElBQUksR0FDTCxDQUFBIn0=