@agentuity/cli 0.0.60 → 0.0.62

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

@@ -4,7 +4,6 @@ import { ErrorCode } from '../../../errors';
 import * as tui from '../../../tui';
 import { createStorageAdapter } from './util';
 import { getCommand } from '../../../command-prefix';
-
 export const deleteNamespaceSubcommand = createCommand({
 	name: 'delete-namespace',
 	aliases: ['rm-namespace'],
@@ -13,9 +12,18 @@ export const deleteNamespaceSubcommand = createCommand({
 	idempotent: true,
 	requires: { auth: true, project: true },
 	examples: [
-		`${getCommand('kv delete-namespace staging')} - Delete staging namespace (interactive)`,
-		`${getCommand('kv rm-namespace cache --confirm')} - Delete cache without confirmation`,
-		`${getCommand('kv delete-namespace production --confirm')} - Force delete production`,
+		{
+			command: getCommand('kv delete-namespace staging'),
+			description: 'Delete staging namespace (interactive)',
+		},
+		{
+			command: getCommand('kv rm-namespace cache --confirm'),
+			description: 'Delete cache without confirmation',
+		},
+		{
+			command: getCommand('kv delete-namespace production --confirm'),
+			description: 'Force delete production',
+		},
 	],
 	schema: {
 		args: z.object({

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

@@ -3,7 +3,6 @@ import { createCommand } from '../../../types';
 import * as tui from '../../../tui';
 import { createStorageAdapter } from './util';
 import { getCommand } from '../../../command-prefix';
-
 const KVDeleteResponseSchema = z.object({
 	success: z.boolean().describe('Whether the operation succeeded'),
 	namespace: z.string().describe('Namespace name'),
@@ -19,9 +18,12 @@ export const deleteSubcommand = createCommand({
 	idempotent: true,
 	requires: { auth: true, project: true },
 	examples: [
-		`${getCommand('kv delete production user:123')} - Delete user data`,
-		`${getCommand('kv delete cache session:abc')} - Delete cached session`,
-		`${getCommand('kv rm staging cache:homepage')} - Delete homepage cache (using alias)`,
+		{ command: getCommand('kv delete production user:123'), description: 'Delete user data' },
+		{ command: getCommand('kv delete cache session:abc'), description: 'Delete cached session' },
+		{
+			command: getCommand('kv rm staging cache:homepage'),
+			description: 'Delete homepage cache (using alias)',
+		},
 	],
 	schema: {
 		args: z.object({

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

@@ -4,7 +4,6 @@ import * as tui from '../../../tui';
 import { tryParseJSON } from '../../../json';
 import { createStorageAdapter } from './util';
 import { getCommand } from '../../../command-prefix';
-
 const KVGetResponseSchema = z.object({
 	exists: z.boolean().describe('Whether the key exists'),
 	data: z.union([z.string(), z.any()]).optional().describe('Value data (string or binary)'),
@@ -17,9 +16,9 @@ export const getSubcommand = createCommand({
 	tags: ['read-only', 'fast', 'requires-auth'],
 	requires: { auth: true, project: true },
 	examples: [
-		`${getCommand('kv get production user:123')} - Get user data`,
-		`${getCommand('kv get cache session:abc')} - Get cached session`,
-		`${getCommand('kv get staging cache:homepage')} - Get homepage cache`,
+		{ command: getCommand('kv get production user:123'), description: 'Get user data' },
+		{ command: getCommand('kv get cache session:abc'), description: 'Get cached session' },
+		{ command: getCommand('kv get staging cache:homepage'), description: 'Get homepage cache' },
 	],
 	schema: {
 		args: z.object({

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

@@ -9,12 +9,20 @@ import { replSubcommand } from './repl';
 import { searchSubcommand } from './search';
 import { setSubcommand } from './set';
 import { statsSubcommand } from './stats';
+import { getCommand } from '../../../command-prefix';
 
 export const command = createCommand({
 	name: 'keyvalue',
 	aliases: ['kv'],
 	description: 'Manage keyvalue storage for your projects',
 	tags: ['read-only', 'fast', 'requires-auth'],
+	examples: [
+		{
+			command: getCommand('cloud keyvalue repl'),
+			description: 'Start interactive key-value REPL',
+		},
+		{ command: getCommand('cloud kv get mykey'), description: 'Get value for key' },
+	],
 	subcommands: [
 		replSubcommand,
 		getSubcommand,

package/src/cmd/cloud/keyvalue/keys.ts

@@ -3,7 +3,6 @@ import { createCommand } from '../../../types';
 import * as tui from '../../../tui';
 import { createStorageAdapter } from './util';
 import { getCommand } from '../../../command-prefix';
-
 const KVKeysResponseSchema = z.object({
 	namespace: z.string().describe('Namespace name'),
 	keys: z.array(z.string()).describe('List of keys in the namespace'),
@@ -17,9 +16,9 @@ export const keysSubcommand = createCommand({
 	requires: { auth: true, project: true },
 	idempotent: true,
 	examples: [
-		`${getCommand('kv keys production')} - List all keys in production`,
-		`${getCommand('kv ls cache')} - List all cached keys (using alias)`,
-		`${getCommand('kv list staging')} - List all staging keys`,
+		{ command: getCommand('kv keys production'), description: 'List all keys in production' },
+		{ command: getCommand('kv ls cache'), description: 'List all cached keys (using alias)' },
+		{ command: getCommand('kv list staging'), description: 'List all staging keys' },
 	],
 	schema: {
 		args: z.object({

package/src/cmd/cloud/keyvalue/list-namespaces.ts

@@ -3,7 +3,6 @@ import { createCommand } from '../../../types';
 import * as tui from '../../../tui';
 import { createStorageAdapter } from './util';
 import { getCommand } from '../../../command-prefix';
-
 const NamespaceListResponseSchema = z.array(z.string().describe('Namespace name'));
 
 export const listNamespacesSubcommand = createCommand({
@@ -13,9 +12,9 @@ export const listNamespacesSubcommand = createCommand({
 	tags: ['read-only', 'fast', 'requires-auth'],
 	requires: { auth: true, project: true },
 	examples: [
-		`${getCommand('kv list-namespaces')} - List all namespaces`,
-		`${getCommand('kv namespaces')} - List namespaces (using alias)`,
-		`${getCommand('kv ns')} - List namespaces (short alias)`,
+		{ command: getCommand('kv list-namespaces'), description: 'List all namespaces' },
+		{ command: getCommand('kv namespaces'), description: 'List namespaces (using alias)' },
+		{ command: getCommand('kv ns'), description: 'List namespaces (short alias)' },
 	],
 	schema: {
 		response: NamespaceListResponseSchema,

package/src/cmd/cloud/keyvalue/repl.ts

@@ -6,14 +6,13 @@ import * as tui from '../../../tui';
 import { isPossiblyJSON, tryParseJSON } from '../../../json';
 import { createStorageAdapter } from './util';
 import { getCommand } from '../../../command-prefix';
-
 export const replSubcommand = createCommand({
 	name: 'repl',
 	description: 'Start an interactive repl for working with keyvalue database',
 	tags: ['slow', 'requires-auth'],
 	idempotent: false,
 	requires: { auth: true, project: true },
-	examples: [`${getCommand('kv repl')} - Start interactive KV session`],
+	examples: [{ command: getCommand('kv repl'), description: 'Start interactive KV session' }],
 
 	async handler(ctx) {
 		showBanner(undefined, true);

package/src/cmd/cloud/keyvalue/search.ts

@@ -3,7 +3,6 @@ import { createCommand } from '../../../types';
 import * as tui from '../../../tui';
 import { createStorageAdapter } from './util';
 import { getCommand } from '../../../command-prefix';
-
 const KVSearchResponseSchema = z.object({
 	namespace: z.string().describe('Namespace name'),
 	keyword: z.string().describe('Search keyword used'),
@@ -24,9 +23,15 @@ export const searchSubcommand = createCommand({
 	requires: { auth: true, project: true },
 	idempotent: true,
 	examples: [
-		`${getCommand('kv search production user')} - Find all user-related keys`,
-		`${getCommand('kv search cache session')} - Find all session keys in cache`,
-		`${getCommand('kv search staging config')} - Find all config keys`,
+		{
+			command: getCommand('kv search production user'),
+			description: 'Find all user-related keys',
+		},
+		{
+			command: getCommand('kv search cache session'),
+			description: 'Find all session keys in cache',
+		},
+		{ command: getCommand('kv search staging config'), description: 'Find all config keys' },
 	],
 	schema: {
 		args: z.object({

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

@@ -4,7 +4,6 @@ import * as tui from '../../../tui';
 import { isPossiblyJSON } from '../../../json';
 import { createStorageAdapter } from './util';
 import { getCommand } from '../../../command-prefix';
-
 const KVSetResponseSchema = z.object({
 	success: z.boolean().describe('Whether the operation succeeded'),
 	namespace: z.string().describe('Namespace name'),
@@ -22,9 +21,20 @@ export const setSubcommand = createCommand({
 	idempotent: true,
 	requires: { auth: true, project: true },
 	examples: [
-		`${getCommand('kv set production user:123 \'{"name":"Alice","email":"alice@example.com"}\'')} - Store user data`,
-		`${getCommand('kv set cache session:abc "session-data-here" --ttl 3600')} - Store session with 1h TTL`,
-		`${getCommand('kv set staging cache:homepage "<!DOCTYPE html>..." --ttl 600')} - Cache homepage for 10m`,
+		{
+			command: getCommand(
+				'kv set production user:123 \'{"name":"Alice","email":"alice@example.com"}\''
+			),
+			description: 'Store user data',
+		},
+		{
+			command: getCommand('kv set cache session:abc "session-data-here" --ttl 3600'),
+			description: 'Store session with 1h TTL',
+		},
+		{
+			command: getCommand('kv set staging cache:homepage "<!DOCTYPE html>..." --ttl 600'),
+			description: 'Cache homepage for 10m',
+		},
 	],
 	schema: {
 		args: z.object({

package/src/cmd/cloud/keyvalue/stats.ts

@@ -3,7 +3,6 @@ import { createCommand } from '../../../types';
 import * as tui from '../../../tui';
 import { createStorageAdapter } from './util';
 import { getCommand } from '../../../command-prefix';
-
 const KVStatsResponseSchema = z.union([
 	z.object({
 		namespace: z.string().describe('Namespace name'),
@@ -30,9 +29,12 @@ export const statsSubcommand = createCommand({
 	requires: { auth: true, project: true },
 	idempotent: true,
 	examples: [
-		`${getCommand('kv stats')} - Show stats for all namespaces`,
-		`${getCommand('kv stats production')} - Show stats for production namespace`,
-		`${getCommand('kv stats cache')} - Show stats for cache namespace`,
+		{ command: getCommand('kv stats'), description: 'Show stats for all namespaces' },
+		{
+			command: getCommand('kv stats production'),
+			description: 'Show stats for production namespace',
+		},
+		{ command: getCommand('kv stats cache'), description: 'Show stats for cache namespace' },
 	],
 	schema: {
 		args: z.object({

package/src/cmd/cloud/objectstore/delete-bucket.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 deleteBucketSubcommand = createCommand({
 	name: 'delete-bucket',
 	description: 'Delete an object storage bucket and all its contents',
@@ -11,8 +10,14 @@ export const deleteBucketSubcommand = createCommand({
 	idempotent: true,
 	requires: { auth: true, project: true },
 	examples: [
-		`${getCommand('objectstore delete-bucket temp')} - Delete temp bucket (interactive)`,
-		`${getCommand('objectstore delete-bucket old-uploads --confirm')} - Force delete without confirmation`,
+		{
+			command: getCommand('objectstore delete-bucket temp'),
+			description: 'Delete temp bucket (interactive)',
+		},
+		{
+			command: getCommand('objectstore delete-bucket old-uploads --confirm'),
+			description: 'Force delete without confirmation',
+		},
 	],
 	schema: {
 		args: z.object({

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

@@ -3,7 +3,6 @@ import { createCommand } from '../../../types';
 import * as tui from '../../../tui';
 import { createStorageAdapter } from './util';
 import { getCommand } from '../../../command-prefix';
-
 const ObjectStoreDeleteResponseSchema = z.object({
 	success: z.boolean().describe('Whether the operation succeeded'),
 	bucket: z.string().describe('Bucket name'),
@@ -22,9 +21,18 @@ export const deleteSubcommand = createCommand({
 	idempotent: true,
 	requires: { auth: true, project: true },
 	examples: [
-		`${getCommand('objectstore delete uploads images/old-logo.png')} - Delete old logo`,
-		`${getCommand('objectstore rm assets data/temp.json')} - Remove temp file (using alias)`,
-		`${getCommand('objectstore delete backups db-2023.sql')} - Delete old backup`,
+		{
+			command: getCommand('objectstore delete uploads images/old-logo.png'),
+			description: 'Delete old logo',
+		},
+		{
+			command: getCommand('objectstore rm assets data/temp.json'),
+			description: 'Remove temp file (using alias)',
+		},
+		{
+			command: getCommand('objectstore delete backups db-2023.sql'),
+			description: 'Delete old backup',
+		},
 	],
 	schema: {
 		args: z.object({

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

@@ -4,7 +4,6 @@ import * as tui from '../../../tui';
 import { tryParseJSON } from '../../../json';
 import { createStorageAdapter } from './util';
 import { getCommand } from '../../../command-prefix';
-
 const ObjectGetResponseSchema = z.object({
 	exists: z.boolean().describe('Whether the object exists'),
 	data: z.any().optional().describe('Object data (binary)'),
@@ -17,9 +16,18 @@ export const getSubcommand = createCommand({
 	tags: ['read-only', 'slow', 'requires-auth'],
 	requires: { auth: true, project: true },
 	examples: [
-		`${getCommand('objectstore get uploads images/logo.png')} - Download logo image`,
-		`${getCommand('objectstore get assets data/export.json')} - Get JSON export`,
-		`${getCommand('objectstore get backups db-2024.sql')} - Get database backup`,
+		{
+			command: getCommand('objectstore get uploads images/logo.png'),
+			description: 'Download logo image',
+		},
+		{
+			command: getCommand('objectstore get assets data/export.json'),
+			description: 'Get JSON export',
+		},
+		{
+			command: getCommand('objectstore get backups db-2024.sql'),
+			description: 'Get database backup',
+		},
 	],
 	schema: {
 		args: z.object({

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

@@ -7,12 +7,20 @@ import { listKeysSubcommand } from './list-keys';
 import { putSubcommand } from './put';
 import { replSubcommand } from './repl';
 import { urlSubcommand } from './url';
+import { getCommand } from '../../../command-prefix';
 
 export const command = createCommand({
 	name: 'objectstore',
 	aliases: ['object', 'obj'],
 	description: 'Manage object storage for your projects',
 	tags: ['read-only', 'fast', 'requires-auth'],
+	examples: [
+		{
+			command: getCommand('cloud objectstore repl'),
+			description: 'Start interactive object store REPL',
+		},
+		{ command: getCommand('cloud objectstore list-buckets'), description: 'List all buckets' },
+	],
 	subcommands: [
 		replSubcommand,
 		getSubcommand,

package/src/cmd/cloud/objectstore/list-buckets.ts

@@ -3,7 +3,6 @@ import { createCommand } from '../../../types';
 import * as tui from '../../../tui';
 import { createStorageAdapter } from './util';
 import { getCommand } from '../../../command-prefix';
-
 const BucketListResponseSchema = z.array(
 	z.object({
 		name: z.string().describe('Bucket name'),
@@ -21,7 +20,12 @@ export const listBucketsSubcommand = createCommand({
 		response: BucketListResponseSchema,
 	},
 	idempotent: true,
-	examples: [`${getCommand('objectstore list-buckets')} - List all buckets with stats`],
+	examples: [
+		{
+			command: getCommand('objectstore list-buckets'),
+			description: 'List all buckets with stats',
+		},
+	],
 
 	async handler(ctx) {
 		const { options } = ctx;

package/src/cmd/cloud/objectstore/list-keys.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 listKeysSubcommand = createCommand({
 	name: 'list-keys',
 	aliases: ['ls', 'list'],
@@ -12,9 +11,12 @@ export const listKeysSubcommand = createCommand({
 	requires: { auth: true, project: true },
 	idempotent: true,
 	examples: [
-		`${getCommand('objectstore list-keys uploads')} - List all uploaded files`,
-		`${getCommand('objectstore ls assets')} - List assets (using alias)`,
-		`${getCommand('objectstore list backups')} - List all backups`,
+		{
+			command: getCommand('objectstore list-keys uploads'),
+			description: 'List all uploaded files',
+		},
+		{ command: getCommand('objectstore ls assets'), description: 'List assets (using alias)' },
+		{ command: getCommand('objectstore list backups'), description: 'List all backups' },
 	],
 	schema: {
 		args: z.object({

package/src/cmd/cloud/objectstore/put.ts

@@ -4,7 +4,6 @@ import * as tui from '../../../tui';
 import { isPossiblyJSON } from '../../../json';
 import { createStorageAdapter } from './util';
 import { getCommand } from '../../../command-prefix';
-
 const ObjectStorePutResponseSchema = z.object({
 	success: z.boolean().describe('Whether the operation succeeded'),
 	bucket: z.string().describe('Bucket name'),
@@ -21,9 +20,22 @@ export const putSubcommand = createCommand({
 	idempotent: true,
 	requires: { auth: true, project: true },
 	examples: [
-		`${getCommand('objectstore put uploads images/logo.png @./logo.png')} - Upload logo from file`,
-		`${getCommand('objectstore put assets data/config.json \'{"api":"https://api.example.com"}\'')} - Store JSON config`,
-		`${getCommand('objectstore put backups db-2024.sql @~/Downloads/backup.sql --content-type application/sql')} - Upload SQL backup`,
+		{
+			command: getCommand('objectstore put uploads images/logo.png @./logo.png'),
+			description: 'Upload logo from file',
+		},
+		{
+			command: getCommand(
+				'objectstore put assets data/config.json \'{"api":"https://api.example.com"}\''
+			),
+			description: 'Store JSON config',
+		},
+		{
+			command: getCommand(
+				'objectstore put backups db-2024.sql @~/Downloads/backup.sql --content-type application/sql'
+			),
+			description: 'Upload SQL backup',
+		},
 	],
 	schema: {
 		args: z.object({

package/src/cmd/cloud/objectstore/repl.ts

@@ -6,14 +6,18 @@ import * as tui from '../../../tui';
 import { isPossiblyJSON, tryParseJSON } from '../../../json';
 import { createStorageAdapter } from './util';
 import { getCommand } from '../../../command-prefix';
-
 export const replSubcommand = createCommand({
 	name: 'repl',
 	description: 'Start an interactive repl for working with object storage',
 	tags: ['slow', 'requires-auth'],
 	idempotent: false,
 	requires: { auth: true, project: true },
-	examples: [`${getCommand('objectstore repl')} - Start interactive object storage session`],
+	examples: [
+		{
+			command: getCommand('objectstore repl'),
+			description: 'Start interactive object storage session',
+		},
+	],
 
 	async handler(ctx) {
 		showBanner(undefined, true);

package/src/cmd/cloud/objectstore/url.ts

@@ -3,7 +3,6 @@ import { createCommand } from '../../../types';
 import * as tui from '../../../tui';
 import { createStorageAdapter } from './util';
 import { getCommand } from '../../../command-prefix';
-
 const ObjectStoreURLResponseSchema = z.object({
 	success: z.boolean().describe('Whether the operation succeeded'),
 	bucket: z.string().describe('Bucket name'),
@@ -21,9 +20,18 @@ export const urlSubcommand = createCommand({
 	requires: { auth: true, project: true },
 	idempotent: true,
 	examples: [
-		`${getCommand('objectstore url uploads images/logo.png')} - Get public URL for logo`,
-		`${getCommand('objectstore url assets data/export.json --expires 3600')} - Get 1h temporary URL`,
-		`${getCommand('objectstore presigned backups db-2024.sql --expires 300')} - Get 5m presigned URL`,
+		{
+			command: getCommand('objectstore url uploads images/logo.png'),
+			description: 'Get public URL for logo',
+		},
+		{
+			command: getCommand('objectstore url assets data/export.json --expires 3600'),
+			description: 'Get 1h temporary URL',
+		},
+		{
+			command: getCommand('objectstore presigned backups db-2024.sql --expires 300'),
+			description: 'Get 5m presigned URL',
+		},
 	],
 	schema: {
 		args: z.object({

package/src/cmd/cloud/scp/download.ts

@@ -3,7 +3,6 @@ import { createSubcommand } from '../../../types';
 import * as tui from '../../../tui';
 import { getIONHost } from '../../../config';
 import { getCommand } from '../../../command-prefix';
-
 const args = z.object({
 	source: z.string().describe('the source file'),
 	destination: z.string().optional().describe('the destination file'),
@@ -20,10 +19,22 @@ export const downloadCommand = createSubcommand({
 	tags: ['read-only', 'slow', 'requires-auth', 'requires-deployment'],
 	idempotent: true,
 	examples: [
-		`${getCommand('cloud scp download')} /var/log/app.log          # Download to current directory`,
-		`${getCommand('cloud scp download')} /var/log/app.log ./logs/  # Download to specific path`,
-		`${getCommand('cloud scp download')} /app/config.json --identifier=proj_abc123xyz`,
-		`${getCommand('cloud scp download')} ~/logs/*.log ./logs/      # Download multiple files`,
+		{
+			command: getCommand('cloud scp download /var/log/app.log'),
+			description: 'Download to current directory',
+		},
+		{
+			command: getCommand('cloud scp download /var/log/app.log ./logs/'),
+			description: 'Download to specific path',
+		},
+		{
+			command: getCommand('cloud scp download /app/config.json --identifier=proj_abc123xyz'),
+			description: 'Download from specific project',
+		},
+		{
+			command: getCommand('cloud scp download ~/logs/*.log ./logs/'),
+			description: 'Download multiple files',
+		},
 	],
 	requires: { apiClient: true, auth: true },
 	optional: { project: true },

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

@@ -1,10 +1,21 @@
 import { createCommand } from '../../../types';
 import { downloadCommand } from './download';
 import { uploadCommand } from './upload';
+import { getCommand } from '../../../command-prefix';
 
 export const scpSubcommand = createCommand({
 	name: 'scp',
 	description: 'Secure Copy commands',
 	tags: ['slow', 'requires-auth', 'requires-deployment'],
+	examples: [
+		{
+			command: getCommand('cloud scp upload ./local-file.txt /remote-path/'),
+			description: 'Upload file to deployment',
+		},
+		{
+			command: getCommand('cloud scp download /remote-file.txt ./local-path/'),
+			description: 'Download file from deployment',
+		},
+	],
 	subcommands: [downloadCommand, uploadCommand],
 });

package/src/cmd/cloud/scp/upload.ts

@@ -3,7 +3,6 @@ import { createSubcommand } from '../../../types';
 import * as tui from '../../../tui';
 import { getIONHost } from '../../../config';
 import { getCommand } from '../../../command-prefix';
-
 const args = z.object({
 	source: z.string().describe('the source file'),
 	destination: z
@@ -23,10 +22,22 @@ export const uploadCommand = createSubcommand({
 	tags: ['mutating', 'updates-resource', 'slow', 'requires-auth', 'requires-deployment'],
 	idempotent: false,
 	examples: [
-		`${getCommand('cloud scp upload')} ./config.json                # Upload to remote home directory`,
-		`${getCommand('cloud scp upload')} ./config.json /app/config.json # Upload to specific path`,
-		`${getCommand('cloud scp upload')} ./config.json --identifier=proj_abc123xyz`,
-		`${getCommand('cloud scp upload')} ./logs/*.log ~/logs/        # Upload multiple files`,
+		{
+			command: getCommand('cloud scp upload ./config.json'),
+			description: 'Upload to remote home directory',
+		},
+		{
+			command: getCommand('cloud scp upload ./config.json /app/config.json'),
+			description: 'Upload to specific path',
+		},
+		{
+			command: getCommand('cloud scp upload ./config.json --identifier=proj_abc123xyz'),
+			description: 'Upload to specific project',
+		},
+		{
+			command: getCommand('cloud scp upload ./logs/*.log ~/logs/'),
+			description: 'Upload multiple files',
+		},
 	],
 	requires: { apiClient: true, auth: true },
 	schema: {

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

@@ -17,7 +17,10 @@ export const deleteSubcommand = createSubcommand({
 	description: 'Delete a secret',
 	tags: ['destructive', 'deletes-resource', 'slow', 'requires-auth', 'requires-project'],
 	idempotent: true,
-	examples: [getCommand('secret delete OLD_API_KEY'), getCommand('secret rm DATABASE_URL')],
+	examples: [
+		{ command: getCommand('secret delete OLD_API_KEY'), description: 'Delete item' },
+		{ command: getCommand('secret rm DATABASE_URL'), description: 'Delete item' },
+	],
 	requires: { auth: true, project: true, apiClient: true },
 	schema: {
 		args: z.object({

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

@@ -15,8 +15,11 @@ export const getSubcommand = createSubcommand({
 	description: 'Get a secret value',
 	tags: ['read-only', 'fast', 'requires-auth', 'requires-project'],
 	examples: [
-		getCommand('secret get DATABASE_URL'),
-		getCommand('secret get STRIPE_SECRET_KEY --no-mask'),
+		{ command: getCommand('secret get DATABASE_URL'), description: 'Get item details' },
+		{
+			command: getCommand('secret get STRIPE_SECRET_KEY --no-mask'),
+			description: 'Use no mask option',
+		},
 	],
 	requires: { auth: true, project: true, apiClient: true },
 	schema: {

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

@@ -31,8 +31,11 @@ export const importSubcommand = createSubcommand({
 		'requires-project',
 	],
 	examples: [
-		getCommand('secret import .env.local'),
-		getCommand('secret import .env.production.backup'),
+		{ command: getCommand('secret import .env.local'), description: 'Run .env.local command' },
+		{
+			command: getCommand('secret import .env.production.backup'),
+			description: 'Run .env.production.backup command',
+		},
 	],
 	idempotent: false,
 	requires: { auth: true, project: true, apiClient: true },

package/src/cmd/cloud/secret/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: 'secret',
 	description: 'Manage secrets for your project',
 	tags: ['fast', 'requires-auth', 'requires-project'],
+	examples: [
+		{ command: getCommand('cloud secret list'), description: 'List all secrets' },
+		{
+			command: getCommand('cloud secret set API_KEY "sk_..."'),
+			description: 'Set a secret value',
+		},
+	],
 	subcommands: [
 		listSubcommand,
 		pullSubcommand,