@agentuity/cli 0.0.10 → 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":"AAMA,eAAO,MAAM,uBAAuB,wCAgPlC,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

@@ -0,0 +1,20 @@
+import type { Logger } from '@/logger';
+import type { TemplateInfo } from './templates';
+interface DownloadOptions {
+    dest: string;
+    template: TemplateInfo;
+    templateDir?: string;
+    templateBranch?: string;
+}
+interface SetupOptions {
+    dest: string;
+    projectName: string;
+    dirName: string;
+    noInstall: boolean;
+    noBuild: boolean;
+    logger: Logger;
+}
+export declare function downloadTemplate(options: DownloadOptions): Promise<void>;
+export declare function setupProject(options: SetupOptions): Promise<void>;
+export {};
+//# sourceMappingURL=download.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,15 @@
+import type { Logger } from '@/logger';
+interface CreateFlowOptions {
+    projectName?: string;
+    dir?: string;
+    template?: string;
+    templateDir?: string;
+    templateBranch?: string;
+    noInstall: boolean;
+    noBuild: boolean;
+    skipPrompts: boolean;
+    logger: Logger;
+}
+export declare function runCreateFlow(options: CreateFlowOptions): Promise<void>;
+export {};
+//# sourceMappingURL=template-flow.d.ts.map

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

