@agentuity/cli 0.0.60 → 0.0.61

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

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

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

@@ -17,8 +17,14 @@ export const setSubcommand = createSubcommand({
 	tags: ['mutating', 'updates-resource', 'slow', 'requires-auth', 'requires-project'],
 	idempotent: true,
 	examples: [
-		getCommand('secret set DATABASE_URL "postgres://user:pass@host:5432/db"'),
-		getCommand('secret set STRIPE_SECRET_KEY "sk_live_..."'),
+		{
+			command: getCommand('secret set DATABASE_URL "postgres://user:pass@host:5432/db"'),
+			description: 'Run "postgres://user:pass@host:5432/db" command',
+		},
+		{
+			command: getCommand('secret set STRIPE_SECRET_KEY "sk_live_..."'),
+			description: 'Run "sk_live_..." command',
+		},
 	],
 	requires: { auth: true, project: true, apiClient: true },
 	schema: {

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

@@ -104,7 +104,7 @@ export const getSubcommand = createSubcommand({
 	name: 'get',
 	description: 'Get details about a specific session',
 	tags: ['read-only', 'fast', 'requires-auth'],
-	examples: [`${getCommand('cloud session get')} sess_abc123xyz`],
+	examples: [{ command: getCommand('cloud session get'), description: 'sess_abc123xyz' }],
 	requires: { auth: true },
 	idempotent: true,
 	schema: {

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

@@ -2,10 +2,15 @@ import { createCommand } from '../../../types';
 import { getSubcommand } from './get';
 import { listSubcommand } from './list';
 import { logsSubcommand } from './logs';
+import { getCommand } from '../../../command-prefix';
 
 export const sessionCommand = createCommand({
 	name: 'session',
 	description: 'Manage sessions',
 	tags: ['requires-auth'],
+	examples: [
+		{ command: getCommand('cloud session list'), description: 'List all sessions' },
+		{ command: getCommand('cloud session logs <id>'), description: 'View session logs' },
+	],
 	subcommands: [getSubcommand, listSubcommand, logsSubcommand],
 });

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

@@ -24,14 +24,35 @@ export const listSubcommand = createSubcommand({
 	description: 'List recent sessions',
 	tags: ['read-only', 'fast', 'requires-auth'],
 	examples: [
-		`${getCommand('cloud session list')}                      # List 10 most recent sessions`,
-		`${getCommand('cloud session list')} --count=25           # List 25 most recent sessions`,
-		`${getCommand('cloud session list')} --project-id=proj_* # Filter by project`,
-		`${getCommand('cloud session list')} --deployment-id=*   # Filter by deployment`,
-		`${getCommand('cloud session list')} --success=true      # Only successful sessions`,
-		`${getCommand('cloud session list')} --devmode=false     # Only production sessions`,
-		`${getCommand('cloud session list')} --trigger=api       # Only API triggered sessions`,
-		`${getCommand('cloud session list')} --env=production    # Only production environment`,
+		{ command: getCommand('cloud session list'), description: 'List 10 most recent sessions' },
+		{
+			command: getCommand('cloud session list --count=25'),
+			description: 'List 25 most recent sessions',
+		},
+		{
+			command: getCommand('cloud session list --project-id=proj_*'),
+			description: 'Filter by project',
+		},
+		{
+			command: getCommand('cloud session list --deployment-id=*'),
+			description: 'Filter by deployment',
+		},
+		{
+			command: getCommand('cloud session list --success=true'),
+			description: 'Only successful sessions',
+		},
+		{
+			command: getCommand('cloud session list --devmode=false'),
+			description: 'Only production sessions',
+		},
+		{
+			command: getCommand('cloud session list --trigger=api'),
+			description: 'Only API triggered sessions',
+		},
+		{
+			command: getCommand('cloud session list --env=production'),
+			description: 'Only production environment',
+		},
 	],
 	aliases: ['ls'],
 	requires: { auth: true },

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

@@ -19,8 +19,14 @@ export const logsSubcommand = createSubcommand({
 	description: 'Get logs for a specific session',
 	tags: ['read-only', 'slow', 'requires-auth'],
 	examples: [
-		`${getCommand('cloud session logs')} sess_abc123xyz`,
-		`${getCommand('cloud session logs')} --no-timestamps  # hide timestamps`,
+		{
+			command: getCommand('cloud session logs sess_abc123xyz'),
+			description: 'View logs for session',
+		},
+		{
+			command: getCommand('cloud session logs sess_abc123xyz --no-timestamps'),
+			description: 'Hide timestamps',
+		},
 	],
 	requires: { auth: true, apiClient: true },
 	optional: { project: true },

package/src/cmd/cloud/ssh.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({
 	identifier: z.string().optional().describe('The project or deployment id to use'),
 	command: z.string().optional().describe('The command to run'),
@@ -19,12 +18,21 @@ export const sshSubcommand = createSubcommand({
 	tags: ['read-only', 'slow', 'requires-auth', 'requires-deployment'],
 	idempotent: true,
 	examples: [
-		`${getCommand('cloud ssh')}                          # SSH into current project`,
-		`${getCommand('cloud ssh')} proj_abc123xyz           # SSH into specific project`,
-		`${getCommand('cloud ssh')} deploy_abc123xyz         # SSH into specific deployment`,
-		`${getCommand('cloud ssh')} 'ps aux'                 # Run command and exit`,
-		`${getCommand('cloud ssh')} proj_abc123xyz 'tail -f /var/log/app.log'`,
-		`${getCommand('cloud ssh')} --show                   # Show SSH command without executing`,
+		{ command: getCommand('cloud ssh'), description: 'SSH into current project' },
+		{ command: getCommand('cloud ssh proj_abc123xyz'), description: 'SSH into specific project' },
+		{
+			command: getCommand('cloud ssh deploy_abc123xyz'),
+			description: 'SSH into specific deployment',
+		},
+		{ command: getCommand("cloud ssh 'ps aux'"), description: 'Run command and exit' },
+		{
+			command: getCommand("cloud ssh proj_abc123xyz 'tail -f /var/log/app.log'"),
+			description: 'Run command on specific project',
+		},
+		{
+			command: getCommand('cloud ssh --show'),
+			description: 'Show SSH command without executing',
+		},
 	],
 	toplevel: true,
 	requires: { auth: true, apiClient: true },

package/src/cmd/cloud/storage/create.ts

@@ -14,9 +14,9 @@ export const createSubcommand = defineSubcommand({
 	idempotent: false,
 	requires: { auth: true, org: true, region: true },
 	examples: [
-		getCommand('cloud storage create'),
-		getCommand('cloud storage new'),
-		getCommand('--dry-run cloud storage create'),
+		{ command: getCommand('cloud storage create'), description: 'Create new item' },
+		{ command: getCommand('cloud storage new'), description: 'Run new command' },
+		{ command: getCommand('--dry-run cloud storage create'), description: 'Create new item' },
 	],
 	schema: {
 		response: z.object({

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

@@ -17,10 +17,13 @@ export const deleteSubcommand = createSubcommand({
 	idempotent: false,
 	requires: { auth: true, org: true, region: true },
 	examples: [
-		getCommand('cloud storage delete my-bucket'),
-		getCommand('cloud storage rm my-bucket file.txt'),
-		getCommand('cloud storage delete'),
-		getCommand('--dry-run cloud storage delete my-bucket'),
+		{ command: getCommand('cloud storage delete my-bucket'), description: 'Delete item' },
+		{ command: getCommand('cloud storage rm my-bucket file.txt'), description: 'Delete item' },
+		{ command: getCommand('cloud storage delete'), description: 'Delete item' },
+		{
+			command: getCommand('--dry-run cloud storage delete my-bucket'),
+			description: 'Delete item',
+		},
 	],
 	schema: {
 		args: z.object({

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

@@ -14,10 +14,22 @@ export const downloadSubcommand = createSubcommand({
 	requires: { auth: true, org: true, region: true },
 	idempotent: true,
 	examples: [
-		`${getCommand('cloud storage download')} my-bucket file.txt`,
-		`${getCommand('cloud storage download')} my-bucket file.txt output.txt`,
-		`${getCommand('cloud storage download')} my-bucket file.txt - > output.txt`,
-		`${getCommand('cloud storage download')} my-bucket file.txt --metadata`,
+		{
+			command: `${getCommand('cloud storage download')} my-bucket file.txt`,
+			description: 'Download file from bucket',
+		},
+		{
+			command: `${getCommand('cloud storage download')} my-bucket file.txt output.txt`,
+			description: 'Download file to specific path',
+		},
+		{
+			command: `${getCommand('cloud storage download')} my-bucket file.txt - > output.txt`,
+			description: 'Download file to stdout',
+		},
+		{
+			command: `${getCommand('cloud storage download')} my-bucket file.txt --metadata`,
+			description: 'Download metadata only',
+		},
 	],
 	schema: {
 		args: z.object({

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

@@ -22,9 +22,18 @@ export const getSubcommand = createSubcommand({
 	requires: { auth: true, org: true, region: true },
 	idempotent: true,
 	examples: [
-		`${getCommand('cloud storage get')} my-bucket`,
-		`${getCommand('cloud storage show')} my-bucket`,
-		`${getCommand('cloud storage get')} my-bucket --show-credentials`,
+		{
+			command: `${getCommand('cloud storage get')} my-bucket`,
+			description: 'Get bucket details',
+		},
+		{
+			command: `${getCommand('cloud storage show')} my-bucket`,
+			description: 'Show bucket information',
+		},
+		{
+			command: `${getCommand('cloud storage get')} my-bucket --show-credentials`,
+			description: 'Get bucket with credentials',
+		},
 	],
 	schema: {
 		args: z.object({

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

@@ -5,12 +5,20 @@ import { deleteSubcommand } from './delete';
 import { getSubcommand } from './get';
 import { uploadSubcommand } from './upload';
 import { downloadSubcommand } from './download';
+import { getCommand } from '../../../command-prefix';
 
 export const storageCommand = createCommand({
 	name: 'storage',
 	aliases: ['s3'],
 	description: 'Manage storage resources',
 	tags: ['slow', 'requires-auth', 'requires-deployment'],
+	examples: [
+		{ command: getCommand('cloud storage list'), description: 'List all storage resources' },
+		{
+			command: getCommand('cloud storage upload ./file.txt'),
+			description: 'Upload file to storage',
+		},
+	],
 	subcommands: [
 		createSubcommand,
 		listSubcommand,

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

@@ -40,12 +40,21 @@ export const listSubcommand = createSubcommand({
 	requires: { auth: true, org: true, region: true },
 	idempotent: true,
 	examples: [
-		getCommand('cloud storage list'),
-		getCommand('cloud storage list my-bucket'),
-		getCommand('cloud storage list my-bucket path/prefix'),
-		getCommand('--json cloud storage list'),
-		getCommand('cloud storage ls'),
-		getCommand('cloud storage list --show-credentials'),
+		{ command: getCommand('cloud storage list'), description: 'List items' },
+		{ command: getCommand('cloud storage list my-bucket'), description: 'List items' },
+		{
+			command: getCommand('cloud storage list my-bucket path/prefix'),
+			description: 'List items',
+		},
+		{
+			command: getCommand('--json cloud storage list'),
+			description: 'Show output in JSON format',
+		},
+		{ command: getCommand('cloud storage ls'), description: 'List items' },
+		{
+			command: getCommand('cloud storage list --show-credentials'),
+			description: 'Use show credentials option',
+		},
 	],
 	schema: {
 		args: z.object({
@@ -59,6 +68,7 @@ export const listSubcommand = createSubcommand({
 				.describe(
 					'Show credentials in plain text (default: masked in terminal, unmasked in JSON)'
 				),
+			nameOnly: z.boolean().optional().describe('Print the name only'),
 		}),
 		response: StorageListResponseSchema,
 	},
@@ -118,14 +128,22 @@ export const listSubcommand = createSubcommand({
 				if (objects.length === 0) {
 					tui.info('No files found');
 				} else {
-					tui.info(
-						tui.bold(`Files in ${args.name}${args.prefix ? ` (prefix: ${args.prefix})` : ''}`)
-					);
-					tui.newline();
-					for (const obj of objects) {
-						console.log(
-							`${obj.key}  ${tui.muted(`(${obj.size} bytes, ${obj.lastModified})`)}`
+					if (opts.nameOnly) {
+						for (const obj of objects) {
+							console.log(obj.key);
+						}
+					} else {
+						tui.info(
+							tui.bold(
+								`Files in ${args.name}${args.prefix ? ` (prefix: ${args.prefix})` : ''}`
+							)
 						);
+						tui.newline();
+						for (const obj of objects) {
+							console.log(
+								`${obj.key}  ${tui.muted(`(${obj.size} bytes, ${obj.lastModified})`)}`
+							);
+						}
 					}
 				}
 			}
@@ -161,9 +179,15 @@ export const listSubcommand = createSubcommand({
 			if (resources.s3.length === 0) {
 				tui.info('No storage buckets found');
 			} else {
-				tui.info(tui.bold('Storage'));
-				tui.newline();
+				if (!opts.nameOnly) {
+					tui.info(tui.bold('Storage'));
+					tui.newline();
+				}
 				for (const s3 of resources.s3) {
+					if (opts.nameOnly) {
+						console.log(s3.bucket_name);
+						continue;
+					}
 					console.log(tui.bold(s3.bucket_name));
 					if (s3.access_key) {
 						const displayAccessKey = shouldMask

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

@@ -16,9 +16,18 @@ export const uploadSubcommand = createSubcommand({
 	requires: { auth: true, org: true, region: true },
 	idempotent: false,
 	examples: [
-		`${getCommand('cloud storage upload')} my-bucket file.txt`,
-		`${getCommand('cloud storage put')} my-bucket file.txt --content-type text/plain`,
-		`cat file.txt | ${getCommand('cloud storage upload')} my-bucket -`,
+		{
+			command: `${getCommand('cloud storage upload')} my-bucket file.txt`,
+			description: 'Upload file to bucket',
+		},
+		{
+			command: `${getCommand('cloud storage put')} my-bucket file.txt --content-type text/plain`,
+			description: 'Upload file with content type',
+		},
+		{
+			command: `cat file.txt | ${getCommand('cloud storage upload')} my-bucket -`,
+			description: 'Upload from stdin',
+		},
 	],
 	schema: {
 		args: z.object({
@@ -66,18 +75,24 @@ export const uploadSubcommand = createSubcommand({
 			);
 		}
 
+		// TODO: we need to optimize this to not load the entire file in memory!
+
 		// Read file content
 		let fileContent: Buffer;
 		let actualFilename: string;
 
 		if (args.filename === '-') {
-			// Read from STDIN
-			const chunks: Buffer[] = [];
-			for await (const chunk of Bun.stdin.stream()) {
-				chunks.push(Buffer.from(chunk));
+			// Read from STDIN (binary-safe)
+			try {
+				const arrayBuffer = await Bun.readableStreamToArrayBuffer(Bun.stdin.stream());
+				fileContent = Buffer.from(arrayBuffer);
+				actualFilename = 'stdin';
+			} catch (error) {
+				tui.fatal(
+					`Cannot read from stdin: ${error instanceof Error ? error.message : String(error)}`,
+					ErrorCode.FILE_NOT_FOUND
+				);
 			}
-			fileContent = Buffer.concat(chunks);
-			actualFilename = 'stdin';
 		} else {
 			// Read from file
 			const file = Bun.file(args.filename);

package/src/cmd/cloud/stream/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 DeleteStreamResponseSchema = z.object({
 	id: z.string().describe('Stream ID'),
 });
@@ -16,9 +15,15 @@ export const deleteSubcommand = createCommand({
 	idempotent: true,
 	requires: { auth: true, project: true },
 	examples: [
-		`${getCommand('stream delete stream-id-123')} - Delete a stream`,
-		`${getCommand('stream rm stream-id-456')} - Delete stream (using alias)`,
-		`${getCommand('stream del stream-id-789')} - Delete stream (using alias)`,
+		{ command: getCommand('stream delete stream-id-123'), description: 'Delete a stream' },
+		{
+			command: getCommand('stream rm stream-id-456'),
+			description: 'Delete stream (using alias)',
+		},
+		{
+			command: getCommand('stream del stream-id-789'),
+			description: 'Delete stream (using alias)',
+		},
 	],
 	schema: {
 		args: z.object({

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

@@ -3,7 +3,6 @@ import { createCommand } from '../../../types';
 import * as tui from '../../../tui';
 import { createStorageAdapter } from './util';
 import { getCommand } from '../../../command-prefix';
-
 function formatBytes(bytes: number): string {
 	if (bytes === 0) return '0 B';
 	if (bytes < 1024) return `${bytes} B`;
@@ -27,10 +26,16 @@ export const getSubcommand = createCommand({
 	requires: { auth: true, project: true },
 	idempotent: true,
 	examples: [
-		`${getCommand('stream get stream-id-123')} - Get stream details`,
-		`${getCommand('stream get stream-id-123 --json')} - Get stream as JSON`,
-		`${getCommand('stream get stream-id-123 --output stream.dat')} - Download stream to file`,
-		`${getCommand('stream get stream-id-123 -o stream.dat')} - Download stream (short flag)`,
+		{ command: getCommand('stream get stream-id-123'), description: 'Get stream details' },
+		{ command: getCommand('stream get stream-id-123 --json'), description: 'Get stream as JSON' },
+		{
+			command: getCommand('stream get stream-id-123 --output stream.dat'),
+			description: 'Download stream to file',
+		},
+		{
+			command: getCommand('stream get stream-id-123 -o stream.dat'),
+			description: 'Download stream (short flag)',
+		},
 	],
 	schema: {
 		args: z.object({

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

@@ -2,12 +2,17 @@ import { createCommand } from '../../../types';
 import listSubcommand from './list';
 import getSubcommand from './get';
 import deleteSubcommand from './delete';
+import { getCommand } from '../../../command-prefix';
 
 export const streamCommand = createCommand({
 	name: 'stream',
 	aliases: ['streams'],
 	description: 'Manage streams',
 	tags: ['slow', 'requires-auth'],
+	examples: [
+		{ command: getCommand('cloud stream list'), description: 'List all streams' },
+		{ command: getCommand('cloud stream get <id>'), description: 'Get stream details' },
+	],
 	subcommands: [listSubcommand, getSubcommand, deleteSubcommand],
 });
 

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

@@ -3,7 +3,6 @@ import { createCommand } from '../../../types';
 import * as tui from '../../../tui';
 import { createStorageAdapter } from './util';
 import { getCommand } from '../../../command-prefix';
-
 function formatBytes(bytes: number): string {
 	if (bytes === 0) return '0 B';
 	if (bytes < 1024) return `${bytes} B`;
@@ -33,11 +32,14 @@ export const listSubcommand = createCommand({
 	requires: { auth: true, project: true },
 	idempotent: true,
 	examples: [
-		`${getCommand('stream list')} - List all streams`,
-		`${getCommand('stream ls --size 50')} - List 50 most recent streams`,
-		`${getCommand('stream list --name agent-logs')} - Filter by name`,
-		`${getCommand('stream list --metadata type=export')} - Filter by metadata`,
-		`${getCommand('stream ls --json')} - Output as JSON`,
+		{ command: getCommand('stream list'), description: 'List all streams' },
+		{ command: getCommand('stream ls --size 50'), description: 'List 50 most recent streams' },
+		{ command: getCommand('stream list --name agent-logs'), description: 'Filter by name' },
+		{
+			command: getCommand('stream list --metadata type=export'),
+			description: 'Filter by metadata',
+		},
+		{ command: getCommand('stream ls --json'), description: 'Output as JSON' },
 	],
 	schema: {
 		options: z.object({

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

@@ -4,7 +4,6 @@ import { ErrorCode } from '../../../errors';
 import * as tui from '../../../tui';
 import { createStorageAdapter } from './util';
 import { getCommand } from '../../../command-prefix';
-
 const VectorDeleteResponseSchema = z.object({
 	success: z.boolean().describe('Whether the operation succeeded'),
 	namespace: z.string().describe('Namespace name'),
@@ -22,9 +21,18 @@ export const deleteSubcommand = createCommand({
 	requires: { auth: true, project: true },
 	idempotent: true,
 	examples: [
-		`${getCommand('vector delete products chair-001')} - Delete a single vector (interactive)`,
-		`${getCommand('vector rm knowledge-base doc-123 doc-456 --confirm')} - Delete multiple vectors without confirmation`,
-		`${getCommand('vector del embeddings old-profile-1 old-profile-2 --confirm')} - Bulk delete without confirmation`,
+		{
+			command: getCommand('vector delete products chair-001'),
+			description: 'Delete a single vector (interactive)',
+		},
+		{
+			command: getCommand('vector rm knowledge-base doc-123 doc-456 --confirm'),
+			description: 'Delete multiple vectors without confirmation',
+		},
+		{
+			command: getCommand('vector del embeddings old-profile-1 old-profile-2 --confirm'),
+			description: 'Bulk delete without confirmation',
+		},
 	],
 	schema: {
 		args: z.object({
@@ -51,8 +59,11 @@ export const deleteSubcommand = createCommand({
 					ErrorCode.VALIDATION_FAILED
 				);
 			}
-			const keyList = args.keys.length > 3 ? `${args.keys.slice(0, 3).join(', ')}...` : args.keys.join(', ');
-			tui.warning(`This will delete ${args.keys.length} vector(s) from ${tui.bold(args.namespace)}: ${keyList}`);
+			const keyList =
+				args.keys.length > 3 ? `${args.keys.slice(0, 3).join(', ')}...` : args.keys.join(', ');
+			tui.warning(
+				`This will delete ${args.keys.length} vector(s) from ${tui.bold(args.namespace)}: ${keyList}`
+			);
 			const confirm = await new Promise<boolean>((resolve) => {
 				process.stdout.write('Are you sure? (yes/no): ');
 				process.stdin.once('data', (data) => {

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

@@ -3,7 +3,6 @@ import { createCommand } from '../../../types';
 import * as tui from '../../../tui';
 import { createStorageAdapter } from './util';
 import { getCommand } from '../../../command-prefix';
-
 const VectorGetResponseSchema = z.object({
 	exists: z.boolean().describe('Whether the vector exists'),
 	key: z.string().optional().describe('Vector key'),
@@ -20,9 +19,18 @@ export const getSubcommand = createCommand({
 	requires: { auth: true, project: true },
 	idempotent: true,
 	examples: [
-		`${getCommand('vector get products chair-001')} - Get a specific product vector`,
-		`${getCommand('vector get knowledge-base doc-123')} - Get a document from knowledge base`,
-		`${getCommand('vector get embeddings user-profile-456')} - Get user profile embedding`,
+		{
+			command: getCommand('vector get products chair-001'),
+			description: 'Get a specific product vector',
+		},
+		{
+			command: getCommand('vector get knowledge-base doc-123'),
+			description: 'Get a document from knowledge base',
+		},
+		{
+			command: getCommand('vector get embeddings user-profile-456'),
+			description: 'Get user profile embedding',
+		},
 	],
 	schema: {
 		args: z.object({

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

@@ -2,12 +2,20 @@ import { createCommand } from '../../../types';
 import { deleteSubcommand } from './delete';
 import { getSubcommand } from './get';
 import { searchSubcommand } from './search';
+import { getCommand } from '../../../command-prefix';
 
 export const vectorCommand = createCommand({
 	name: 'vector',
 	aliases: ['vec'],
 	description: 'Manage vector storage for your projects',
 	tags: ['requires-auth', 'destructive', 'deletes-resource', 'slow'],
+	examples: [
+		{
+			command: getCommand('cloud vector search "query text"'),
+			description: 'Search vector storage',
+		},
+		{ command: getCommand('cloud vec get <id>'), description: 'Get vector by ID' },
+	],
 	subcommands: [searchSubcommand, getSubcommand, deleteSubcommand],
 	requires: { auth: true, project: true },
 });

package/src/cmd/cloud/vector/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 VectorSearchResultSchema = z.object({
 	id: z.string().describe('Vector ID'),
 	key: z.string().describe('Vector key'),
@@ -26,11 +25,26 @@ export const searchSubcommand = createCommand({
 	requires: { auth: true, project: true },
 	idempotent: true,
 	examples: [
-		`${getCommand('vector search products "comfortable office chair"')} - Search for similar products`,
-		`${getCommand('vector list knowledge-base "machine learning"')} - Search knowledge base`,
-		`${getCommand('vector search docs "API documentation" --limit 5')} - Limit results`,
-		`${getCommand('vector search products "ergonomic" --similarity 0.8')} - Set minimum similarity`,
-		`${getCommand('vector ls embeddings "neural networks" --metadata category=ai')} - Filter by metadata`,
+		{
+			command: getCommand('vector search products "comfortable office chair"'),
+			description: 'Search for similar products',
+		},
+		{
+			command: getCommand('vector list knowledge-base "machine learning"'),
+			description: 'Search knowledge base',
+		},
+		{
+			command: getCommand('vector search docs "API documentation" --limit 5'),
+			description: 'Limit results',
+		},
+		{
+			command: getCommand('vector search products "ergonomic" --similarity 0.8'),
+			description: 'Set minimum similarity',
+		},
+		{
+			command: getCommand('vector ls embeddings "neural networks" --metadata category=ai'),
+			description: 'Filter by metadata',
+		},
 	],
 	schema: {
 		args: z.object({