@agentuity/cli 0.0.60 → 0.0.62

package/src/cmd/cloud/db/delete.ts

@@ -1,11 +1,12 @@
 import { z } from 'zod';
-import { listResources, deleteResources } from '@agentuity/server';
+import { listResources, deleteResources, APIError } from '@agentuity/server';
 import enquirer from 'enquirer';
 import { createSubcommand } from '../../../types';
 import * as tui from '../../../tui';
 import { getCatalystAPIClient } from '../../../config';
 import { getCommand } from '../../../command-prefix';
 import { isDryRunMode, outputDryRun } from '../../../explain';
+import { ErrorCode } from '../../../errors';
 
 export const deleteSubcommand = createSubcommand({
 	name: 'delete',
@@ -15,10 +16,10 @@ export const deleteSubcommand = createSubcommand({
 	idempotent: false,
 	requires: { auth: true, org: true, region: true },
 	examples: [
-		getCommand('cloud db delete my-database'),
-		getCommand('cloud db rm my-database'),
-		getCommand('cloud db delete'),
-		getCommand('--dry-run cloud db delete my-database'),
+		{ command: getCommand('cloud db delete my-database'), description: 'Delete item' },
+		{ command: getCommand('cloud db rm my-database'), description: 'Delete item' },
+		{ command: getCommand('cloud db delete'), description: 'Delete item' },
+		{ command: getCommand('--dry-run cloud db delete my-database'), description: 'Delete item' },
 	],
 	schema: {
 		args: z.object({
@@ -96,23 +97,37 @@ export const deleteSubcommand = createSubcommand({
 			}
 		}
 
-		const deleted = await tui.spinner({
-			message: `Deleting database ${dbName}`,
-			clearOnSuccess: true,
-			callback: async () => {
-				return deleteResources(catalystClient, orgId, region!, [{ type: 'db', name: dbName }]);
-			},
-		});
+		try {
+			const deleted = await tui.spinner({
+				message: `Deleting database ${dbName}`,
+				clearOnSuccess: true,
+				callback: async () => {
+					return deleteResources(catalystClient, orgId, region!, [
+						{ type: 'db', name: dbName },
+					]);
+				},
+			});
 
-		if (deleted.length > 0) {
-			tui.success(`Deleted database: ${tui.bold(deleted[0])}`);
-			return {
-				success: true,
-				name: deleted[0],
-			};
-		} else {
-			tui.error('Failed to delete database');
-			return { success: false, name: dbName };
+			if (deleted.length > 0) {
+				tui.success(`Deleted database: ${tui.bold(deleted[0])}`);
+				return {
+					success: true,
+					name: deleted[0],
+				};
+			} else {
+				tui.error('Failed to delete database');
+				return { success: false, name: dbName };
+			}
+		} catch (ex) {
+			if (ex instanceof APIError) {
+				if (ex.status === 404) {
+					tui.fatal(
+						`database with the name "${dbName}" doesn't exist.`,
+						ErrorCode.INVALID_ARGUMENT
+					);
+				}
+			}
+			throw ex;
 		}
 	},
 });

package/src/cmd/cloud/db/get.ts

@@ -19,9 +19,15 @@ export const getSubcommand = createSubcommand({
 	requires: { auth: true, org: true, region: true },
 	idempotent: true,
 	examples: [
-		`${getCommand('cloud db get')} my-database`,
-		`${getCommand('cloud db show')} my-database`,
-		`${getCommand('cloud db get')} my-database --show-credentials`,
+		{ command: `${getCommand('cloud db get')} my-database`, description: 'Get database details' },
+		{
+			command: `${getCommand('cloud db show')} my-database`,
+			description: 'Show database information',
+		},
+		{
+			command: `${getCommand('cloud db get')} my-database --show-credentials`,
+			description: 'Get database with credentials',
+		},
 	],
 	schema: {
 		args: z.object({
@@ -31,7 +37,9 @@ export const getSubcommand = createSubcommand({
 			showCredentials: z
 				.boolean()
 				.optional()
-				.describe('Show credentials in plain text (default: masked in terminal, unmasked in JSON)'),
+				.describe(
+					'Show credentials in plain text (default: masked in terminal, unmasked in JSON)'
+				),
 		}),
 		response: DBGetResponseSchema,
 	},

package/src/cmd/cloud/db/index.ts

@@ -4,11 +4,16 @@ import { listSubcommand } from './list';
 import { deleteSubcommand } from './delete';
 import { getSubcommand } from './get';
 import { sqlSubcommand } from './sql';
+import { getCommand } from '../../../command-prefix';
 
 export const dbCommand = createCommand({
 	name: 'db',
 	aliases: ['database'],
 	description: 'Manage database resources',
 	tags: ['slow', 'requires-auth', 'requires-deployment'],
+	examples: [
+		{ command: getCommand('cloud db list'), description: 'List all databases' },
+		{ command: getCommand('cloud db sql "SELECT * FROM users"'), description: 'Run SQL query' },
+	],
 	subcommands: [createSubcommand, listSubcommand, getSubcommand, deleteSubcommand, sqlSubcommand],
 });

package/src/cmd/cloud/db/list.ts

@@ -24,17 +24,23 @@ export const listSubcommand = createSubcommand({
 	requires: { auth: true, org: true, region: true },
 	idempotent: true,
 	examples: [
-		getCommand('cloud db list'),
-		getCommand('--json cloud db list'),
-		getCommand('cloud db ls'),
-		getCommand('cloud db list --show-credentials'),
+		{ command: getCommand('cloud db list'), description: 'List items' },
+		{ command: getCommand('--json cloud db list'), description: 'Show output in JSON format' },
+		{ command: getCommand('cloud db ls'), description: 'List items' },
+		{
+			command: getCommand('cloud db list --show-credentials'),
+			description: 'Use show credentials option',
+		},
 	],
 	schema: {
 		options: z.object({
 			showCredentials: z
 				.boolean()
 				.optional()
-				.describe('Show credentials in plain text (default: masked in terminal, unmasked in JSON)'),
+				.describe(
+					'Show credentials in plain text (default: masked in terminal, unmasked in JSON)'
+				),
+			nameOnly: z.boolean().optional().describe('Print the name only'),
 		}),
 		response: DBListResponseSchema,
 	},
@@ -60,9 +66,15 @@ export const listSubcommand = createSubcommand({
 			if (resources.db.length === 0) {
 				tui.info('No databases found');
 			} else {
-				tui.info(tui.bold('Databases'));
-				tui.newline();
+				if (!opts.nameOnly) {
+					tui.info(tui.bold('Databases'));
+					tui.newline();
+				}
 				for (const db of resources.db) {
+					if (opts.nameOnly) {
+						console.log(db.name);
+						continue;
+					}
 					console.log(tui.bold(db.name));
 					if (db.url) {
 						const displayUrl = shouldMask ? tui.maskSecret(db.url) : db.url;

package/src/cmd/cloud/db/sql.ts

@@ -28,9 +28,18 @@ export const sqlSubcommand = createSubcommand({
 	requires: { auth: true, org: true, region: true },
 	idempotent: false,
 	examples: [
-		`${getCommand('cloud db sql')} my-database "SELECT * FROM users LIMIT 10"`,
-		`${getCommand('cloud db exec')} my-database "SELECT COUNT(*) FROM orders" --json`,
-		`${getCommand('cloud db query')} my-database "SELECT * FROM products WHERE price > 100"`,
+		{
+			command: `${getCommand('cloud db sql')} my-database "SELECT * FROM users LIMIT 10"`,
+			description: 'Execute SQL query',
+		},
+		{
+			command: `${getCommand('cloud db exec')} my-database "SELECT COUNT(*) FROM orders" --json`,
+			description: 'Execute query with JSON output',
+		},
+		{
+			command: `${getCommand('cloud db query')} my-database "SELECT * FROM products WHERE price > 100"`,
+			description: 'Query with filter',
+		},
 	],
 	schema: {
 		args: z.object({

package/src/cmd/cloud/deploy.ts

@@ -57,9 +57,15 @@ export const deploySubcommand = createSubcommand({
 		'requires-project',
 	],
 	examples: [
-		`${getCommand('cloud deploy')}                    # Deploy current project`,
-		`${getCommand('cloud deploy')} --log-level=debug  # Deploy with verbose output`,
-		`${getCommand('cloud deploy')} --tag a --tag b    # Deploy with specific tags`,
+		{ command: getCommand('cloud deploy'), description: 'Deploy current project' },
+		{
+			command: getCommand('cloud deploy --log-level=debug'),
+			description: 'Deploy with verbose output',
+		},
+		{
+			command: getCommand('cloud deploy --tag a --tag b'),
+			description: 'Deploy with specific tags',
+		},
 	],
 	toplevel: true,
 	idempotent: false,

package/src/cmd/cloud/deployment/index.ts

@@ -5,12 +5,17 @@ import { showSubcommand } from './show';
 import { removeSubcommand } from './remove';
 import { rollbackSubcommand } from './rollback';
 import { undeploySubcommand } from './undeploy';
+import { getCommand } from '../../../command-prefix';
 
 export const deploymentCommand = createCommand({
 	name: 'deployment',
 	description: 'Manage deployments',
 	tags: ['read-only', 'fast', 'requires-auth'],
 	aliases: ['deployments', 'dep'],
+	examples: [
+		{ command: getCommand('cloud deployment list'), description: 'List all deployments' },
+		{ command: getCommand('cloud deployment logs <id>'), description: 'Show deployment logs' },
+	],
 	subcommands: [
 		listSubcommand,
 		logsSubcommand,

package/src/cmd/cloud/deployment/list.ts

@@ -22,9 +22,18 @@ export const listSubcommand = createSubcommand({
 	description: 'List deployments',
 	tags: ['read-only', 'slow', 'requires-auth'],
 	examples: [
-		`${getCommand('cloud deployment list')}           # List 10 most recent deployments`,
-		`${getCommand('cloud deployment list')} --count=25 # List 25 most recent deployments`,
-		`${getCommand('cloud deployment list')} --project-id=proj_abc123xyz`,
+		{
+			command: getCommand('cloud deployment list'),
+			description: 'List 10 most recent deployments',
+		},
+		{
+			command: getCommand('cloud deployment list --count=25'),
+			description: 'List 25 most recent deployments',
+		},
+		{
+			command: getCommand('cloud deployment list --project-id=proj_abc123xyz'),
+			description: 'List deployments for specific project',
+		},
 	],
 	aliases: ['ls'],
 	requires: { auth: true, apiClient: true },

package/src/cmd/cloud/deployment/logs.ts

@@ -12,10 +12,22 @@ export const logsSubcommand = createSubcommand({
 	description: 'View logs for a specific deployment',
 	tags: ['read-only', 'fast', 'requires-auth', 'requires-deployment'],
 	examples: [
-		`${getCommand('cloud deployment logs')} deploy_abc123xyz`,
-		`${getCommand('cloud deployment logs')} deploy_abc123xyz --limit=50`,
-		`${getCommand('cloud deployment logs')} deploy_abc123xyz --no-timestamps  # hide timestamps`,
-		`${getCommand('cloud deployment logs')} deploy_abc123xyz --project-id=proj_abc123xyz`,
+		{
+			command: getCommand('cloud deployment logs deploy_abc123xyz'),
+			description: 'View logs for deployment',
+		},
+		{
+			command: getCommand('cloud deployment logs deploy_abc123xyz --limit=50'),
+			description: 'Limit to 50 log entries',
+		},
+		{
+			command: getCommand('cloud deployment logs deploy_abc123xyz --no-timestamps'),
+			description: 'Hide timestamps',
+		},
+		{
+			command: getCommand('cloud deployment logs deploy_abc123xyz --project-id=proj_abc123xyz'),
+			description: 'View logs with specific project',
+		},
 	],
 	requires: { auth: true, apiClient: true },
 	optional: { project: true },

package/src/cmd/cloud/deployment/remove.ts

@@ -4,7 +4,6 @@ import * as tui from '../../../tui';
 import { projectDeploymentDelete } from '@agentuity/server';
 import { resolveProjectId } from './utils';
 import { getCommand } from '../../../command-prefix';
-
 const DeploymentRemoveResponseSchema = z.object({
 	success: z.boolean().describe('Whether the removal succeeded'),
 	projectId: z.string().describe('Project ID'),
@@ -16,9 +15,20 @@ export const removeSubcommand = createSubcommand({
 	description: 'Remove a specific deployment',
 	tags: ['destructive', 'deletes-resource', 'slow', 'requires-auth', 'requires-deployment'],
 	examples: [
-		`${getCommand('cloud deployment remove')} dep_abc123xyz        # Remove with confirmation`,
-		`${getCommand('cloud deployment remove')} dep_abc123xyz --force # Remove without confirmation`,
-		`${getCommand('cloud deployment remove')} deployment-2024-11-20 --project-id=proj_abc123xyz`,
+		{
+			command: getCommand('cloud deployment remove dep_abc123xyz'),
+			description: 'Remove with confirmation',
+		},
+		{
+			command: getCommand('cloud deployment remove dep_abc123xyz --force'),
+			description: 'Remove without confirmation',
+		},
+		{
+			command: getCommand(
+				'cloud deployment remove deployment-2024-11-20 --project-id=proj_abc123xyz'
+			),
+			description: 'Remove deployment from specific project',
+		},
 	],
 	aliases: ['rm', 'delete'],
 	idempotent: false,

package/src/cmd/cloud/deployment/rollback.ts

@@ -4,7 +4,6 @@ import * as tui from '../../../tui';
 import { projectDeploymentRollback, projectDeploymentList } from '@agentuity/server';
 import { resolveProjectId } from './utils';
 import { getCommand } from '../../../command-prefix';
-
 const DeploymentRollbackResponseSchema = z.object({
 	success: z.boolean().describe('Whether the rollback succeeded'),
 	projectId: z.string().describe('Project ID'),
@@ -24,8 +23,14 @@ export const rollbackSubcommand = createSubcommand({
 		'requires-deployment',
 	],
 	examples: [
-		`${getCommand('cloud deployment rollback')}                   # Rollback to previous deployment`,
-		`${getCommand('cloud deployment rollback')} --project-id=proj_abc123xyz`,
+		{
+			command: getCommand('cloud deployment rollback'),
+			description: 'Rollback to previous deployment',
+		},
+		{
+			command: getCommand('cloud deployment rollback --project-id=proj_abc123xyz'),
+			description: 'Rollback specific project',
+		},
 	],
 	idempotent: false,
 	requires: { auth: true, apiClient: true },

package/src/cmd/cloud/deployment/show.ts

@@ -55,8 +55,14 @@ export const showSubcommand = createSubcommand({
 	description: 'Show details about a specific deployment',
 	tags: ['read-only', 'fast', 'requires-auth', 'requires-deployment'],
 	examples: [
-		`${getCommand('cloud deployment show')} dep_abc123xyz`,
-		`${getCommand('cloud deployment show')} deployment-2024-11-20 --project-id=proj_abc123xyz`,
+		{
+			command: `${getCommand('cloud deployment show')} dep_abc123xyz`,
+			description: 'Show deployment details by ID',
+		},
+		{
+			command: `${getCommand('cloud deployment show')} deployment-2024-11-20 --project-id=proj_abc123xyz`,
+			description: 'Show deployment for specific project',
+		},
 	],
 	aliases: ['get'],
 	requires: { auth: true, apiClient: true },

package/src/cmd/cloud/deployment/undeploy.ts

@@ -4,15 +4,23 @@ import * as tui from '../../../tui';
 import { projectDeploymentUndeploy } from '@agentuity/server';
 import { resolveProjectId } from './utils';
 import { getCommand } from '../../../command-prefix';
-
 export const undeploySubcommand = createSubcommand({
 	name: 'undeploy',
 	description: 'Undeploy the latest deployment',
 	tags: ['destructive', 'deletes-resource', 'slow', 'requires-auth', 'requires-deployment'],
 	examples: [
-		`${getCommand('cloud deployment undeploy')}        # Undeploy with confirmation`,
-		`${getCommand('cloud deployment undeploy')} --force # Undeploy without confirmation`,
-		`${getCommand('cloud deployment undeploy')} --project-id=proj_abc123xyz`,
+		{
+			command: getCommand('cloud deployment undeploy'),
+			description: 'Undeploy with confirmation',
+		},
+		{
+			command: getCommand('cloud deployment undeploy --force'),
+			description: 'Undeploy without confirmation',
+		},
+		{
+			command: getCommand('cloud deployment undeploy --project-id=proj_abc123xyz'),
+			description: 'Undeploy specific project',
+		},
 	],
 	idempotent: false,
 	requires: { auth: true, apiClient: true },

package/src/cmd/cloud/deployment/utils.ts

@@ -1,5 +1,11 @@
+import { StructuredError } from '@agentuity/core';
 import { ProjectConfig } from '../../../types';
 
+const ProjectIDRequiredError = StructuredError(
+	'ProjectIDRequiredError',
+	'Project ID is required. Use --project-id or run from a project directory.'
+);
+
 export function resolveProjectId(
 	ctx: { project?: ProjectConfig },
 	options: { projectId?: string }
@@ -10,5 +16,5 @@ export function resolveProjectId(
 	if (ctx.project?.projectId) {
 		return ctx.project.projectId;
 	}
-	throw new Error('Project ID is required. Use --project-id or run from a project directory.');
+	throw new ProjectIDRequiredError();
 }

package/src/cmd/cloud/domain.ts

@@ -1,5 +1,6 @@
 import * as dns from 'node:dns';
 import type { Config } from '../../types';
+import { StructuredError } from '@agentuity/core';
 
 export interface DNSResult {
 	domain: string;
@@ -7,6 +8,13 @@ export interface DNSResult {
 	message?: string;
 }
 
+const timeoutMs = 5000;
+
+const DNSTimeoutError = StructuredError(
+	'DNSTimeoutError',
+	`DNS lookup timed out after ${timeoutMs}ms`
+);
+
 /**
  * This function will check for each of the custom domains and make sure they are correctly
  * configured in DNS
@@ -31,12 +39,11 @@ export async function checkCustomDomainForDNS(
 	return Promise.all(
 		domains.map(async (domain) => {
 			try {
-				const timeoutMs = 5000;
 				let timeoutId: Timer | undefined;
 
 				const timeoutPromise = new Promise<never>((_, reject) => {
 					timeoutId = setTimeout(() => {
-						reject(new Error(`DNS lookup timed out after ${timeoutMs}ms`));
+						reject(new DNSTimeoutError());
 					}, timeoutMs);
 				});
 

package/src/cmd/cloud/env/delete.ts

@@ -22,7 +22,10 @@ export const deleteSubcommand = createSubcommand({
 	description: 'Delete an environment variable',
 	tags: ['destructive', 'deletes-resource', 'slow', 'requires-auth', 'requires-project'],
 	idempotent: true,
-	examples: [getCommand('env delete OLD_FEATURE_FLAG'), getCommand('env rm PORT')],
+	examples: [
+		{ command: getCommand('env delete OLD_FEATURE_FLAG'), description: 'Delete item' },
+		{ command: getCommand('env rm PORT'), description: 'Delete item' },
+	],
 	requires: { auth: true, project: true, apiClient: true },
 	schema: {
 		args: z.object({

package/src/cmd/cloud/env/get.ts

@@ -14,7 +14,10 @@ export const getSubcommand = createSubcommand({
 	name: 'get',
 	description: 'Get an environment variable value',
 	tags: ['read-only', 'fast', 'requires-auth', 'requires-project'],
-	examples: [getCommand('env get NODE_ENV'), getCommand('env get LOG_LEVEL')],
+	examples: [
+		{ command: getCommand('env get NODE_ENV'), description: 'Get item details' },
+		{ command: getCommand('env get LOG_LEVEL'), description: 'Get item details' },
+	],
 	requires: { auth: true, project: true, apiClient: true },
 	schema: {
 		args: z.object({

package/src/cmd/cloud/env/import.ts

@@ -32,6 +32,16 @@ export const importSubcommand = createSubcommand({
 		'requires-auth',
 		'requires-project',
 	],
+	examples: [
+		{
+			command: getCommand('cloud env import .env'),
+			description: 'Import environment variables from .env file',
+		},
+		{
+			command: getCommand('cloud env import .env.local'),
+			description: 'Import from .env.local file',
+		},
+	],
 	idempotent: false,
 	requires: { auth: true, project: true, apiClient: true },
 	schema: {

package/src/cmd/cloud/env/index.ts

@@ -6,11 +6,19 @@ import { getSubcommand } from './get';
 import { deleteSubcommand } from './delete';
 import { importSubcommand } from './import';
 import { listSubcommand } from './list';
+import { getCommand } from '../../../command-prefix';
 
 export const command = createCommand({
 	name: 'env',
 	description: 'Manage environment variables for your project',
 	tags: ['fast', 'requires-auth', 'requires-project'],
+	examples: [
+		{ command: getCommand('cloud env list'), description: 'List environment variables' },
+		{
+			command: getCommand('cloud env set NODE_ENV production'),
+			description: 'Set environment variable',
+		},
+	],
 	subcommands: [
 		listSubcommand,
 		pullSubcommand,

package/src/cmd/cloud/env/list.ts

@@ -14,7 +14,10 @@ export const listSubcommand = createSubcommand({
 	aliases: ['ls'],
 	description: 'List all environment variables',
 	tags: ['read-only', 'fast', 'requires-auth', 'requires-project'],
-	examples: [getCommand('env list'), getCommand('env list --mask')],
+	examples: [
+		{ command: getCommand('env list'), description: 'List items' },
+		{ command: getCommand('env list --mask'), description: 'Use mask option' },
+	],
 	requires: { auth: true, project: true, apiClient: true },
 	idempotent: true,
 	schema: {

package/src/cmd/cloud/env/pull.ts

@@ -24,7 +24,10 @@ export const pullSubcommand = createSubcommand({
 	description: 'Pull environment variables from cloud to local .env.production file',
 	tags: ['slow', 'requires-auth', 'requires-project'],
 	idempotent: true,
-	examples: [getCommand('env pull'), getCommand('env pull --force')],
+	examples: [
+		{ command: getCommand('env pull'), description: 'Run pull command' },
+		{ command: getCommand('env pull --force'), description: 'Use force option' },
+	],
 	requires: { auth: true, project: true, apiClient: true },
 	prerequisites: ['cloud deploy'],
 	schema: {

package/src/cmd/cloud/env/push.ts

@@ -23,7 +23,7 @@ export const pushSubcommand = createSubcommand({
 		'requires-project',
 	],
 	idempotent: true,
-	examples: [getCommand('env push')],
+	examples: [{ command: getCommand('env push'), description: 'Run push command' }],
 	requires: { auth: true, project: true, apiClient: true },
 	prerequisites: ['env set'],
 	schema: {

package/src/cmd/cloud/env/set.ts

@@ -24,9 +24,9 @@ export const setSubcommand = createSubcommand({
 	idempotent: true,
 	requires: { auth: true, project: true, apiClient: true },
 	examples: [
-		getCommand('env set NODE_ENV production'),
-		getCommand('env set PORT 3000'),
-		getCommand('env set LOG_LEVEL debug'),
+		{ command: getCommand('env set NODE_ENV production'), description: 'Run production command' },
+		{ command: getCommand('env set PORT 3000'), description: 'Run 3000 command' },
+		{ command: getCommand('env set LOG_LEVEL debug'), description: 'Run debug command' },
 	],
 	schema: {
 		args: z.object({

package/src/cmd/cloud/index.ts

@@ -3,6 +3,7 @@ import { deploySubcommand } from './deploy';
 import { dbCommand } from './db';
 import { storageCommand } from './storage';
 import { sessionCommand } from './session';
+import { threadCommand } from './thread';
 import { sshSubcommand } from './ssh';
 import { scpSubcommand } from './scp';
 import { deploymentCommand } from './deployment';
@@ -14,12 +15,16 @@ import secretCommand from './secret';
 import apikeyCommand from './apikey';
 import streamCommand from './stream';
 import vectorCommand from './vector';
-
+import { getCommand } from '../../command-prefix';
 
 export const command = createCommand({
 	name: 'cloud',
 	description: 'Cloud related commands',
 	tags: ['slow', 'requires-auth'],
+	examples: [
+		{ command: getCommand('cloud deploy'), description: 'Deploy your agent to the cloud' },
+		{ command: getCommand('cloud deployment list'), description: 'List all deployments' },
+	],
 	subcommands: [
 		apikeyCommand,
 		keyvalueCommand,
@@ -33,6 +38,7 @@ export const command = createCommand({
 		dbCommand,
 		storageCommand,
 		sessionCommand,
+		threadCommand,
 		sshSubcommand,
 		scpSubcommand,
 		deploymentCommand,

package/src/cmd/cloud/keyvalue/create-namespace.ts

@@ -3,7 +3,6 @@ import { createCommand } from '../../../types';
 import * as tui from '../../../tui';
 import { createStorageAdapter } from './util';
 import { getCommand } from '../../../command-prefix';
-
 export const createNamespaceSubcommand = createCommand({
 	name: 'create-namespace',
 	aliases: ['create'],
@@ -12,9 +11,15 @@ export const createNamespaceSubcommand = createCommand({
 	idempotent: false,
 	requires: { auth: true, project: true },
 	examples: [
-		`${getCommand('kv create-namespace production')} - Create production namespace`,
-		`${getCommand('kv create staging')} - Create staging namespace (using alias)`,
-		`${getCommand('kv create cache')} - Create cache namespace`,
+		{
+			command: getCommand('kv create-namespace production'),
+			description: 'Create production namespace',
+		},
+		{
+			command: getCommand('kv create staging'),
+			description: 'Create staging namespace (using alias)',
+		},
+		{ command: getCommand('kv create cache'), description: 'Create cache namespace' },
 	],
 	schema: {
 		args: z.object({