@@ -0,0 +1 @@
+{"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/cmd/project/templates.d.ts

@@ -0,0 +1,8 @@
+export interface TemplateInfo {
+    id: string;
+    name: string;
+    description: string;
+    directory: string;
+}
+export declare function fetchTemplates(localDir?: string, branch?: string): Promise<TemplateInfo[]>;
+//# sourceMappingURL=templates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/cmd/project/templates.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CAClB;AAMD,wBAAsB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAgChG"}

package/dist/download.d.ts

@@ -0,0 +1,25 @@
+export interface DownloadOptions {
+    url: string;
+    headers?: Record<string, string>;
+    message?: string;
+    onProgress?: (percent: number, downloadedBytes: number, totalBytes: number) => void;
+}
+/**
+ * Download a file with progress tracking
+ * Returns the response body stream for further processing
+ */
+export declare function downloadWithProgress(options: DownloadOptions): Promise<NodeJS.ReadableStream>;
+/**
+ * Download a file with a TUI spinner showing progress
+ */
+export declare function downloadWithSpinner<T>(options: DownloadOptions, processor: (stream: NodeJS.ReadableStream) => Promise<T>): Promise<T>;
+/**
+ * Download a GitHub tarball with progress tracking
+ */
+export interface DownloadGitHubOptions {
+    repo: string;
+    branch?: string;
+    message?: string;
+}
+export declare function downloadGitHubTarball(options: DownloadGitHubOptions): Promise<NodeJS.ReadableStream>;
+//# sourceMappingURL=download.d.ts.map

package/dist/download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../src/download.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;CACpF;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACzC,OAAO,EAAE,eAAe,GACtB,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAsChC;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EAC1C,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,GACtD,OAAO,CAAC,CAAC,CAAC,CAoBZ;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,qBAAqB,CAC1C,OAAO,EAAE,qBAAqB,GAC5B,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAKhC"}

package/dist/index.d.ts

@@ -11,6 +11,7 @@ export { getCommandPrefix, getCommand } from './command-prefix';
 export * as tui from './tui';
 export { runSteps, setStepsColorScheme, stepSuccess, stepSkipped, stepError } from './steps';
 export { playSound } from './sound';
+export { downloadWithProgress, downloadWithSpinner, downloadGitHubTarball, type DownloadOptions as DownloadOptionsType, type DownloadGitHubOptions, } from './download';
 export type { Config, LogLevel, GlobalOptions, CommandContext, SubcommandDefinition, CommandDefinition, Profile, AuthData, CommandSchemas, } from './types';
 export { createSubcommand, createCommand } from './types';
 export type { ColorScheme } from './terminal';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAChF,OAAO,EACN,UAAU,EACV,UAAU,EACV,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,WAAW,EACX,UAAU,EACV,aAAa,EACb,QAAQ,EACR,SAAS,EACT,OAAO,GACP,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AACtF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7F,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,YAAY,EACX,MAAM,EACN,QAAQ,EACR,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,OAAO,EACP,QAAQ,EACR,cAAc,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC1D,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAChF,OAAO,EACN,UAAU,EACV,UAAU,EACV,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,WAAW,EACX,UAAU,EACV,aAAa,EACb,QAAQ,EACR,SAAS,EACT,OAAO,GACP,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AACtF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7F,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EACN,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,eAAe,IAAI,mBAAmB,EAC3C,KAAK,qBAAqB,GAC1B,MAAM,YAAY,CAAC;AACpB,YAAY,EACX,MAAM,EACN,QAAQ,EACR,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,OAAO,EACP,QAAQ,EACR,cAAc,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC1D,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC"}

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
  */
@@ -141,6 +141,11 @@ export interface CommandRunnerOptions {
      * Environment variables
      */
     env?: Record<string, string>;
+    /**
+     * If true, clear output on success and only show command + success icon
+     * Defaults to false
+     */
+    clearOnSuccess?: boolean;
 }
 /**
  * Run an external command and stream its output with a live UI

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.10",
+	"version": "0.0.12",
 	"type": "module",
 	"main": "./src/index.ts",
 	"types": "./dist/index.d.ts",
@@ -24,20 +24,20 @@
 		"clean": "rm -rf dist",
 		"build": "bunx tsc --build --emitDeclarationOnly --force",
 		"typecheck": "bunx tsc --noEmit",
-		"test": "bun scripts/test-create-integration.ts",
-		"prepublishOnly": "bun run clean && bun run build",
-		"setup-dev-template": "bun scripts/setup-dev-template.ts",
-		"simulate-create": "bun scripts/simulate-bun-create.ts"
+		"test": "bun scripts/test-create-flow.ts",
+		"prepublishOnly": "bun run clean && bun run build"
 	},
 	"dependencies": {
-		"@agentuity/core": "0.0.9",
+		"@agentuity/core": "0.0.11",
 		"acorn-loose": "^8.5.2",
 		"astring": "^1.9.0",
 		"commander": "^14.0.2",
 		"enquirer": "^2.4.1",
+		"tar-fs": "^3.1.1",
 		"zod": "^4.1.12"
 	},
 	"devDependencies": {
+		"@types/tar-fs": "^2.0.4",
 		"typescript": "^5.9.0"
 	},
 	"publishConfig": {

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

@@ -1,8 +1,6 @@
 import { createSubcommand } from '@/types';
 import { z } from 'zod';
-import enquirer from 'enquirer';
-import { existsSync, readdirSync } from 'node:fs';
-import { resolve, basename, join } from 'node:path';
+import { runCreateFlow } from './template-flow';
 
 export const createProjectSubcommand = createSubcommand({
 	name: 'create',
@@ -14,234 +12,41 @@ export const createProjectSubcommand = createSubcommand({
 		options: z.object({
 			name: z.string().optional().describe('Project name'),
 			dir: z.string().optional().describe('Directory to create the project in'),
+			template: z.string().optional().describe('Template to use'),
+			templateDir: z
+				.string()
+				.optional()
+				.describe('Local template directory for testing (e.g., ./packages/templates)'),
+			templateBranch: z
+				.string()
+				.optional()
+				.describe('GitHub branch to use for templates (default: main)'),
 			install: z
 				.boolean()
 				.optional()
 				.default(true)
 				.describe('Run bun install after creating the project (use --no-install to skip)'),
-			confirm: z.boolean().optional().describe('Skip confirmation prompts'),
-			fromBunCreate: z
+			build: z
 				.boolean()
 				.optional()
-				.describe('Internal: called from bun create postinstall'),
-			dev: z.boolean().optional().describe('Internal: use local template for testing'),
+				.default(true)
+				.describe('Run bun run build after installing (use --no-build to skip)'),
+			confirm: z.boolean().optional().describe('Skip confirmation prompts'),
 		}),
 	},
 
 	async handler(ctx) {
 		const { logger, opts } = ctx;
-
-		// Case 2: Called from bun create postinstall
-		if (opts.fromBunCreate) {
-			const projectDir = process.cwd();
-			const packageJsonPath = join(projectDir, 'package.json');
-
-			if (!existsSync(packageJsonPath)) {
-				logger.error('package.json not found in current directory');
-				return;
-			}
-
-			// Disable log prefixes for cleaner postinstall output
-			logger.setShowPrefix(false);
-
-			const packageJsonFile = Bun.file(packageJsonPath);
-			const packageJson = await packageJsonFile.json();
-			const projectName = packageJson.name || basename(projectDir);
-
-			logger.info(`\n🔧 Setting up ${projectName}...\n`);
-
-			// Update package.json - remove bun-create metadata
-			packageJson.name = projectName;
-			delete packageJson['bun-create'];
-			delete packageJson.bin;
-			packageJson.private = true;
-			delete packageJson.files;
-			delete packageJson.keywords;
-			delete packageJson.author;
-			delete packageJson.license;
-			delete packageJson.publishConfig;
-			delete packageJson.description;
-
-			// Remove enquirer from dependencies (only needed for setup)
-			if (packageJson.dependencies) {
-				delete packageJson.dependencies.enquirer;
-			}
-
-			await Bun.write(packageJsonPath, JSON.stringify(packageJson, null, '\t'));
-			logger.info('✓ Updated package.json');
-
-			// Update README.md
-			const readmePath = join(projectDir, 'README.md');
-			if (existsSync(readmePath)) {
-				const readmeFile = Bun.file(readmePath);
-				let readme = await readmeFile.text();
-				readme = readme.replace(/\{\{PROJECT_NAME\}\}/g, projectName);
-				await Bun.write(readmePath, readme);
-				logger.info('✓ Updated README.md');
-			}
-
-			// Update AGENTS.md
-			const agentsMdPath = join(projectDir, 'AGENTS.md');
-			if (existsSync(agentsMdPath)) {
-				const agentsMdFile = Bun.file(agentsMdPath);
-				let agentsMd = await agentsMdFile.text();
-				agentsMd = agentsMd.replace(/\{\{PROJECT_NAME\}\}/g, projectName);
-				await Bun.write(agentsMdPath, agentsMd);
-				logger.info('✓ Updated AGENTS.md');
-			}
-
-			// Remove setup files
-			const filesToRemove = ['setup.ts'];
-			for (const file of filesToRemove) {
-				const filePath = join(projectDir, file);
-				if (existsSync(filePath)) {
-					await Bun.$`rm ${filePath}`;
-					logger.info('✓ Removed ${file}');
-				}
-			}
-
-			logger.info('\n✨ Setup complete!\n');
-			return;
-		}
-
-		// Case 1: Normal CLI flow
-		// Relaxed validation: any reasonable name between 2-64 characters
-		const isValidProjectName = (name: string): boolean => {
-			return name.trim().length >= 2 && name.trim().length <= 64;
-		};
-
-		// Transform name to URL and disk-friendly format
-		const transformToDirectoryName = (name: string): string => {
-			const result = name
-				.trim()
-				.toLowerCase()
-				.replace(/[^a-z0-9]+/g, '-') // Replace non-alphanumeric with hyphens
-				.replace(/^-+|-+$/g, '') // Remove leading/trailing hyphens
-				.replace(/-+/g, '-') // Replace consecutive hyphens with single hyphen
-				.substring(0, 64); // Ensure max length
-
-			// Validate result is non-empty (happens when name contains only special chars)
-			if (!result) {
-				throw new Error(
-					`Invalid project name "${name}": must contain at least one alphanumeric character`
-				);
-			}
-
-			return result;
-		};
-
-		// Get project name
-		let projectName = opts.name;
-		while (!projectName || !isValidProjectName(projectName)) {
-			const result = await enquirer.prompt<{ name: string }>({
-				type: 'input',
-				name: 'name',
-				message: 'Project name:',
-				initial: projectName,
-				validate: (value: string) => {
-					if (!value) return 'Project name is required';
-					if (!isValidProjectName(value)) {
-						return 'Project name must be between 2 and 64 characters';
-					}
-					return true;
-				},
-			});
-			projectName = result.name;
-		}
-
-		projectName = projectName.trim();
-		const projectDirName = transformToDirectoryName(projectName);
-
-		// Get directory - if specified, create the project there, otherwise create in current dir
-		const baseDir = opts.dir ? resolve(opts.dir) : process.cwd();
-		const targetDir = resolve(baseDir, projectDirName);
-
-		// Check if directory exists and validate
-		let shouldProceed = true;
-		if (existsSync(targetDir)) {
-			const files = readdirSync(targetDir);
-			const hasFiles = files.length > 0;
-
-			if (hasFiles) {
-				if (opts.confirm === false) {
-					logger.error(`Directory ${targetDir} is not empty and --no-confirm was specified`);
-					return;
-				}
-
-				// Require explicit confirmation in non-TTY environments
-				if (opts.confirm !== true && !process.stdin.isTTY) {
-					logger.error(
-						`Directory "${targetDir}" is not empty. Use --confirm flag in non-interactive environments.`
-					);
-					return;
-				}
-
-				// Interactive prompt in TTY environments
-				if (opts.confirm !== true && process.stdin.isTTY) {
-					const result = await enquirer.prompt<{ proceed: boolean }>({
-						type: 'confirm',
-						name: 'proceed',
-						message: `Directory "${targetDir}" is not empty. Files may be overwritten. Continue?`,
-						initial: false,
-					});
-					shouldProceed = result.proceed;
-				}
-
-				if (!shouldProceed) {
-					logger.info('Operation cancelled');
-					return;
-				}
-			}
-		}
-
-		// Print collected values
-		logger.info('\n=== Project Configuration ===');
-		logger.info(`Name: ${projectName}`);
-		logger.info(`Directory Name: ${projectDirName}`);
-		logger.info(`Target Directory: ${targetDir}`);
-		logger.info('=============================\n');
-
-		// Run bun create to scaffold the project
-		logger.info('Creating project from template...');
-
-		try {
-			// Determine template name based on dev mode
-			const templateName = opts.dev ? 'agentuity-dev' : 'agentuity';
-
-			if (opts.dev) {
-				logger.info('🔧 Dev mode: Using local template');
-			}
-
-			// Build bun create command args
-			// Note: bun create supports --no-install to skip dependency installation
-			const bunCreateArgs = ['bun', 'create'];
-			if (opts.install === false) {
-				bunCreateArgs.push('--no-install');
-			}
-			bunCreateArgs.push(templateName, projectDirName);
-
-			logger.info(`Running: ${bunCreateArgs.join(' ')}`);
-
-			const result = Bun.spawn(bunCreateArgs, {
-				cwd: baseDir,
-				stdout: 'inherit',
-				stderr: 'inherit',
-				stdin: 'inherit',
-			});
-
-			const exitCode = await result.exited;
-
-			if (exitCode !== 0) {
-				throw new Error(`bun create exited with code ${exitCode}`);
-			}
-
-			logger.info('\n✨ Project created successfully!');
-			logger.info(`\nNext steps:`);
-			logger.info(`  cd ${projectDirName}`);
-			logger.info(`  bun run dev`);
-		} catch (error) {
-			logger.error('Failed to create project:', error);
-			throw error;
-		}
+		await runCreateFlow({
+			projectName: opts.name,
+			dir: opts.dir,
+			template: opts.template,
+			templateDir: opts.templateDir,
+			templateBranch: opts.templateBranch,
+			noInstall: opts.install === false,
+			noBuild: opts.build === false,
+			skipPrompts: opts.confirm === true,
+			logger,
+		});
 	},
 });

package/src/cmd/project/download.ts

@@ -0,0 +1,159 @@
+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, type Headers } from 'tar-fs';
+import type { Logger } from '@/logger';
+import * as tui from '@/tui';
+import { downloadWithSpinner } from '@/download';
+import type { TemplateInfo } from './templates';
+
+const GITHUB_REPO = 'agentuity/sdk';
+const GITHUB_BRANCH = 'main';
+
+interface DownloadOptions {
+	dest: string;
+	template: TemplateInfo;
+	templateDir?: string;
+	templateBranch?: string;
+}
+
+interface SetupOptions {
+	dest: string;
+	projectName: string;
+	dirName: string;
+	noInstall: boolean;
+	noBuild: boolean;
+	logger: Logger;
+}
+
+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) {
+			cpSync(join(sourceDir, file), join(dest, file), { recursive: true });
+		}
+
+		// Rename gitignore -> .gitignore
+		const gi = join(dest, 'gitignore');
+		if (existsSync(gi)) {
+			renameSync(gi, join(dest, '.gitignore'));
+		}
+	});
+}
+
+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 sourceDir = resolve(join(templateDir, template.directory));
+
+		if (!existsSync(sourceDir)) {
+			throw new Error(`Template directory not found: ${sourceDir}`);
+		}
+
+		return cleanup(sourceDir, dest);
+	}
+
+	// Download from GitHub
+	const branch = templateBranch || GITHUB_BRANCH;
+	const templatePath = `templates/${template.directory}`;
+	const url = `https://codeload.github.com/${GITHUB_REPO}/tar.gz/${branch}`;
+	const tempDir = join(dest, '.temp-download');
+	mkdirSync(tempDir, { recursive: true });
+
+	await downloadWithSpinner(
+		{
+			url,
+			message: templateBranch
+				? `Downloading template files from branch ${branch}...`
+				: 'Downloading template files...',
+		},
+		async (stream) => {
+			// Extract only the template directory from tarball
+			const prefix = `sdk-${branch}/${templatePath}/`;
+			await pipeline(
+				stream,
+				createGunzip(),
+				extract(tempDir, {
+					filter: (name: string) => name.startsWith(prefix),
+					map: (header: Headers) => {
+						header.name = header.name.substring(prefix.length);
+						return header;
+					},
+				})
+			);
+		}
+	);
+
+	await cleanup(tempDir, dest);
+
+	// 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;
+
+	// Replace {{PROJECT_NAME}} in files
+	tui.info(`🔧 Setting up ${projectName}...`);
+	await replaceInFiles(dest, projectName, dirName);
+
+	// Install dependencies
+	if (!noInstall) {
+		const exitCode = await tui.runCommand({
+			command: 'bun install',
+			cwd: dest,
+			cmd: ['bun', 'install'],
+			clearOnSuccess: true,
+		});
+		if (exitCode !== 0) {
+			logger.error('Failed to install dependencies');
+		}
+	}
+
+	// Build project
+	if (!noBuild) {
+		const exitCode = await tui.runCommand({
+			command: 'bun run build',
+			cwd: dest,
+			cmd: ['bun', 'run', 'build'],
+			clearOnSuccess: true,
+		});
+		if (exitCode !== 0) {
+			logger.error('Failed to build project');
+		}
+	}
+}
+
+async function replaceInFiles(dir: string, projectName: string, dirName: string): Promise<void> {
+	const filesToReplace = ['package.json', 'README.md', 'AGENTS.md'];
+
+	for (const file of filesToReplace) {
+		const filePath = join(dir, file);
+		const bunFile = Bun.file(filePath);
+		if (await bunFile.exists()) {
+			let content = await bunFile.text();
+			// Replace human-readable name in most places
+			content = content.replace(/\{\{PROJECT_NAME\}\}/g, projectName);
+			// Replace with directory name for package.json "name" field (npm package name)
+			if (file === 'package.json') {
+				content = content.replace(/"name":\s*".*?"/, `"name": "${dirName}"`);
+			}
+			await Bun.write(filePath, content);
+		}
+	}
+}

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

@@ -0,0 +1,197 @@
+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;
+	noInstall: boolean;
+	noBuild: boolean;
+	skipPrompts: boolean;
+	logger: Logger;
+}
+
+export async function runCreateFlow(options: CreateFlowOptions): Promise<void> {
+	const {
+		projectName: initialProjectName,
+		dir: targetDir,
+		template: initialTemplate,
+		templateDir,
+		templateBranch,
+		skipPrompts,
+		logger,
+	} = options;
+
+	// Step 1: Fetch available templates
+	if (templateDir) {
+		tui.info(`📋 Loading templates from local directory: ${templateDir}...\n`);
+	} else if (templateBranch) {
+		tui.info(`📋 Fetching available templates from branch: ${templateBranch}...\n`);
+	} else {
+		tui.info('📋 Fetching available templates...\n');
+	}
+	const templates = await fetchTemplates(templateDir, templateBranch);
+
+	if (templates.length === 0) {
+		logger.fatal('No templates available');
+	}
+
+	// Step 2: Get project name
+	let projectName = initialProjectName;
+	if (!projectName && !skipPrompts) {
+		const response = await enquirer.prompt<{ name: string }>({
+			type: 'input',
+			name: 'name',
+			message: 'What is the name of your project?',
+			initial: 'My First Agent',
+			validate: (value: string) => {
+				if (!value || value.trim().length === 0) {
+					return 'Project name is required';
+				}
+				return true;
+			},
+		});
+		projectName = response.name;
+	}
+	projectName = projectName || 'My First Agent';
+
+	// Step 3: Generate disk-friendly directory name
+	const dirName = projectName === '.' ? '.' : sanitizeDirectoryName(projectName);
+
+	// Step 4: Determine destination directory
+	// 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 ${dest} already exists and is not empty.`, true);
+			const response = await enquirer.prompt<{ overwrite: boolean }>({
+				type: 'confirm',
+				name: 'overwrite',
+				message: 'Delete and overwrite the directory?',
+				initial: false,
+			});
+
+			if (!response.overwrite) {
+				tui.info('Operation cancelled');
+				process.exit(0);
+			}
+
+			// 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 ${dest}\n`);
+		} else {
+			logger.fatal(`Directory ${dest} already exists and is not empty.`, true);
+		}
+	}
+
+	// Show directory and name confirmation
+	if (!skipPrompts) {
+		tui.info(`📁 Project: ${tui.bold(projectName)}`);
+		tui.info(`📂 Directory: ${tui.bold(dest)}\n`);
+	}
+
+	// Step 5: Select template
+	let selectedTemplate: TemplateInfo;
+	if (initialTemplate) {
+		const found = templates.find((t) => t.id === initialTemplate);
+		if (!found) {
+			logger.fatal(`Template "${initialTemplate}" not found`);
+			return;
+		}
+		selectedTemplate = found;
+	} else if (skipPrompts) {
+		selectedTemplate = templates[0];
+	} else {
+		const response = await enquirer.prompt<{ template: string }>({
+			type: 'select',
+			name: 'template',
+			message: 'Select a template:',
+			choices: templates.map((t) => ({
+				name: t.id,
+				message: `${t.name.padEnd(15, ' ')} ${tui.muted(t.description)}`,
+			})),
+		});
+		const found = templates.find((t) => t.id === response.template);
+		if (!found) {
+			logger.fatal('Template selection failed');
+			return;
+		}
+		selectedTemplate = found;
+	}
+
+	tui.info(`✨ Using template: ${tui.bold(selectedTemplate.name)}`);
+
+	// Step 6: Download template
+	await downloadTemplate({
+		dest,
+		template: selectedTemplate,
+		templateDir,
+		templateBranch,
+	});
+
+	// Step 7: Setup project (replace placeholders, install deps, build)
+	await setupProject({
+		dest,
+		projectName: projectName === '.' ? basename(dest) : projectName,
+		dirName: dirName === '.' ? basename(dest) : dirName,
+		noInstall: options.noInstall,
+		noBuild: options.noBuild,
+		logger,
+	});
+
+	// Step 8: Show completion message
+	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 ${dirDisplay}`)}`);
+		console.log(`  2. ${tui.bold('bun run dev')}`);
+	} else {
+		console.log(`  ${tui.bold('bun run dev')}`);
+	}
+	playSound();
+}
+
+/**
+ * Sanitize a project name to create a safe directory/package name
+ * - Converts to lowercase
+ * - Replaces spaces and underscores with hyphens
+ * - Removes unsafe characters
+ * - Ensures it starts with a letter or number
+ */
+function sanitizeDirectoryName(name: string): string {
+	return name
+		.toLowerCase()
+		.trim()
+		.replace(/\s+/g, '-') // Replace spaces with hyphens
+		.replace(/_+/g, '-') // Replace underscores with hyphens
+		.replace(/[^a-z0-9-]/g, '') // Remove non-alphanumeric except hyphens
+		.replace(/-+/g, '-') // Collapse multiple hyphens
+		.replace(/^-+|-+$/g, '') // Remove leading/trailing hyphens
+		.replace(/^[^a-z0-9]+/, ''); // Remove leading non-alphanumeric
+}

package/src/cmd/project/templates.ts

@@ -0,0 +1,48 @@
+const GITHUB_REPO = 'agentuity/sdk';
+const GITHUB_BRANCH = 'main';
+const TEMPLATES_JSON_PATH = 'templates/templates.json';
+
+export interface TemplateInfo {
+	id: string;
+	name: string;
+	description: string;
+	directory: string;
+}
+
+interface TemplatesManifest {
+	templates: TemplateInfo[];
+}
+
+export async function fetchTemplates(localDir?: string, branch?: string): Promise<TemplateInfo[]> {
+	// Load from local directory if provided
+	if (localDir) {
+		const { join } = await import('node:path');
+		const { resolve } = await import('node:path');
+		const manifestPath = resolve(join(localDir, 'templates.json'));
+		const file = Bun.file(manifestPath);
+
+		if (!(await file.exists())) {
+			throw new Error(`templates.json not found at ${manifestPath}`);
+		}
+
+		const manifest = (await file.json()) as TemplatesManifest;
+		return manifest.templates;
+	}
+
+	// Fetch from GitHub
+	const branchToUse = branch || GITHUB_BRANCH;
+	const url = `https://raw.githubusercontent.com/${GITHUB_REPO}/${branchToUse}/${TEMPLATES_JSON_PATH}`;
+
+	const headers: Record<string, string> = {};
+	if (process.env.GITHUB_TOKEN) {
+		headers['Authorization'] = `token ${process.env.GITHUB_TOKEN}`;
+	}
+
+	const response = await fetch(url, { headers });
+	if (!response.ok) {
+		throw new Error(`Failed to fetch templates: ${response.statusText}`);
+	}
+
+	const manifest = (await response.json()) as TemplatesManifest;
+	return manifest.templates;
+}

package/src/download.ts

@@ -0,0 +1,101 @@
+import { Transform, Readable } from 'node:stream';
+import * as tui from './tui';
+
+export interface DownloadOptions {
+	url: string;
+	headers?: Record<string, string>;
+	message?: string;
+	onProgress?: (percent: number, downloadedBytes: number, totalBytes: number) => void;
+}
+
+/**
+ * Download a file with progress tracking
+ * Returns the response body stream for further processing
+ */
+export async function downloadWithProgress(
+	options: DownloadOptions
+): Promise<NodeJS.ReadableStream> {
+	const { url, headers = {}, onProgress } = options;
+
+	// Add GITHUB_TOKEN if available and not already set
+	const requestHeaders = { ...headers };
+	if (process.env.GITHUB_TOKEN && !requestHeaders['Authorization']) {
+		requestHeaders['Authorization'] = `Bearer ${process.env.GITHUB_TOKEN}`;
+	}
+
+	const response = await fetch(url, { headers: requestHeaders });
+	if (!response.ok) {
+		throw new Error(`Download failed: ${response.statusText}`);
+	}
+
+	const contentLength = parseInt(response.headers.get('content-length') || '0', 10);
+	let downloadedBytes = 0;
+
+	// Create a transform stream that tracks progress
+	const progressStream = new Transform({
+		transform(chunk, _encoding, callback) {
+			downloadedBytes += chunk.length;
+
+			if (contentLength > 0) {
+				const percent = Math.min(100, Math.floor((downloadedBytes / contentLength) * 100));
+				if (onProgress) {
+					onProgress(percent, downloadedBytes, contentLength);
+				}
+			}
+
+			callback(null, chunk);
+		},
+	});
+
+	// Pipe the response through the progress tracker
+	const responseStream = Readable.fromWeb(response.body as unknown as ReadableStream);
+	responseStream.pipe(progressStream);
+
+	return progressStream;
+}
+
+/**
+ * Download a file with a TUI spinner showing progress
+ */
+export async function downloadWithSpinner<T>(
+	options: DownloadOptions,
+	processor: (stream: NodeJS.ReadableStream) => Promise<T>
+): Promise<T> {
+	const { message = 'Downloading...' } = options;
+
+	return await tui.spinner({
+		type: 'progress',
+		message,
+		callback: async (updateProgress) => {
+			const stream = await downloadWithProgress({
+				...options,
+				onProgress: (percent) => updateProgress(percent),
+			});
+
+			const result = await processor(stream);
+
+			// Ensure we show 100% at the end
+			updateProgress(100);
+
+			return result;
+		},
+	});
+}
+
+/**
+ * Download a GitHub tarball with progress tracking
+ */
+export interface DownloadGitHubOptions {
+	repo: string;
+	branch?: string;
+	message?: string;
+}
+
+export async function downloadGitHubTarball(
+	options: DownloadGitHubOptions
+): Promise<NodeJS.ReadableStream> {
+	const { repo, branch = 'main', message = 'Downloading from GitHub...' } = options;
+	const url = `https://codeload.github.com/${repo}/tar.gz/${branch}`;
+
+	return await downloadWithSpinner({ url, message }, async (stream) => stream);
+}

package/src/index.ts

@@ -24,6 +24,13 @@ export { getCommandPrefix, getCommand } from './command-prefix';
 export * as tui from './tui';
 export { runSteps, setStepsColorScheme, stepSuccess, stepSkipped, stepError } from './steps';
 export { playSound } from './sound';
+export {
+	downloadWithProgress,
+	downloadWithSpinner,
+	downloadGitHubTarball,
+	type DownloadOptions as DownloadOptionsType,
+	type DownloadGitHubOptions,
+} from './download';
 export type {
 	Config,
 	LogLevel,

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

@@ -37,7 +37,7 @@ const COLORS = {
 	},
 	muted: {
 		light: Bun.color('#808080', 'ansi') || '\x1b[90m', // gray
-		dark: Bun.color('#DDDDDD', 'ansi') || '\x1b[37m', // light gray
+		dark: Bun.color('#888888', 'ansi') || '\x1b[90m', // darker gray
 	},
 	bold: {
 		light: '\x1b[1m',
@@ -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}`);
 }
@@ -653,6 +653,11 @@ export interface CommandRunnerOptions {
 	 * Environment variables
 	 */
 	env?: Record<string, string>;
+	/**
+	 * If true, clear output on success and only show command + success icon
+	 * Defaults to false
+	 */
+	clearOnSuccess?: boolean;
 }
 
 /**
@@ -666,7 +671,7 @@ export interface CommandRunnerOptions {
  * Shows the last 3 lines of output as it streams.
  */
 export async function runCommand(options: CommandRunnerOptions): Promise<number> {
-	const { command, cmd, cwd, env } = options;
+	const { command, cmd, cwd, env, clearOnSuccess = false } = options;
 	const isTTY = process.stdout.isTTY;
 
 	// If not a TTY, just run the command normally and log output
@@ -785,26 +790,41 @@ export async function runCommand(options: CommandRunnerOptions): Promise<number>
 		// Wait for process to exit
 		const exitCode = await proc.exited;
 
-		// Determine how many lines to show in final output
-		const finalLinesToShow = exitCode === 0 ? 3 : 10;
-
 		// Move cursor up to redraw final state
 		if (linesRendered > 0) {
 			process.stdout.write(`\x1b[${linesRendered}A`);
 		}
 
-		// Show final status with appropriate color
-		const statusColor = exitCode === 0 ? green : red;
-		process.stdout.write(`\r\x1b[K${statusColor}$${reset} ${cmdColor}${displayCmd}${reset}\n`);
+		// Clear all lines if clearOnSuccess is true and command succeeded
+		if (clearOnSuccess && exitCode === 0) {
+			// Clear all rendered lines
+			for (let i = 0; i < linesRendered; i++) {
+				process.stdout.write('\r\x1b[K\n');
+			}
+			// Move cursor back up
+			process.stdout.write(`\x1b[${linesRendered}A`);
 
-		// Show final output lines
-		const finalOutputLines = allOutputLines.slice(-finalLinesToShow);
-		for (const line of finalOutputLines) {
-			let displayLine = line;
-			if (getDisplayWidth(displayLine) > maxLineWidth) {
-				displayLine = displayLine.slice(0, maxLineWidth - 3) + '...';
+			// Show compact success: ✓ command
+			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;
+
+			// Show final status with appropriate color
+			const statusColor = exitCode === 0 ? green : red;
+			process.stdout.write(`\r\x1b[K${statusColor}$${reset} ${cmdColor}${displayCmd}${reset}\n`);
+
+			// Show final output lines
+			const finalOutputLines = allOutputLines.slice(-finalLinesToShow);
+			for (const line of finalOutputLines) {
+				let displayLine = line;
+				if (getDisplayWidth(displayLine) > maxLineWidth) {
+					displayLine = displayLine.slice(0, maxLineWidth - 3) + '...';
+				}
+				process.stdout.write(`\r\x1b[K${mutedColor}${displayLine}${reset}\n`);
 			}
-			process.stdout.write(`\r\x1b[K${mutedColor}${displayLine}${reset}\n`);
 		}
 
 		return exitCode;