berget 0.1.0 → 1.0.0

package/dist/src/services/flux-service.js

@@ -11,6 +11,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FluxService = void 0;
 const client_1 = require("../client");
+const command_structure_1 = require("../constants/command-structure");
+/**
+ * Service for managing Flux CD
+ * Command group: flux
+ */
 class FluxService {
     constructor() {
         this.client = (0, client_1.createAuthenticatedClient)();
@@ -21,17 +26,29 @@ class FluxService {
         }
         return FluxService.instance;
     }
-    // This endpoint is not available in the API
-    installFlux(options) {
+    /**
+     * Install Flux CD
+     * Command: berget flux install
+     * This endpoint is not available in the API
+     */
+    install(options) {
         return __awaiter(this, void 0, void 0, function* () {
             throw new Error('This functionality is not available in the API');
         });
     }
-    // This endpoint is not available in the API
-    bootstrapFlux(options) {
+    /**
+     * Bootstrap Flux CD
+     * Command: berget flux bootstrap
+     * This endpoint is not available in the API
+     */
+    bootstrap(options) {
         return __awaiter(this, void 0, void 0, function* () {
             throw new Error('This functionality is not available in the API');
         });
     }
 }
 exports.FluxService = FluxService;
+// Command group name for this service
+FluxService.COMMAND_GROUP = command_structure_1.COMMAND_GROUPS.FLUX;
+// Subcommands for this service
+FluxService.COMMANDS = command_structure_1.SUBCOMMANDS.FLUX;

package/dist/src/services/helm-service.js

@@ -11,6 +11,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HelmService = void 0;
 const client_1 = require("../client");
+const command_structure_1 = require("../constants/command-structure");
+/**
+ * Service for managing Helm charts
+ * Command group: helm
+ */
 class HelmService {
     constructor() {
         this.client = (0, client_1.createAuthenticatedClient)();
@@ -21,17 +26,29 @@ class HelmService {
         }
         return HelmService.instance;
     }
-    // This endpoint is not available in the API
+    /**
+     * Add a Helm repository
+     * Command: berget helm add-repo
+     * This endpoint is not available in the API
+     */
     addRepo(options) {
         return __awaiter(this, void 0, void 0, function* () {
             throw new Error('This functionality is not available in the API');
         });
     }
-    // This endpoint is not available in the API
-    installChart(options) {
+    /**
+     * Install a Helm chart
+     * Command: berget helm install
+     * This endpoint is not available in the API
+     */
+    install(options) {
         return __awaiter(this, void 0, void 0, function* () {
             throw new Error('This functionality is not available in the API');
         });
     }
 }
 exports.HelmService = HelmService;
+// Command group name for this service
+HelmService.COMMAND_GROUP = command_structure_1.COMMAND_GROUPS.HELM;
+// Subcommands for this service
+HelmService.COMMANDS = command_structure_1.SUBCOMMANDS.HELM;

package/dist/src/services/kubectl-service.js

@@ -11,6 +11,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.KubectlService = void 0;
 const client_1 = require("../client");
+const command_structure_1 = require("../constants/command-structure");
+/**
+ * Service for managing Kubernetes resources
+ * Command group: kubectl
+ */
 class KubectlService {
     constructor() {
         this.client = (0, client_1.createAuthenticatedClient)();
@@ -21,23 +26,39 @@ class KubectlService {
         }
         return KubectlService.instance;
     }
-    // This endpoint is not available in the API
+    /**
+     * Create a Kubernetes namespace
+     * Command: berget kubectl create-namespace
+     * This endpoint is not available in the API
+     */
     createNamespace(name) {
         return __awaiter(this, void 0, void 0, function* () {
             throw new Error('This functionality is not available in the API');
         });
     }
-    // This endpoint is not available in the API
-    applyConfiguration(filename) {
+    /**
+     * Apply a Kubernetes configuration
+     * Command: berget kubectl apply
+     * This endpoint is not available in the API
+     */
+    apply(filename) {
         return __awaiter(this, void 0, void 0, function* () {
             throw new Error('This functionality is not available in the API');
         });
     }
-    // This endpoint is not available in the API
-    getResources(resource, namespace) {
+    /**
+     * Get Kubernetes resources
+     * Command: berget kubectl get
+     * This endpoint is not available in the API
+     */
+    get(resource, namespace) {
         return __awaiter(this, void 0, void 0, function* () {
             throw new Error('This functionality is not available in the API');
         });
     }
 }
 exports.KubectlService = KubectlService;
+// Command group name for this service
+KubectlService.COMMAND_GROUP = command_structure_1.COMMAND_GROUPS.KUBECTL;
+// Subcommands for this service
+KubectlService.COMMANDS = command_structure_1.SUBCOMMANDS.KUBECTL;

package/index.ts

@@ -6,6 +6,7 @@ import * as path from 'path'
 import { createAuthenticatedClient } from './src/client'
 import { handleError } from './src/utils/error-handler'
 import chalk from 'chalk'
+import { COMMAND_GROUPS, SUBCOMMANDS } from './src/constants/command-structure'
 
 // Set version and description
 program
@@ -29,16 +30,20 @@ import { ApiKeyService, ApiKey } from './src/services/api-key-service'
 import { ClusterService, Cluster } from './src/services/cluster-service'
 
 // Auth commands
-program
-  .command('login')
+const auth = program
+  .command(AuthService.COMMAND_GROUP)
+  .description('Manage authentication and authorization')
+
+auth
+  .command(AuthService.COMMANDS.LOGIN)
   .description('Log in to Berget')
   .action(async () => {
     const authService = AuthService.getInstance()
     await authService.login()
   })
 
-program
-  .command('logout')
+auth
+  .command(AuthService.COMMANDS.LOGOUT)
   .description('Log out from Berget')
   .action(() => {
     const { clearAuthToken } = require('./src/client')
@@ -46,13 +51,13 @@ program
     console.log(chalk.green('You have been logged out from Berget'))
   })
 
-program
-  .command('whoami')
+auth
+  .command(AuthService.COMMANDS.WHOAMI)
   .description('Show information about the logged in user')
   .action(async () => {
     try {
       const authService = AuthService.getInstance()
-      const profile = await authService.getUserProfile()
+      const profile = await authService.whoami()
 
       if (profile) {
         console.log(
@@ -75,15 +80,17 @@ program
   })
 
 // API Key commands
-const apiKey = program.command('api-key').description('Manage API keys')
+const apiKey = program
+  .command(ApiKeyService.COMMAND_GROUP)
+  .description('Manage API keys')
 
 apiKey
-  .command('list')
+  .command(ApiKeyService.COMMANDS.LIST)
   .description('List all API keys')
   .action(async () => {
     try {
       const apiKeyService = ApiKeyService.getInstance()
-      const keys = await apiKeyService.listApiKeys()
+      const keys = await apiKeyService.list()
 
       if (keys.length === 0) {
         console.log(
@@ -143,7 +150,7 @@ apiKey
   })
 
 apiKey
-  .command('create')
+  .command(ApiKeyService.COMMANDS.CREATE)
   .description('Create a new API key')
   .option('--name <name>', 'Name of the API key')
   .option('--description <description>', 'Description of the API key')
@@ -161,7 +168,7 @@ apiKey
       console.log(chalk.blue('Creating API key...'))
 
       const apiKeyService = ApiKeyService.getInstance()
-      const result = await apiKeyService.createApiKey({
+      const result = await apiKeyService.create({
         name: options.name,
         description: options.description,
       })
@@ -202,7 +209,7 @@ apiKey
   })
 
 apiKey
-  .command('delete')
+  .command(ApiKeyService.COMMANDS.DELETE)
   .description('Delete an API key')
   .argument('<id>', 'ID of the API key to delete')
   .action(async (id) => {
@@ -210,7 +217,7 @@ apiKey
       console.log(chalk.blue(`Deleting API key ${id}...`))
 
       const apiKeyService = ApiKeyService.getInstance()
-      await apiKeyService.deleteApiKey(id)
+      await apiKeyService.delete(id)
 
       console.log(chalk.green(`✓ API key ${id} has been deleted`))
       console.log('')
@@ -228,7 +235,7 @@ apiKey
   })
 
 apiKey
-  .command('rotate')
+  .command(ApiKeyService.COMMANDS.ROTATE)
   .description(
     'Rotate an API key (creates a new one and invalidates the old one)'
   )
@@ -241,7 +248,7 @@ apiKey
       )
 
       const apiKeyService = ApiKeyService.getInstance()
-      const result = await apiKeyService.rotateApiKey(id)
+      const result = await apiKeyService.rotate(id)
 
       console.log('')
       console.log(chalk.green('✓ API key rotated'))
@@ -279,7 +286,7 @@ apiKey
   })
 
 apiKey
-  .command('usage')
+  .command(ApiKeyService.COMMANDS.DESCRIBE)
   .description('Show usage statistics for an API key')
   .argument('<id>', 'ID of the API key')
   .option('--start <date>', 'Start date (YYYY-MM-DD)')
@@ -289,7 +296,7 @@ apiKey
       console.log(chalk.blue(`Fetching usage statistics for API key ${id}...`))
 
       const apiKeyService = ApiKeyService.getInstance()
-      const usage = await apiKeyService.getApiKeyUsage(id)
+      const usage = await apiKeyService.describe(id)
 
       console.log('')
       console.log(
@@ -367,17 +374,19 @@ apiKey
   })
 
 // Cluster commands
-const cluster = program.command('cluster').description('Manage Berget clusters')
+const cluster = program
+  .command(ClusterService.COMMAND_GROUP)
+  .description('Manage Berget clusters')
 
 // Removed cluster create command as it's not available in the API
 
 cluster
-  .command('list')
+  .command(ClusterService.COMMANDS.LIST)
   .description('List all Berget clusters')
   .action(async () => {
     try {
       const clusterService = ClusterService.getInstance()
-      const clusters = await clusterService.listClusters()
+      const clusters = await clusterService.list()
 
       console.log('NAME                   STATUS    NODES    CREATED')
       clusters.forEach((cluster: Cluster) => {
@@ -393,13 +402,13 @@ cluster
   })
 
 cluster
-  .command('usage')
+  .command(ClusterService.COMMANDS.GET_USAGE)
   .description('Get usage metrics for a specific cluster')
   .argument('<clusterId>', 'Cluster ID')
   .action(async (clusterId) => {
     try {
       const clusterService = ClusterService.getInstance()
-      const usage = await clusterService.getClusterUsage(clusterId)
+      const usage = await clusterService.getUsage(clusterId)
 
       console.log('Cluster Usage:')
       console.log(JSON.stringify(usage, null, 2))
@@ -408,6 +417,22 @@ cluster
     }
   })
 
+cluster
+  .command(ClusterService.COMMANDS.DESCRIBE)
+  .description('Get detailed information about a cluster')
+  .argument('<clusterId>', 'Cluster ID')
+  .action(async (clusterId) => {
+    try {
+      const clusterService = ClusterService.getInstance()
+      const clusterInfo = await clusterService.describe(clusterId)
+
+      console.log('Cluster Details:')
+      console.log(JSON.stringify(clusterInfo, null, 2))
+    } catch (error) {
+      handleError('Failed to describe cluster', error)
+    }
+  })
+
 // Autocomplete command
 program
   .command('autocomplete')
@@ -430,8 +455,12 @@ program
 // Removed kubernetes-like commands as they're not available in the API
 
 // Add token usage command
-program
-  .command('token-usage')
+const billing = program
+  .command(COMMAND_GROUPS.BILLING)
+  .description('Manage billing and usage')
+
+billing
+  .command(SUBCOMMANDS.BILLING.GET_USAGE)
   .description('Get token usage statistics')
   .option('--model <modelId>', 'Get usage for a specific model')
   .action(async (options) => {
@@ -459,8 +488,12 @@ program
   })
 
 // Add models command
-program
-  .command('models')
+const models = program
+  .command(COMMAND_GROUPS.MODELS)
+  .description('Manage AI models')
+
+models
+  .command(SUBCOMMANDS.MODELS.LIST)
   .description('List available AI models')
   .option('--id <modelId>', 'Get details for a specific model')
   .action(async (options) => {
@@ -506,9 +539,13 @@ program
   })
 
 // Add team command
-program
-  .command('team')
-  .description('Manage team members')
+const users = program
+  .command(COMMAND_GROUPS.USERS)
+  .description('Manage users')
+
+users
+  .command(SUBCOMMANDS.USERS.LIST)
+  .description('List team members')
   .action(async () => {
     try {
       const client = createAuthenticatedClient()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "berget",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "main": "dist/index.js",
   "bin": {
     "berget": "dist/index.js"

package/src/constants/command-structure.ts

@@ -0,0 +1,168 @@
+/**
+ * Command structure constants for the CLI
+ * Following patterns from AWS CLI and Google Cloud CLI
+ */
+
+// Main command groups
+export const COMMAND_GROUPS = {
+  AUTH: 'auth',
+  API_KEYS: 'api-keys',
+  CLUSTERS: 'clusters',
+  APPS: 'apps',
+  MODELS: 'models',
+  HELM: 'helm',
+  KUBECTL: 'kubectl',
+  FLUX: 'flux',
+  USERS: 'users',
+  BILLING: 'billing',
+}
+
+// Subcommands for each group
+export const SUBCOMMANDS = {
+  // Auth commands
+  AUTH: {
+    LOGIN: 'login',
+    LOGOUT: 'logout',
+    WHOAMI: 'whoami',
+  },
+  
+  // API Keys commands
+  API_KEYS: {
+    LIST: 'list',
+    CREATE: 'create',
+    DELETE: 'delete',
+    ROTATE: 'rotate',
+    DESCRIBE: 'describe',
+  },
+  
+  // Clusters commands
+  CLUSTERS: {
+    LIST: 'list',
+    DESCRIBE: 'describe',
+    GET_USAGE: 'get-usage',
+  },
+  
+  // Apps commands
+  APPS: {
+    LIST_TEMPLATES: 'list-templates',
+    DESCRIBE_TEMPLATE: 'describe-template',
+    LIST_INSTALLATIONS: 'list-installations',
+    INSTALL: 'install',
+    UNINSTALL: 'uninstall',
+    DESCRIBE_INSTALLATION: 'describe-installation',
+  },
+  
+  // Models commands
+  MODELS: {
+    LIST: 'list',
+    DESCRIBE: 'describe',
+  },
+  
+  // Helm commands
+  HELM: {
+    ADD_REPO: 'add-repo',
+    INSTALL: 'install',
+  },
+  
+  // Kubectl commands
+  KUBECTL: {
+    CREATE_NAMESPACE: 'create-namespace',
+    APPLY: 'apply',
+    GET: 'get',
+  },
+  
+  // Flux commands
+  FLUX: {
+    INSTALL: 'install',
+    BOOTSTRAP: 'bootstrap',
+  },
+  
+  // Users commands
+  USERS: {
+    LIST: 'list',
+    DESCRIBE: 'describe',
+    UPDATE: 'update',
+    INVITE: 'invite',
+  },
+  
+  // Billing commands
+  BILLING: {
+    GET_USAGE: 'get-usage',
+    LIST_INVOICES: 'list-invoices',
+    DESCRIBE_INVOICE: 'describe-invoice',
+    LIST_PAYMENT_METHODS: 'list-payment-methods',
+    ADD_PAYMENT_METHOD: 'add-payment-method',
+    REMOVE_PAYMENT_METHOD: 'remove-payment-method',
+    UPDATE_SUBSCRIPTION: 'update-subscription',
+  },
+}
+
+// Command descriptions
+export const COMMAND_DESCRIPTIONS = {
+  // Auth group
+  [COMMAND_GROUPS.AUTH]: 'Manage authentication and authorization',
+  [`${COMMAND_GROUPS.AUTH} ${SUBCOMMANDS.AUTH.LOGIN}`]: 'Log in to Berget AI',
+  [`${COMMAND_GROUPS.AUTH} ${SUBCOMMANDS.AUTH.LOGOUT}`]: 'Log out from Berget AI',
+  [`${COMMAND_GROUPS.AUTH} ${SUBCOMMANDS.AUTH.WHOAMI}`]: 'Display current user information',
+  
+  // API Keys group
+  [COMMAND_GROUPS.API_KEYS]: 'Manage API keys',
+  [`${COMMAND_GROUPS.API_KEYS} ${SUBCOMMANDS.API_KEYS.LIST}`]: 'List all API keys',
+  [`${COMMAND_GROUPS.API_KEYS} ${SUBCOMMANDS.API_KEYS.CREATE}`]: 'Create a new API key',
+  [`${COMMAND_GROUPS.API_KEYS} ${SUBCOMMANDS.API_KEYS.DELETE}`]: 'Delete an API key',
+  [`${COMMAND_GROUPS.API_KEYS} ${SUBCOMMANDS.API_KEYS.ROTATE}`]: 'Rotate an API key',
+  [`${COMMAND_GROUPS.API_KEYS} ${SUBCOMMANDS.API_KEYS.DESCRIBE}`]: 'Get usage statistics for an API key',
+  
+  // Clusters group
+  [COMMAND_GROUPS.CLUSTERS]: 'Manage Kubernetes clusters',
+  [`${COMMAND_GROUPS.CLUSTERS} ${SUBCOMMANDS.CLUSTERS.LIST}`]: 'List all clusters',
+  [`${COMMAND_GROUPS.CLUSTERS} ${SUBCOMMANDS.CLUSTERS.DESCRIBE}`]: 'Get detailed information about a cluster',
+  [`${COMMAND_GROUPS.CLUSTERS} ${SUBCOMMANDS.CLUSTERS.GET_USAGE}`]: 'Get resource usage for a cluster',
+  
+  // Apps group
+  [COMMAND_GROUPS.APPS]: 'Manage applications',
+  [`${COMMAND_GROUPS.APPS} ${SUBCOMMANDS.APPS.LIST_TEMPLATES}`]: 'List available application templates',
+  [`${COMMAND_GROUPS.APPS} ${SUBCOMMANDS.APPS.DESCRIBE_TEMPLATE}`]: 'Get detailed information about an application template',
+  [`${COMMAND_GROUPS.APPS} ${SUBCOMMANDS.APPS.LIST_INSTALLATIONS}`]: 'List installed applications',
+  [`${COMMAND_GROUPS.APPS} ${SUBCOMMANDS.APPS.INSTALL}`]: 'Install an application',
+  [`${COMMAND_GROUPS.APPS} ${SUBCOMMANDS.APPS.UNINSTALL}`]: 'Uninstall an application',
+  [`${COMMAND_GROUPS.APPS} ${SUBCOMMANDS.APPS.DESCRIBE_INSTALLATION}`]: 'Get detailed information about an installed application',
+  
+  // Models group
+  [COMMAND_GROUPS.MODELS]: 'Manage AI models',
+  [`${COMMAND_GROUPS.MODELS} ${SUBCOMMANDS.MODELS.LIST}`]: 'List available AI models',
+  [`${COMMAND_GROUPS.MODELS} ${SUBCOMMANDS.MODELS.DESCRIBE}`]: 'Get detailed information about an AI model',
+  
+  // Helm group
+  [COMMAND_GROUPS.HELM]: 'Manage Helm charts',
+  [`${COMMAND_GROUPS.HELM} ${SUBCOMMANDS.HELM.ADD_REPO}`]: 'Add a Helm repository',
+  [`${COMMAND_GROUPS.HELM} ${SUBCOMMANDS.HELM.INSTALL}`]: 'Install a Helm chart',
+  
+  // Kubectl group
+  [COMMAND_GROUPS.KUBECTL]: 'Manage Kubernetes resources',
+  [`${COMMAND_GROUPS.KUBECTL} ${SUBCOMMANDS.KUBECTL.CREATE_NAMESPACE}`]: 'Create a Kubernetes namespace',
+  [`${COMMAND_GROUPS.KUBECTL} ${SUBCOMMANDS.KUBECTL.APPLY}`]: 'Apply a Kubernetes configuration',
+  [`${COMMAND_GROUPS.KUBECTL} ${SUBCOMMANDS.KUBECTL.GET}`]: 'Get Kubernetes resources',
+  
+  // Flux group
+  [COMMAND_GROUPS.FLUX]: 'Manage Flux CD',
+  [`${COMMAND_GROUPS.FLUX} ${SUBCOMMANDS.FLUX.INSTALL}`]: 'Install Flux CD',
+  [`${COMMAND_GROUPS.FLUX} ${SUBCOMMANDS.FLUX.BOOTSTRAP}`]: 'Bootstrap Flux CD',
+  
+  // Users group
+  [COMMAND_GROUPS.USERS]: 'Manage users',
+  [`${COMMAND_GROUPS.USERS} ${SUBCOMMANDS.USERS.LIST}`]: 'List all users in your organization',
+  [`${COMMAND_GROUPS.USERS} ${SUBCOMMANDS.USERS.DESCRIBE}`]: 'Get detailed information about a user',
+  [`${COMMAND_GROUPS.USERS} ${SUBCOMMANDS.USERS.UPDATE}`]: 'Update user information',
+  [`${COMMAND_GROUPS.USERS} ${SUBCOMMANDS.USERS.INVITE}`]: 'Invite a new user to your organization',
+  
+  // Billing group
+  [COMMAND_GROUPS.BILLING]: 'Manage billing and usage',
+  [`${COMMAND_GROUPS.BILLING} ${SUBCOMMANDS.BILLING.GET_USAGE}`]: 'Get current usage metrics',
+  [`${COMMAND_GROUPS.BILLING} ${SUBCOMMANDS.BILLING.LIST_INVOICES}`]: 'List all invoices',
+  [`${COMMAND_GROUPS.BILLING} ${SUBCOMMANDS.BILLING.DESCRIBE_INVOICE}`]: 'Get detailed information about an invoice',
+  [`${COMMAND_GROUPS.BILLING} ${SUBCOMMANDS.BILLING.LIST_PAYMENT_METHODS}`]: 'List all payment methods',
+  [`${COMMAND_GROUPS.BILLING} ${SUBCOMMANDS.BILLING.ADD_PAYMENT_METHOD}`]: 'Add a new payment method',
+  [`${COMMAND_GROUPS.BILLING} ${SUBCOMMANDS.BILLING.REMOVE_PAYMENT_METHOD}`]: 'Remove a payment method',
+  [`${COMMAND_GROUPS.BILLING} ${SUBCOMMANDS.BILLING.UPDATE_SUBSCRIPTION}`]: 'Update subscription plan',
+}

package/src/services/api-key-service.ts

@@ -1,5 +1,6 @@
 import { createAuthenticatedClient } from '../client'
 import { handleError } from '../utils/error-handler'
+import { COMMAND_GROUPS, SUBCOMMANDS } from '../constants/command-structure'
 
 export interface ApiKey {
   id: number
@@ -25,9 +26,19 @@ export interface ApiKeyResponse {
   created: string
 }
 
+/**
+ * Service for managing API keys
+ * Command group: api-keys
+ */
 export class ApiKeyService {
   private static instance: ApiKeyService
   private client = createAuthenticatedClient()
+  
+  // Command group name for this service
+  public static readonly COMMAND_GROUP = COMMAND_GROUPS.API_KEYS
+  
+  // Subcommands for this service
+  public static readonly COMMANDS = SUBCOMMANDS.API_KEYS
 
   private constructor() {}
 
@@ -38,7 +49,11 @@ export class ApiKeyService {
     return ApiKeyService.instance
   }
 
-  public async listApiKeys(): Promise<ApiKey[]> {
+  /**
+   * List all API keys
+   * Command: berget api-keys list
+   */
+  public async list(): Promise<ApiKey[]> {
     try {
       const { data, error } = await this.client.GET('/v1/api-keys')
       if (error) {
@@ -60,7 +75,11 @@ export class ApiKeyService {
     }
   }
 
-  public async createApiKey(options: CreateApiKeyOptions): Promise<ApiKeyResponse> {
+  /**
+   * Create a new API key
+   * Command: berget api-keys create
+   */
+  public async create(options: CreateApiKeyOptions): Promise<ApiKeyResponse> {
     try {
       const { data, error } = await this.client.POST('/v1/api-keys', {
         body: options
@@ -73,7 +92,11 @@ export class ApiKeyService {
     }
   }
 
-  public async deleteApiKey(id: string): Promise<boolean> {
+  /**
+   * Delete an API key
+   * Command: berget api-keys delete
+   */
+  public async delete(id: string): Promise<boolean> {
     try {
       const { error } = await this.client.DELETE('/v1/api-keys/{id}', {
         params: { path: { id } }
@@ -86,7 +109,11 @@ export class ApiKeyService {
     }
   }
 
-  public async rotateApiKey(id: string): Promise<ApiKeyResponse> {
+  /**
+   * Rotate an API key
+   * Command: berget api-keys rotate
+   */
+  public async rotate(id: string): Promise<ApiKeyResponse> {
     try {
       const { data, error } = await this.client.PUT('/v1/api-keys/{id}/rotate', {
         params: { path: { id } }
@@ -99,7 +126,11 @@ export class ApiKeyService {
     }
   }
 
-  public async getApiKeyUsage(id: string): Promise<any> {
+  /**
+   * Get usage statistics for an API key
+   * Command: berget api-keys describe
+   */
+  public async describe(id: string): Promise<any> {
     try {
       const { data, error } = await this.client.GET('/v1/api-keys/{id}/usage', {
         params: { path: { id } }