@agentuity/cli 0.0.11 → 0.0.12

package/bin/cli.ts

@@ -8,7 +8,27 @@ import { detectColorScheme } from '../src/terminal';
 import { setColorScheme } from '../src/tui';
 import { getVersion } from '../src/version';
 import { checkLegacyCLI } from '../src/legacy-check';
-import type { LogLevel } from '../src/types';
+import type { CommandContext, LogLevel } from '../src/types';
+
+// Cleanup TTY state before exit
+function cleanupAndExit() {
+	if (process.stdin.isTTY) {
+		process.stdin.setRawMode(false);
+		process.stdout.write('\x1B[?25h'); // Restore cursor
+	}
+	process.exitCode = 0;
+	process.exit(0);
+}
+
+// Handle Ctrl+C gracefully
+process.once('SIGINT', () => {
+	console.log('\n');
+	cleanupAndExit();
+});
+
+process.once('SIGTERM', () => {
+	cleanupAndExit();
+});
 
 validateRuntime();
 
@@ -61,11 +81,32 @@ const ctx = {
 };
 
 const commands = await discoverCommands();
-await registerCommands(program, commands, ctx);
+await registerCommands(program, commands, ctx as unknown as CommandContext);
 
 try {
 	await program.parseAsync(process.argv);
 } catch (error) {
+	// Don't log error if it's from Ctrl+C, user cancellation, or signal termination
+	if (error instanceof Error) {
+		const msg = error.message.toLowerCase();
+		if (
+			msg.includes('sigint') ||
+			msg.includes('sigterm') ||
+			msg.includes('user force closed') ||
+			msg.includes('cancelled') || // UK
+			msg.includes('canceled') || // US
+			msg === ''
+		) {
+			process.exit(0);
+		}
+		if ('name' in error && error.name === 'AbortError') {
+			process.exit(0);
+		}
+	}
+	// Also exit cleanly if error is empty/undefined (user cancellation)
+	if (!error) {
+		process.exit(0);
+	}
 	logger.error('CLI error:', error);
 	process.exit(1);
 }

package/dist/cmd/dev/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cmd/dev/index.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,OAAO,qCA2ElB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cmd/dev/index.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,OAAO,qCAyElB,CAAC"}

package/dist/cmd/project/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/cmd/project/create.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,uBAAuB,wCA8ClC,CAAC"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/cmd/project/create.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,uBAAuB,wCA+ClC,CAAC"}

package/dist/cmd/project/download.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../../src/cmd/project/download.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,UAAU,eAAe;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,YAAY;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA6E9E;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA8CvE"}
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../../src/cmd/project/download.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,UAAU,eAAe;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,YAAY;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CACf;AAsBD,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAuD9E;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAgCvE"}

package/dist/cmd/project/template-flow.d.ts

