Add detailed output for CLI create command (#139)

* Add detailed output for CLI create command

- Show progress steps with [done] status
- Display created project structure summary
- Print success message and next steps (cd, agentcore)
- Matches TUI output for consistent user experience

* Use progress callbacks for real-time CLI output

- Add onProgress callback to createProject and createProjectWithAgent
- Show real progress as each step completes (not fake progress after the fact)
- Follow same pattern as deploy command for consistency

Author: tejaskash

src/cli/commands/create/action.ts

@@ -40,15 +40,18 @@ function createDefaultMcpDefs(): AgentCoreCliMcpDefs {
   return { tools: {} };
 }
 
+export type ProgressCallback = (step: string, status: 'start' | 'done' | 'error') => void;
+
 export interface CreateProjectOptions {
   name: string;
   cwd: string;
   skipGit?: boolean;
   skipDependencyCheck?: boolean;
+  onProgress?: ProgressCallback;
 }
 
 export async function createProject(options: CreateProjectOptions): Promise<CreateResult> {
-  const { name, cwd, skipGit, skipDependencyCheck } = options;
+  const { name, cwd, skipGit, skipDependencyCheck, onProgress } = options;
   const projectRoot = join(cwd, name);
   const configBaseDir = join(projectRoot, CONFIG_DIR);
 
@@ -66,10 +69,13 @@ export async function createProject(options: CreateProjectOptions): Promise<Crea
 
   try {
     // Create project directory
+    onProgress?.(`Create ${name}/ project directory`, 'start');
     // eslint-disable-next-line security/detect-non-literal-fs-filename
     await mkdir(projectRoot, { recursive: true });
+    onProgress?.(`Create ${name}/ project directory`, 'done');
 
     // Initialize config directory
+    onProgress?.('Prepare agentcore/ directory', 'start');
     const configIO = new ConfigIO({ baseDir: configBaseDir });
     await configIO.initializeBaseDir();
 
@@ -87,13 +93,17 @@ export async function createProject(options: CreateProjectOptions): Promise<Crea
     // Create CDK project
     const cdkRenderer = new CDKRenderer();
     await cdkRenderer.render({ projectRoot });
+    onProgress?.('Prepare agentcore/ directory', 'done');
 
     // Initialize git (unless skipped)
     if (!skipGit) {
+      onProgress?.('Initialize git repository', 'start');
       const gitResult = await initGitRepo(projectRoot);
       if (gitResult.status === 'error') {
+        onProgress?.('Initialize git repository', 'error');
         return { success: false, error: gitResult.message, warnings: depWarnings };
       }
+      onProgress?.('Initialize git repository', 'done');
     }
 
     return {
@@ -118,10 +128,12 @@ export interface CreateWithAgentOptions {
   memory: MemoryOption;
   skipGit?: boolean;
   skipPythonSetup?: boolean;
+  onProgress?: ProgressCallback;
 }
 
 export async function createProjectWithAgent(options: CreateWithAgentOptions): Promise<CreateResult> {
-  const { name, cwd, language, framework, modelProvider, apiKey, memory, skipGit, skipPythonSetup } = options;
+  const { name, cwd, language, framework, modelProvider, apiKey, memory, skipGit, skipPythonSetup, onProgress } =
+    options;
   const projectRoot = join(cwd, name);
   const configBaseDir = join(projectRoot, CONFIG_DIR);
 
@@ -135,7 +147,7 @@ export async function createProjectWithAgent(options: CreateWithAgentOptions): P
   }
 
   // First create the base project (skip dependency check since we already did it)
-  const projectResult = await createProject({ name, cwd, skipGit, skipDependencyCheck: true });
+  const projectResult = await createProject({ name, cwd, skipGit, skipDependencyCheck: true, onProgress });
   if (!projectResult.success) {
     // Merge warnings from both checks
     const allWarnings = [...depWarnings, ...(projectResult.warnings ?? [])];
@@ -145,6 +157,7 @@ export async function createProjectWithAgent(options: CreateWithAgentOptions): P
   try {
     // Build GenerateConfig for agent creation
     // Note: In this context, agent name = project name since we're creating a project with a single agent
+    onProgress?.('Add agent to project', 'start');
     const agentName = name;
     const generateConfig = {
       projectName: agentName,
@@ -168,11 +181,14 @@ export async function createProjectWithAgent(options: CreateWithAgentOptions): P
       const envVarName = computeDefaultCredentialEnvVarName(credentialName);
       await setEnvVar(envVarName, apiKey, configBaseDir);
     }
+    onProgress?.('Add agent to project', 'done');
 
     // Set up Python environment if needed (unless skipped)
     if (language === 'Python' && !skipPythonSetup) {
+      onProgress?.('Set up Python environment', 'start');
       const agentDir = join(projectRoot, APP_DIR, name);
       await setupPythonProject({ projectDir: agentDir });
+      onProgress?.('Set up Python environment', 'done');
     }
 
     return {

src/cli/commands/create/command.tsx

@@ -3,17 +3,53 @@ import type { ModelProvider, SDKFramework, TargetLanguage } from '../../../schem
 import { getErrorMessage } from '../../errors';
 import { COMMAND_DESCRIPTIONS } from '../../tui/copy';
 import { CreateScreen } from '../../tui/screens/create';
-import { createProject, createProjectWithAgent, getDryRunInfo } from './action';
+import { createProject, createProjectWithAgent, getDryRunInfo, type ProgressCallback } from './action';
 import type { CreateOptions } from './types';
 import { validateCreateOptions } from './validate';
 import type { Command } from '@commander-js/extra-typings';
 import { Text, render } from 'ink';
 
+/** Render CreateScreen for interactive TUI mode */
 function handleCreateTUI(): void {
   const cwd = getWorkingDirectory();
   const { unmount } = render(<CreateScreen cwd={cwd} isInteractive={false} onExit={() => unmount()} />);
 }
 
+/** Print completion summary after successful create */
+function printCreateSummary(
+  projectName: string,
+  agentName: string | undefined,
+  language: string | undefined,
+  framework: string | undefined
+): void {
+  const green = '\x1b[32m';
+  const cyan = '\x1b[36m';
+  const dim = '\x1b[2m';
+  const reset = '\x1b[0m';
+
+  console.log('');
+
+  // Created summary
+  console.log(`${dim}Created:${reset}`);
+  console.log(`  ${projectName}/`);
+  if (agentName) {
+    const frameworkLabel = framework ?? 'agent';
+    console.log(`    app/${agentName}/  ${dim}${language} agent (${frameworkLabel})${reset}`);
+  }
+  console.log(`    agentcore/           ${dim}Config and CDK project${reset}`);
+  console.log('');
+
+  // Success and next steps
+  console.log(`${green}Project created successfully!${reset}`);
+  console.log('');
+  console.log('To continue, navigate to your new project:');
+  console.log('');
+  console.log(`  ${cyan}cd ${projectName}${reset}`);
+  console.log(`  ${cyan}agentcore${reset}`);
+  console.log('');
+}
+
+/** Handle CLI mode with progress output */
 async function handleCreateCLI(options: CreateOptions): Promise<void> {
   const validation = validateCreateOptions(options);
   if (!validation.valid) {
@@ -41,11 +77,26 @@ async function handleCreateCLI(options: CreateOptions): Promise<void> {
     process.exit(0);
   }
 
+  const green = '\x1b[32m';
+  const reset = '\x1b[0m';
+
+  // Progress callback for real-time output
+  const onProgress: ProgressCallback | undefined = options.json
+    ? undefined
+    : (step, status) => {
+        if (status === 'done') {
+          console.log(`${green}[done]${reset}  ${step}`);
+        } else if (status === 'error') {
+          console.log(`\x1b[31m[error]${reset} ${step}`);
+        }
+        // 'start' is silent - we only show when done
+      };
+
   // Commander.js --no-agent sets agent=false, not noAgent=true
   const skipAgent = options.agent === false;
 
   const result = skipAgent
-    ? await createProject({ name: options.name!, cwd, skipGit: options.skipGit })
+    ? await createProject({ name: options.name!, cwd, skipGit: options.skipGit, onProgress })
     : await createProjectWithAgent({
         name: options.name!,
         cwd,
@@ -56,12 +107,13 @@ async function handleCreateCLI(options: CreateOptions): Promise<void> {
         memory: options.memory as 'none' | 'shortTerm' | 'longAndShortTerm',
         skipGit: options.skipGit,
         skipPythonSetup: options.skipPythonSetup,
+        onProgress,
       });
 
   if (options.json) {
     console.log(JSON.stringify(result));
   } else if (result.success) {
-    console.log(`Created project at ${result.projectPath}`);
+    printCreateSummary(options.name!, result.agentName, options.language, options.framework);
   } else {
     console.error(result.error);
   }