@@ -1,6 +1,7 @@
 import type { Logger } from '@/logger';
 interface CreateFlowOptions {
     projectName?: string;
+    dir?: string;
     template?: string;
     templateDir?: string;
     templateBranch?: string;

package/dist/cmd/project/template-flow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template-flow.d.ts","sourceRoot":"","sources":["../../../src/cmd/project/template-flow.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAKvC,UAAU,iBAAiB;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+I7E"}
+{"version":3,"file":"template-flow.d.ts","sourceRoot":"","sources":["../../../src/cmd/project/template-flow.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAMvC,UAAU,iBAAiB;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0J7E"}

package/dist/sound.d.ts

@@ -1,2 +1,2 @@
-export declare function playSound(): Promise<void>;
+export declare function playSound(): void;
 //# sourceMappingURL=sound.d.ts.map

package/dist/sound.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sound.d.ts","sourceRoot":"","sources":["../src/sound.ts"],"names":[],"mappings":"AAEA,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAsB/C"}
+{"version":3,"file":"sound.d.ts","sourceRoot":"","sources":["../src/sound.ts"],"names":[],"mappings":"AAEA,wBAAgB,SAAS,IAAI,IAAI,CAoChC"}

package/dist/tui.d.ts

@@ -17,7 +17,7 @@ export declare function error(message: string): void;
 /**
  * Print a warning message with a yellow warning icon
  */
-export declare function warning(message: string): void;
+export declare function warning(message: string, asError?: boolean): void;
 /**
  * Print an info message with a cyan info icon
  */

package/dist/tui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../src/tui.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../src/tui.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@agentuity/cli",
-	"version": "0.0.11",
+	"version": "0.0.12",
 	"type": "module",
 	"main": "./src/index.ts",
 	"types": "./dist/index.d.ts",

package/src/cmd/dev/index.ts

@@ -35,9 +35,7 @@ export const command = createCommand({
 				process.exit(1);
 			}
 
-			tui.newline();
 			tui.info('Starting development server...');
-			tui.newline();
 
 			// Use shell to run in a process group for proper cleanup
 			// The 'exec' ensures the shell is replaced by the actual process

package/src/cmd/example/sound.ts

@@ -6,9 +6,9 @@ export const soundSubcommand: SubcommandDefinition = {
 	name: 'sound',
 	description: 'Test completion sound',
 
-	async handler() {
+	handler() {
 		tui.info('Playing completion sound...');
-		await playSound();
+		playSound();
 		tui.success('Sound played!');
 	},
 };

package/src/cmd/project/create.ts

@@ -39,6 +39,7 @@ export const createProjectSubcommand = createSubcommand({
 		const { logger, opts } = ctx;
 		await runCreateFlow({
 			projectName: opts.name,
+			dir: opts.dir,
 			template: opts.template,
 			templateDir: opts.templateDir,
 			templateBranch: opts.templateBranch,

package/src/cmd/project/download.ts

@@ -1,8 +1,9 @@
-import { join } from 'node:path';
+import { join, resolve } from 'node:path';
 import { existsSync, mkdirSync, renameSync, readdirSync, cpSync, rmSync } from 'node:fs';
+import { homedir } from 'node:os';
 import { pipeline } from 'node:stream/promises';
 import { createGunzip } from 'node:zlib';
-import { extract } from 'tar-fs';
+import { extract, type Headers } from 'tar-fs';
 import type { Logger } from '@/logger';
 import * as tui from '@/tui';
 import { downloadWithSpinner } from '@/download';
@@ -27,22 +28,12 @@ interface SetupOptions {
 	logger: Logger;
 }
 
-export async function downloadTemplate(options: DownloadOptions): Promise<void> {
-	const { dest, template, templateDir, templateBranch } = options;
-
-	mkdirSync(dest, { recursive: true });
-
-	// Copy from local directory if provided
-	if (templateDir) {
-		const { resolve } = await import('node:path');
-		const sourceDir = resolve(join(templateDir, template.directory));
-
-		if (!existsSync(sourceDir)) {
-			throw new Error(`Template directory not found: ${sourceDir}`);
-		}
-
-		tui.info(`📦 Copying template from ${sourceDir}...`);
+async function cleanup(sourceDir: string, dest: string) {
+	if (!existsSync(sourceDir)) {
+		throw new Error(`Template directory not found: ${sourceDir}`);
+	}
 
+	tui.spinner(`📦 Copying template from ${sourceDir}...`, async () => {
 		// Copy all files from source to dest
 		const files = readdirSync(sourceDir);
 		for (const file of files) {
@@ -54,8 +45,23 @@ export async function downloadTemplate(options: DownloadOptions): Promise<void>
 		if (existsSync(gi)) {
 			renameSync(gi, join(dest, '.gitignore'));
 		}
+	});
+}
+
+export async function downloadTemplate(options: DownloadOptions): Promise<void> {
+	const { dest, template, templateDir, templateBranch } = options;
 
-		return;
+	mkdirSync(dest, { recursive: true });
+
+	// Copy from local directory if provided
+	if (templateDir) {
+		const sourceDir = resolve(join(templateDir, template.directory));
+
+		if (!existsSync(sourceDir)) {
+			throw new Error(`Template directory not found: ${sourceDir}`);
+		}
+
+		return cleanup(sourceDir, dest);
 	}
 
 	// Download from GitHub
@@ -74,65 +80,43 @@ export async function downloadTemplate(options: DownloadOptions): Promise<void>
 		},
 		async (stream) => {
 			// Extract only the template directory from tarball
+			const prefix = `sdk-${branch}/${templatePath}/`;
 			await pipeline(
 				stream,
 				createGunzip(),
 				extract(tempDir, {
-					map: (header) => {
-						const prefix = `sdk-${branch}/${templatePath}/`;
-						if (header.name.startsWith(prefix)) {
-							header.name = header.name.substring(prefix.length);
-							return header;
-						}
-						// eslint-disable-next-line @typescript-eslint/no-explicit-any
-						return null as any;
+					filter: (name: string) => name.startsWith(prefix),
+					map: (header: Headers) => {
+						header.name = header.name.substring(prefix.length);
+						return header;
 					},
 				})
 			);
 		}
 	);
 
-	// Move files from temp to dest
-	const files = readdirSync(tempDir);
-	for (const file of files) {
-		cpSync(join(tempDir, file), join(dest, file), { recursive: true });
-	}
-	rmSync(tempDir, { recursive: true, force: true });
+	await cleanup(tempDir, dest);
 
-	// Rename gitignore -> .gitignore
-	const gi = join(dest, 'gitignore');
-	if (existsSync(gi)) {
-		renameSync(gi, join(dest, '.gitignore'));
+	// Extra safety: refuse to delete root or home directories
+	const home = homedir();
+	if (tempDir === '/' || tempDir === home) {
+		throw new Error(`Refusing to delete protected path: ${tempDir}`);
 	}
+	rmSync(tempDir, { recursive: true, force: true });
 }
 
 export async function setupProject(options: SetupOptions): Promise<void> {
 	const { dest, projectName, dirName, noInstall, noBuild, logger } = options;
 
-	process.chdir(dest);
-
 	// Replace {{PROJECT_NAME}} in files
 	tui.info(`🔧 Setting up ${projectName}...`);
 	await replaceInFiles(dest, projectName, dirName);
 
-	// Run setup.ts if it exists (legacy)
-	if (await Bun.file('./setup.ts').exists()) {
-		await tui.spinner({
-			message: 'Running setup script...',
-			callback: async () => {
-				const proc = Bun.spawn(['bun', './setup.ts'], { stdio: ['pipe', 'pipe', 'pipe'] });
-				const exitCode = await proc.exited;
-				if (exitCode !== 0) {
-					logger.error('Setup script failed');
-				}
-			},
-		});
-	}
-
 	// Install dependencies
 	if (!noInstall) {
 		const exitCode = await tui.runCommand({
 			command: 'bun install',
+			cwd: dest,
 			cmd: ['bun', 'install'],
 			clearOnSuccess: true,
 		});
@@ -145,6 +129,7 @@ export async function setupProject(options: SetupOptions): Promise<void> {
 	if (!noBuild) {
 		const exitCode = await tui.runCommand({
 			command: 'bun run build',
+			cwd: dest,
 			cmd: ['bun', 'run', 'build'],
 			clearOnSuccess: true,
 		});

package/src/cmd/project/template-flow.ts

@@ -1,13 +1,17 @@
 import { basename, resolve } from 'node:path';
 import { existsSync, readdirSync, rmSync } from 'node:fs';
+import { cwd } from 'node:process';
+import { homedir } from 'node:os';
 import enquirer from 'enquirer';
 import type { Logger } from '@/logger';
 import * as tui from '@/tui';
+import { playSound } from '@/sound';
 import { fetchTemplates, type TemplateInfo } from './templates';
 import { downloadTemplate, setupProject } from './download';
 
 interface CreateFlowOptions {
 	projectName?: string;
+	dir?: string;
 	template?: string;
 	templateDir?: string;
 	templateBranch?: string;
@@ -20,6 +24,7 @@ interface CreateFlowOptions {
 export async function runCreateFlow(options: CreateFlowOptions): Promise<void> {
 	const {
 		projectName: initialProjectName,
+		dir: targetDir,
 		template: initialTemplate,
 		templateDir,
 		templateBranch,
@@ -64,14 +69,20 @@ export async function runCreateFlow(options: CreateFlowOptions): Promise<void> {
 	const dirName = projectName === '.' ? '.' : sanitizeDirectoryName(projectName);
 
 	// Step 4: Determine destination directory
-	const dest = dirName === '.' ? process.cwd() : resolve(process.cwd(), dirName);
+	// Expand ~ to home directory
+	let expandedTargetDir = targetDir;
+	if (expandedTargetDir && expandedTargetDir.startsWith('~')) {
+		expandedTargetDir = expandedTargetDir.replace(/^~/, homedir());
+	}
+	const baseDir = expandedTargetDir ? resolve(expandedTargetDir) : process.cwd();
+	const dest = dirName === '.' ? baseDir : resolve(baseDir, dirName);
 	const destExists = existsSync(dest);
 	const destEmpty = destExists ? readdirSync(dest).length === 0 : true;
 
 	if (destExists && !destEmpty && dirName !== '.') {
 		// In TTY mode, ask if they want to overwrite
 		if (process.stdin.isTTY && !skipPrompts) {
-			tui.warning(`Directory ${dirName} already exists and is not empty.\n`);
+			tui.warning(`Directory ${dest} already exists and is not empty.`, true);
 			const response = await enquirer.prompt<{ overwrite: boolean }>({
 				type: 'confirm',
 				name: 'overwrite',
@@ -84,19 +95,23 @@ export async function runCreateFlow(options: CreateFlowOptions): Promise<void> {
 				process.exit(0);
 			}
 
-			// Delete the existing directory
+			// Extra safety: refuse to delete root or home directories
+			const home = homedir();
+			if (dest === '/' || dest === home) {
+				logger.fatal(`Refusing to delete protected path: ${dest}`);
+				return;
+			}
 			rmSync(dest, { recursive: true, force: true });
-			tui.success(`Deleted ${dirName}\n`);
+			tui.success(`Deleted ${dest}\n`);
 		} else {
-			logger.fatal(`Directory ${dirName} already exists and is not empty.`);
+			logger.fatal(`Directory ${dest} already exists and is not empty.`, true);
 		}
 	}
 
 	// Show directory and name confirmation
 	if (!skipPrompts) {
-		const displayPath = dirName === '.' ? basename(dest) : dirName;
 		tui.info(`📁 Project: ${tui.bold(projectName)}`);
-		tui.info(`📂 Directory: ${tui.bold(displayPath)}\n`);
+		tui.info(`📂 Directory: ${tui.bold(dest)}\n`);
 	}
 
 	// Step 5: Select template
@@ -152,14 +167,14 @@ export async function runCreateFlow(options: CreateFlowOptions): Promise<void> {
 	tui.success('✨ Project created successfully!\n');
 	tui.info('Next steps:');
 	if (dirName !== '.') {
+		const dirDisplay = cwd() == targetDir ? basename(dirName) : dest;
 		tui.newline();
-		console.log(`  1. ${tui.bold(`cd ${dirName}`)}`);
+		console.log(`  1. ${tui.bold(`cd ${dirDisplay}`)}`);
 		console.log(`  2. ${tui.bold('bun run dev')}`);
 	} else {
-		console.log(`  1. ${tui.bold('bun run dev')}`);
+		console.log(`  ${tui.bold('bun run dev')}`);
 	}
-	tui.newline();
-	console.log(`Your agents will be running at ${tui.link('http://localhost:3000')}`);
+	playSound();
 }
 
 /**

package/src/download.ts

@@ -1,4 +1,4 @@
-import { Transform } from 'node:stream';
+import { Transform, Readable } from 'node:stream';
 import * as tui from './tui';
 
 export interface DownloadOptions {
@@ -48,7 +48,7 @@ export async function downloadWithProgress(
 	});
 
 	// Pipe the response through the progress tracker
-	const responseStream = response.body as unknown as NodeJS.ReadableStream;
+	const responseStream = Readable.fromWeb(response.body as unknown as ReadableStream);
 	responseStream.pipe(progressStream);
 
 	return progressStream;

package/src/sound.ts

@@ -1,25 +1,39 @@
-import { $ } from 'bun';
+import { join } from 'node:path';
 
-export async function playSound(): Promise<void> {
+export function playSound(): void {
 	const platform = process.platform;
 
-	let result;
+	let command: string[];
 	switch (platform) {
-		case 'darwin':
-			result = await $`afplay /System/Library/Sounds/Glass.aiff`.quiet().nothrow();
+		case 'darwin': {
+			const items = [
+				'Blow.aiff',
+				'Bottle.aiff',
+				'Frog.aiff',
+				'Funk.aiff',
+				'Glass.aiff',
+				'Hero.aiff',
+				'Morse.aiff',
+				'Ping.aiff',
+				'Pop.aiff',
+				'Purr.aiff',
+				'Sosumi.aiff',
+			] as const;
+			const file = items[Math.floor(Math.random() * items.length)];
+			command = ['afplay', join('/System/Library/Sounds', file)];
 			break;
+		}
 		case 'linux':
-			result = await $`paplay /usr/share/sounds/freedesktop/stereo/complete.oga`
-				.quiet()
-				.nothrow();
+			command = ['paplay', '/usr/share/sounds/freedesktop/stereo/complete.oga'];
 			break;
 		case 'win32':
-			result = await $`rundll32 user32.dll,MessageBeep 0x00000040`.quiet().nothrow();
+			command = ['rundll32', 'user32.dll,MessageBeep', '0x00000040'];
 			break;
+		default:
+			return;
 	}
 
-	// Fallback to terminal bell if command failed or platform unsupported
-	if (!result || result.exitCode !== 0) {
-		process.stdout.write('\u0007');
-	}
+	Bun.spawn(command, {
+		stdio: ['ignore', 'ignore', 'ignore'],
+	}).unref();
 }

package/src/tui.ts

@@ -85,8 +85,8 @@ export function error(message: string): void {
 /**
  * Print a warning message with a yellow warning icon
  */
-export function warning(message: string): void {
-	const color = getColor('warning');
+export function warning(message: string, asError = false): void {
+	const color = asError ? getColor('error') : getColor('warning');
 	const reset = COLORS.reset;
 	console.log(`${color}${ICONS.warning} ${message}${reset}`);
 }
@@ -805,7 +805,9 @@ export async function runCommand(options: CommandRunnerOptions): Promise<number>
 			process.stdout.write(`\x1b[${linesRendered}A`);
 
 			// Show compact success: ✓ command
-			process.stdout.write(`\r\x1b[K${green}${ICONS.success}${reset} ${cmdColor}${displayCmd}${reset}\n`);
+			process.stdout.write(
+				`\r\x1b[K${green}${ICONS.success}${reset} ${cmdColor}${displayCmd}${reset}\n`
+			);
 		} else {
 			// Determine how many lines to show in final output
 			const finalLinesToShow = exitCode === 0 ? 3 : 10;