@codebakers/cli 3.8.1 → 3.8.2

package/dist/commands/build.d.ts

@@ -0,0 +1,27 @@
+/**
+ * CODEBAKERS BUILD COMMAND
+ *
+ * This is the zero-friction project builder.
+ * User describes what they want → AI builds actual files on their machine.
+ *
+ * Flow:
+ * 1. User runs: codebakers build "SaaS for invoicing"
+ * 2. CLI creates engineering session on server
+ * 3. Server runs AI agents to generate PRD, specs, code
+ * 4. CLI receives file contents and writes them to disk
+ * 5. User has a runnable project
+ */
+interface BuildOptions {
+    description?: string;
+    output?: string;
+    verbose?: boolean;
+}
+/**
+ * Main build command
+ */
+export declare function build(options?: BuildOptions): Promise<void>;
+/**
+ * Check build status
+ */
+export declare function buildStatus(): Promise<void>;
+export {};

package/dist/commands/build.js

@@ -0,0 +1,325 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.build = build;
+exports.buildStatus = buildStatus;
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const readline_1 = require("readline");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const config_js_1 = require("../config.js");
+async function prompt(question) {
+    const rl = (0, readline_1.createInterface)({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+/**
+ * Main build command
+ */
+async function build(options = {}) {
+    console.log(chalk_1.default.blue(`
+  ╔═══════════════════════════════════════════════════════════╗
+  ║                                                           ║
+  ║   ${chalk_1.default.bold('CodeBakers Build')}                                      ║
+  ║                                                           ║
+  ║   Describe your project → Get working code                ║
+  ║                                                           ║
+  ╚═══════════════════════════════════════════════════════════╝
+  `));
+    // Check authentication
+    if (!(0, config_js_1.hasValidAccess)()) {
+        console.log(chalk_1.default.red('  ✗ Not authenticated\n'));
+        console.log(chalk_1.default.gray('  Run: codebakers go (free trial) or codebakers setup (with API key)\n'));
+        process.exit(1);
+    }
+    // Get project description
+    let description = options.description;
+    if (!description) {
+        console.log(chalk_1.default.white('  What do you want to build?\n'));
+        console.log(chalk_1.default.gray('  Examples:'));
+        console.log(chalk_1.default.gray('    • "A SaaS for managing invoices with Stripe payments"'));
+        console.log(chalk_1.default.gray('    • "Todo app with user auth and real-time sync"'));
+        console.log(chalk_1.default.gray('    • "Blog platform with markdown support"\n'));
+        description = await prompt('  Describe your project: ');
+        if (!description.trim()) {
+            console.log(chalk_1.default.red('\n  Please provide a project description.\n'));
+            process.exit(1);
+        }
+    }
+    const outputDir = options.output || process.cwd();
+    // Check if directory is empty
+    const files = (0, fs_1.existsSync)(outputDir) ?
+        require('fs').readdirSync(outputDir).filter((f) => !f.startsWith('.')) : [];
+    if (files.length > 0) {
+        console.log(chalk_1.default.yellow('\n  ⚠️  This directory is not empty.'));
+        const proceed = await prompt('  Continue? (y/N): ');
+        if (proceed.toLowerCase() !== 'y') {
+            console.log(chalk_1.default.gray('\n  Build cancelled.\n'));
+            return;
+        }
+    }
+    console.log(chalk_1.default.green(`\n  Building: "${description}"\n`));
+    // Create engineering session
+    const spinner = (0, ora_1.default)('  Initializing build...').start();
+    try {
+        const apiUrl = (0, config_js_1.getApiUrl)();
+        const apiKey = (0, config_js_1.getApiKey)();
+        const trial = (0, config_js_1.getTrialState)();
+        let authHeader = '';
+        if (apiKey) {
+            authHeader = `Bearer ${apiKey}`;
+        }
+        else if (trial?.trialId) {
+            authHeader = `Trial ${trial.trialId}`;
+        }
+        if (!authHeader) {
+            spinner.fail('Authentication required');
+            console.log(chalk_1.default.gray('\n  Run: codebakers go\n'));
+            return;
+        }
+        // Step 1: Create engineering session
+        spinner.text = '  Creating build session...';
+        const createResponse = await fetch(`${apiUrl}/api/engineering/sessions`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': authHeader,
+            },
+            body: JSON.stringify({
+                projectName: description,
+                projectDescription: description,
+                source: 'cli',
+            }),
+        });
+        if (!createResponse.ok) {
+            const error = await createResponse.json().catch(() => ({}));
+            throw new Error(error.error || 'Failed to create build session');
+        }
+        const { data: sessionData } = await createResponse.json();
+        const sessionId = sessionData.sessionId;
+        spinner.text = '  Session created, starting build...';
+        // Step 2: Auto-complete scoping
+        await fetch(`${apiUrl}/api/engineering/sessions/${sessionId}/scope`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': authHeader,
+            },
+            body: JSON.stringify({ stepId: 'auto', answer: description }),
+        });
+        // Step 3: Start the build with file generation enabled
+        const buildResponse = await fetch(`${apiUrl}/api/engineering/sessions/${sessionId}/build`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': authHeader,
+            },
+            body: JSON.stringify({
+                generateFiles: true, // Tell server to generate actual file contents
+            }),
+        });
+        if (!buildResponse.ok) {
+            const error = await buildResponse.json().catch(() => ({}));
+            throw new Error(error.error || 'Failed to start build');
+        }
+        spinner.succeed('Build started!');
+        console.log('');
+        // Step 4: Stream progress and receive files
+        await streamBuildProgress(apiUrl, authHeader, sessionId, outputDir, options.verbose);
+    }
+    catch (error) {
+        spinner.fail('Build failed');
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        console.log(chalk_1.default.red(`\n  Error: ${message}\n`));
+        process.exit(1);
+    }
+}
+/**
+ * Stream build progress and write files as they're generated
+ */
+async function streamBuildProgress(apiUrl, authHeader, sessionId, outputDir, verbose) {
+    const phases = new Map();
+    let filesCreated = 0;
+    let currentSpinner = null;
+    // Display phase progress
+    function displayPhase(phase, status, displayName) {
+        const icon = status === 'completed' ? chalk_1.default.green('✓') :
+            status === 'in_progress' ? chalk_1.default.blue('●') :
+                status === 'failed' ? chalk_1.default.red('✗') : chalk_1.default.gray('○');
+        if (status === 'in_progress') {
+            if (currentSpinner)
+                currentSpinner.stop();
+            currentSpinner = (0, ora_1.default)(`  ${displayName}...`).start();
+        }
+        else if (status === 'completed' && currentSpinner) {
+            currentSpinner.succeed(`  ${displayName}`);
+            currentSpinner = null;
+        }
+        else if (status === 'failed' && currentSpinner) {
+            currentSpinner.fail(`  ${displayName}`);
+            currentSpinner = null;
+        }
+    }
+    // Write a file to disk
+    function writeFile(file) {
+        const fullPath = (0, path_1.join)(outputDir, file.path);
+        const dir = (0, path_1.dirname)(fullPath);
+        if (!(0, fs_1.existsSync)(dir)) {
+            (0, fs_1.mkdirSync)(dir, { recursive: true });
+        }
+        (0, fs_1.writeFileSync)(fullPath, file.content);
+        filesCreated++;
+        if (verbose) {
+            console.log(chalk_1.default.gray(`    + ${file.path}`));
+        }
+    }
+    // Poll for updates (SSE would be better but this works for CLI)
+    let isComplete = false;
+    let pollCount = 0;
+    const maxPolls = 300; // 10 minutes max (2s intervals)
+    while (!isComplete && pollCount < maxPolls) {
+        try {
+            const response = await fetch(`${apiUrl}/api/engineering/sessions/${sessionId}/progress`, {
+                headers: {
+                    'Authorization': authHeader,
+                },
+            });
+            if (!response.ok) {
+                throw new Error('Failed to get build progress');
+            }
+            const data = await response.json();
+            const progress = data.data || data;
+            // Update phase displays
+            if (progress.phases) {
+                for (const phase of progress.phases) {
+                    const existing = phases.get(phase.phase);
+                    if (!existing || existing.status !== phase.status) {
+                        phases.set(phase.phase, phase);
+                        displayPhase(phase.phase, phase.status, phase.displayName || phase.phase);
+                    }
+                }
+            }
+            // Write any new files
+            if (progress.newFiles && progress.newFiles.length > 0) {
+                for (const file of progress.newFiles) {
+                    writeFile(file);
+                }
+            }
+            // Check if build is complete
+            if (progress.status === 'completed' || progress.status === 'failed' || progress.status === 'abandoned') {
+                isComplete = true;
+                if (currentSpinner !== null) {
+                    currentSpinner.stop();
+                    currentSpinner = null;
+                }
+                if (progress.status === 'completed') {
+                    // Write final files if any
+                    if (progress.files && progress.files.length > 0) {
+                        console.log(chalk_1.default.white('\n  Writing project files...\n'));
+                        const fileSpinner = (0, ora_1.default)('  Creating files...').start();
+                        for (const file of progress.files) {
+                            writeFile(file);
+                        }
+                        fileSpinner.succeed(`  Created ${filesCreated} files`);
+                    }
+                    // Success message
+                    console.log(chalk_1.default.green(`
+  ╔═══════════════════════════════════════════════════════════╗
+  ║                                                           ║
+  ║   ${chalk_1.default.bold('✓ Build complete!')}                                     ║
+  ║                                                           ║
+  ╚═══════════════════════════════════════════════════════════╝
+          `));
+                    console.log(chalk_1.default.white('  Next steps:\n'));
+                    console.log(chalk_1.default.cyan('    1. ') + chalk_1.default.white('Install dependencies:'));
+                    console.log(chalk_1.default.gray('       npm install\n'));
+                    console.log(chalk_1.default.cyan('    2. ') + chalk_1.default.white('Set up your database:'));
+                    console.log(chalk_1.default.gray('       npx drizzle-kit db:push\n'));
+                    console.log(chalk_1.default.cyan('    3. ') + chalk_1.default.white('Start the dev server:'));
+                    console.log(chalk_1.default.gray('       npm run dev\n'));
+                    // Show summary
+                    if (progress.summary) {
+                        console.log(chalk_1.default.gray(`  Summary: ${progress.summary.filesCreated || filesCreated} files, ${progress.summary.tokensUsed || 0} tokens used\n`));
+                    }
+                }
+                else {
+                    console.log(chalk_1.default.red(`\n  Build ${progress.status}: ${progress.lastError || 'Unknown error'}\n`));
+                }
+            }
+        }
+        catch (error) {
+            if (verbose) {
+                console.log(chalk_1.default.gray(`    Poll error: ${error}`));
+            }
+        }
+        if (!isComplete) {
+            await new Promise(resolve => setTimeout(resolve, 2000));
+            pollCount++;
+        }
+    }
+    if (!isComplete) {
+        if (currentSpinner !== null) {
+            currentSpinner.fail('Build timed out');
+        }
+        console.log(chalk_1.default.yellow('\n  Build is taking longer than expected.'));
+        console.log(chalk_1.default.gray('  Check status: codebakers build-status\n'));
+    }
+}
+/**
+ * Check build status
+ */
+async function buildStatus() {
+    console.log(chalk_1.default.blue('\n  Checking recent builds...\n'));
+    const apiUrl = (0, config_js_1.getApiUrl)();
+    const apiKey = (0, config_js_1.getApiKey)();
+    const trial = (0, config_js_1.getTrialState)();
+    let authHeader = '';
+    if (apiKey) {
+        authHeader = `Bearer ${apiKey}`;
+    }
+    else if (trial?.trialId) {
+        authHeader = `Trial ${trial.trialId}`;
+    }
+    if (!authHeader) {
+        console.log(chalk_1.default.red('  Not authenticated. Run: codebakers go\n'));
+        return;
+    }
+    try {
+        const response = await fetch(`${apiUrl}/api/engineering/sessions`, {
+            headers: {
+                'Authorization': authHeader,
+            },
+        });
+        if (!response.ok) {
+            throw new Error('Failed to get builds');
+        }
+        const { data } = await response.json();
+        const sessions = data.sessions || [];
+        if (sessions.length === 0) {
+            console.log(chalk_1.default.gray('  No builds found. Run: codebakers build "your project"\n'));
+            return;
+        }
+        console.log(chalk_1.default.white('  Recent builds:\n'));
+        for (const session of sessions.slice(0, 5)) {
+            const statusIcon = session.status === 'completed' ? chalk_1.default.green('✓') :
+                session.status === 'active' ? chalk_1.default.blue('●') :
+                    session.status === 'failed' ? chalk_1.default.red('✗') : chalk_1.default.gray('○');
+            console.log(`  ${statusIcon} ${session.projectName}`);
+            console.log(chalk_1.default.gray(`    Status: ${session.status} | Phase: ${session.currentPhase} | Progress: ${session.progress}%\n`));
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        console.log(chalk_1.default.red(`  Error: ${message}\n`));
+    }
+}

package/dist/index.js

@@ -27,6 +27,7 @@ const push_patterns_js_1 = require("./commands/push-patterns.js");
 const go_js_1 = require("./commands/go.js");
 const extend_js_1 = require("./commands/extend.js");
 const billing_js_1 = require("./commands/billing.js");
+const build_js_1 = require("./commands/build.js");
 const config_js_2 = require("./config.js");
 const child_process_1 = require("child_process");
 const api_js_1 = require("./lib/api.js");
@@ -305,6 +306,7 @@ function showWelcome() {
   `));
     console.log(chalk_1.default.white('  Getting Started:\n'));
     console.log(chalk_1.default.cyan('    codebakers go') + chalk_1.default.gray('         Start free trial instantly (no signup!)'));
+    console.log(chalk_1.default.cyan('    codebakers build') + chalk_1.default.gray('      Describe your project → Get working code'));
     console.log(chalk_1.default.cyan('    codebakers scaffold') + chalk_1.default.gray('   Create a new project from scratch'));
     console.log(chalk_1.default.cyan('    codebakers init') + chalk_1.default.gray('       Add patterns to existing project\n'));
     console.log(chalk_1.default.white('  Development:\n'));
@@ -313,20 +315,20 @@ function showWelcome() {
     console.log(chalk_1.default.cyan('    codebakers status') + chalk_1.default.gray('     Check what\'s installed'));
     console.log(chalk_1.default.cyan('    codebakers config') + chalk_1.default.gray('     View or modify configuration\n'));
     console.log(chalk_1.default.white('  Examples:\n'));
+    console.log(chalk_1.default.gray('    $ ') + chalk_1.default.cyan('codebakers build "SaaS for invoicing"'));
+    console.log(chalk_1.default.gray('      AI generates full project with auth, payments, dashboard\n'));
     console.log(chalk_1.default.gray('    $ ') + chalk_1.default.cyan('codebakers scaffold'));
     console.log(chalk_1.default.gray('      Create a new Next.js + Supabase + Drizzle project\n'));
     console.log(chalk_1.default.gray('    $ ') + chalk_1.default.cyan('codebakers generate component Button'));
     console.log(chalk_1.default.gray('      Generate a React component with TypeScript\n'));
-    console.log(chalk_1.default.gray('    $ ') + chalk_1.default.cyan('codebakers g api users'));
-    console.log(chalk_1.default.gray('      Generate a Next.js API route with validation\n'));
     console.log(chalk_1.default.white('  Quality:\n'));
     console.log(chalk_1.default.cyan('    codebakers audit') + chalk_1.default.gray('      Run automated code quality checks'));
     console.log(chalk_1.default.cyan('    codebakers heal') + chalk_1.default.gray('       Auto-detect and fix common issues'));
     console.log(chalk_1.default.cyan('    codebakers doctor') + chalk_1.default.gray('     Check CodeBakers setup\n'));
     console.log(chalk_1.default.white('  All Commands:\n'));
-    console.log(chalk_1.default.gray('    go, extend, billing, setup, scaffold, init, generate, upgrade, status'));
-    console.log(chalk_1.default.gray('    audit, heal, doctor, config, login, install, uninstall'));
-    console.log(chalk_1.default.gray('    install-hook, uninstall-hook, serve, mcp-config, mcp-uninstall\n'));
+    console.log(chalk_1.default.gray('    go, extend, billing, build, build-status, setup, scaffold, init'));
+    console.log(chalk_1.default.gray('    generate, upgrade, status, audit, heal, doctor, config'));
+    console.log(chalk_1.default.gray('    login, install, uninstall, serve, mcp-config, mcp-uninstall\n'));
     console.log(chalk_1.default.gray('  Run ') + chalk_1.default.cyan('codebakers <command> --help') + chalk_1.default.gray(' for more info\n'));
 }
 const program = new commander_1.Command();
@@ -350,6 +352,21 @@ program
     .alias('subscribe')
     .description('Manage subscription or upgrade to paid plan')
     .action(billing_js_1.billing);
+// AI Build command - describe what you want, get working code
+program
+    .command('build [description]')
+    .description('Build a project from description - AI generates actual files')
+    .option('-o, --output <dir>', 'Output directory (default: current directory)')
+    .option('-v, --verbose', 'Show detailed progress')
+    .action((description, options) => (0, build_js_1.build)({
+    description,
+    output: options.output,
+    verbose: options.verbose,
+}));
+program
+    .command('build-status')
+    .description('Check status of recent builds')
+    .action(build_js_1.buildStatus);
 // Primary command - one-time setup (for paid users)
 program
     .command('setup')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codebakers/cli",
-  "version": "3.8.1",
+  "version": "3.8.2",
   "description": "CodeBakers CLI - Production patterns for AI-assisted development",
   "main": "dist/index.js",
   "bin": {

package/src/commands/build.ts

@@ -0,0 +1,425 @@
+import chalk from 'chalk';
+import ora, { type Ora } from 'ora';
+import { createInterface } from 'readline';
+import { writeFileSync, mkdirSync, existsSync, readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { getApiKey, getApiUrl, getTrialState, hasValidAccess } from '../config.js';
+
+/**
+ * CODEBAKERS BUILD COMMAND
+ *
+ * This is the zero-friction project builder.
+ * User describes what they want → AI builds actual files on their machine.
+ *
+ * Flow:
+ * 1. User runs: codebakers build "SaaS for invoicing"
+ * 2. CLI creates engineering session on server
+ * 3. Server runs AI agents to generate PRD, specs, code
+ * 4. CLI receives file contents and writes them to disk
+ * 5. User has a runnable project
+ */
+
+interface BuildOptions {
+  description?: string;
+  output?: string;
+  verbose?: boolean;
+}
+
+interface FileToCreate {
+  path: string;
+  content: string;
+  type: 'code' | 'config' | 'doc';
+}
+
+interface BuildPhase {
+  phase: string;
+  status: 'pending' | 'in_progress' | 'completed' | 'failed';
+  displayName: string;
+  files?: FileToCreate[];
+}
+
+interface BuildStreamEvent {
+  type: 'phase_start' | 'phase_complete' | 'file_create' | 'message' | 'error' | 'complete';
+  phase?: string;
+  displayName?: string;
+  message?: string;
+  file?: FileToCreate;
+  files?: FileToCreate[];
+  error?: string;
+  summary?: {
+    filesCreated: number;
+    phases: number;
+    tokensUsed: number;
+  };
+}
+
+async function prompt(question: string): Promise<string> {
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+
+/**
+ * Main build command
+ */
+export async function build(options: BuildOptions = {}): Promise<void> {
+  console.log(chalk.blue(`
+  ╔═══════════════════════════════════════════════════════════╗
+  ║                                                           ║
+  ║   ${chalk.bold('CodeBakers Build')}                                      ║
+  ║                                                           ║
+  ║   Describe your project → Get working code                ║
+  ║                                                           ║
+  ╚═══════════════════════════════════════════════════════════╝
+  `));
+
+  // Check authentication
+  if (!hasValidAccess()) {
+    console.log(chalk.red('  ✗ Not authenticated\n'));
+    console.log(chalk.gray('  Run: codebakers go (free trial) or codebakers setup (with API key)\n'));
+    process.exit(1);
+  }
+
+  // Get project description
+  let description = options.description;
+  if (!description) {
+    console.log(chalk.white('  What do you want to build?\n'));
+    console.log(chalk.gray('  Examples:'));
+    console.log(chalk.gray('    • "A SaaS for managing invoices with Stripe payments"'));
+    console.log(chalk.gray('    • "Todo app with user auth and real-time sync"'));
+    console.log(chalk.gray('    • "Blog platform with markdown support"\n'));
+
+    description = await prompt('  Describe your project: ');
+
+    if (!description.trim()) {
+      console.log(chalk.red('\n  Please provide a project description.\n'));
+      process.exit(1);
+    }
+  }
+
+  const outputDir = options.output || process.cwd();
+
+  // Check if directory is empty
+  const files = existsSync(outputDir) ?
+    require('fs').readdirSync(outputDir).filter((f: string) => !f.startsWith('.')) : [];
+
+  if (files.length > 0) {
+    console.log(chalk.yellow('\n  ⚠️  This directory is not empty.'));
+    const proceed = await prompt('  Continue? (y/N): ');
+    if (proceed.toLowerCase() !== 'y') {
+      console.log(chalk.gray('\n  Build cancelled.\n'));
+      return;
+    }
+  }
+
+  console.log(chalk.green(`\n  Building: "${description}"\n`));
+
+  // Create engineering session
+  const spinner = ora('  Initializing build...').start();
+
+  try {
+    const apiUrl = getApiUrl();
+    const apiKey = getApiKey();
+    const trial = getTrialState();
+
+    let authHeader = '';
+    if (apiKey) {
+      authHeader = `Bearer ${apiKey}`;
+    } else if (trial?.trialId) {
+      authHeader = `Trial ${trial.trialId}`;
+    }
+
+    if (!authHeader) {
+      spinner.fail('Authentication required');
+      console.log(chalk.gray('\n  Run: codebakers go\n'));
+      return;
+    }
+
+    // Step 1: Create engineering session
+    spinner.text = '  Creating build session...';
+
+    const createResponse = await fetch(`${apiUrl}/api/engineering/sessions`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': authHeader,
+      },
+      body: JSON.stringify({
+        projectName: description,
+        projectDescription: description,
+        source: 'cli',
+      }),
+    });
+
+    if (!createResponse.ok) {
+      const error = await createResponse.json().catch(() => ({}));
+      throw new Error(error.error || 'Failed to create build session');
+    }
+
+    const { data: sessionData } = await createResponse.json();
+    const sessionId = sessionData.sessionId;
+
+    spinner.text = '  Session created, starting build...';
+
+    // Step 2: Auto-complete scoping
+    await fetch(`${apiUrl}/api/engineering/sessions/${sessionId}/scope`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': authHeader,
+      },
+      body: JSON.stringify({ stepId: 'auto', answer: description }),
+    });
+
+    // Step 3: Start the build with file generation enabled
+    const buildResponse = await fetch(`${apiUrl}/api/engineering/sessions/${sessionId}/build`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': authHeader,
+      },
+      body: JSON.stringify({
+        generateFiles: true, // Tell server to generate actual file contents
+      }),
+    });
+
+    if (!buildResponse.ok) {
+      const error = await buildResponse.json().catch(() => ({}));
+      throw new Error(error.error || 'Failed to start build');
+    }
+
+    spinner.succeed('Build started!');
+    console.log('');
+
+    // Step 4: Stream progress and receive files
+    await streamBuildProgress(apiUrl, authHeader, sessionId, outputDir, options.verbose);
+
+  } catch (error) {
+    spinner.fail('Build failed');
+    const message = error instanceof Error ? error.message : 'Unknown error';
+    console.log(chalk.red(`\n  Error: ${message}\n`));
+    process.exit(1);
+  }
+}
+
+/**
+ * Stream build progress and write files as they're generated
+ */
+async function streamBuildProgress(
+  apiUrl: string,
+  authHeader: string,
+  sessionId: string,
+  outputDir: string,
+  verbose?: boolean
+): Promise<void> {
+  const phases: Map<string, BuildPhase> = new Map();
+  let filesCreated = 0;
+  let currentSpinner: Ora | null = null;
+
+  // Display phase progress
+  function displayPhase(phase: string, status: string, displayName: string): void {
+    const icon = status === 'completed' ? chalk.green('✓') :
+                 status === 'in_progress' ? chalk.blue('●') :
+                 status === 'failed' ? chalk.red('✗') : chalk.gray('○');
+
+    if (status === 'in_progress') {
+      if (currentSpinner) currentSpinner.stop();
+      currentSpinner = ora(`  ${displayName}...`).start();
+    } else if (status === 'completed' && currentSpinner) {
+      currentSpinner.succeed(`  ${displayName}`);
+      currentSpinner = null;
+    } else if (status === 'failed' && currentSpinner) {
+      currentSpinner.fail(`  ${displayName}`);
+      currentSpinner = null;
+    }
+  }
+
+  // Write a file to disk
+  function writeFile(file: FileToCreate): void {
+    const fullPath = join(outputDir, file.path);
+    const dir = dirname(fullPath);
+
+    if (!existsSync(dir)) {
+      mkdirSync(dir, { recursive: true });
+    }
+
+    writeFileSync(fullPath, file.content);
+    filesCreated++;
+
+    if (verbose) {
+      console.log(chalk.gray(`    + ${file.path}`));
+    }
+  }
+
+  // Poll for updates (SSE would be better but this works for CLI)
+  let isComplete = false;
+  let pollCount = 0;
+  const maxPolls = 300; // 10 minutes max (2s intervals)
+
+  while (!isComplete && pollCount < maxPolls) {
+    try {
+      const response = await fetch(`${apiUrl}/api/engineering/sessions/${sessionId}/progress`, {
+        headers: {
+          'Authorization': authHeader,
+        },
+      });
+
+      if (!response.ok) {
+        throw new Error('Failed to get build progress');
+      }
+
+      const data = await response.json();
+      const progress = data.data || data;
+
+      // Update phase displays
+      if (progress.phases) {
+        for (const phase of progress.phases) {
+          const existing = phases.get(phase.phase);
+          if (!existing || existing.status !== phase.status) {
+            phases.set(phase.phase, phase);
+            displayPhase(phase.phase, phase.status, phase.displayName || phase.phase);
+          }
+        }
+      }
+
+      // Write any new files
+      if (progress.newFiles && progress.newFiles.length > 0) {
+        for (const file of progress.newFiles) {
+          writeFile(file);
+        }
+      }
+
+      // Check if build is complete
+      if (progress.status === 'completed' || progress.status === 'failed' || progress.status === 'abandoned') {
+        isComplete = true;
+
+        if (currentSpinner !== null) {
+          (currentSpinner as Ora).stop();
+          currentSpinner = null;
+        }
+
+        if (progress.status === 'completed') {
+          // Write final files if any
+          if (progress.files && progress.files.length > 0) {
+            console.log(chalk.white('\n  Writing project files...\n'));
+            const fileSpinner = ora('  Creating files...').start();
+
+            for (const file of progress.files) {
+              writeFile(file);
+            }
+
+            fileSpinner.succeed(`  Created ${filesCreated} files`);
+          }
+
+          // Success message
+          console.log(chalk.green(`
+  ╔═══════════════════════════════════════════════════════════╗
+  ║                                                           ║
+  ║   ${chalk.bold('✓ Build complete!')}                                     ║
+  ║                                                           ║
+  ╚═══════════════════════════════════════════════════════════╝
+          `));
+
+          console.log(chalk.white('  Next steps:\n'));
+          console.log(chalk.cyan('    1. ') + chalk.white('Install dependencies:'));
+          console.log(chalk.gray('       npm install\n'));
+          console.log(chalk.cyan('    2. ') + chalk.white('Set up your database:'));
+          console.log(chalk.gray('       npx drizzle-kit db:push\n'));
+          console.log(chalk.cyan('    3. ') + chalk.white('Start the dev server:'));
+          console.log(chalk.gray('       npm run dev\n'));
+
+          // Show summary
+          if (progress.summary) {
+            console.log(chalk.gray(`  Summary: ${progress.summary.filesCreated || filesCreated} files, ${progress.summary.tokensUsed || 0} tokens used\n`));
+          }
+
+        } else {
+          console.log(chalk.red(`\n  Build ${progress.status}: ${progress.lastError || 'Unknown error'}\n`));
+        }
+      }
+
+    } catch (error) {
+      if (verbose) {
+        console.log(chalk.gray(`    Poll error: ${error}`));
+      }
+    }
+
+    if (!isComplete) {
+      await new Promise(resolve => setTimeout(resolve, 2000));
+      pollCount++;
+    }
+  }
+
+  if (!isComplete) {
+    if (currentSpinner !== null) {
+      (currentSpinner as Ora).fail('Build timed out');
+    }
+    console.log(chalk.yellow('\n  Build is taking longer than expected.'));
+    console.log(chalk.gray('  Check status: codebakers build-status\n'));
+  }
+}
+
+/**
+ * Check build status
+ */
+export async function buildStatus(): Promise<void> {
+  console.log(chalk.blue('\n  Checking recent builds...\n'));
+
+  const apiUrl = getApiUrl();
+  const apiKey = getApiKey();
+  const trial = getTrialState();
+
+  let authHeader = '';
+  if (apiKey) {
+    authHeader = `Bearer ${apiKey}`;
+  } else if (trial?.trialId) {
+    authHeader = `Trial ${trial.trialId}`;
+  }
+
+  if (!authHeader) {
+    console.log(chalk.red('  Not authenticated. Run: codebakers go\n'));
+    return;
+  }
+
+  try {
+    const response = await fetch(`${apiUrl}/api/engineering/sessions`, {
+      headers: {
+        'Authorization': authHeader,
+      },
+    });
+
+    if (!response.ok) {
+      throw new Error('Failed to get builds');
+    }
+
+    const { data } = await response.json();
+    const sessions = data.sessions || [];
+
+    if (sessions.length === 0) {
+      console.log(chalk.gray('  No builds found. Run: codebakers build "your project"\n'));
+      return;
+    }
+
+    console.log(chalk.white('  Recent builds:\n'));
+    for (const session of sessions.slice(0, 5)) {
+      const statusIcon = session.status === 'completed' ? chalk.green('✓') :
+                        session.status === 'active' ? chalk.blue('●') :
+                        session.status === 'failed' ? chalk.red('✗') : chalk.gray('○');
+
+      console.log(`  ${statusIcon} ${session.projectName}`);
+      console.log(chalk.gray(`    Status: ${session.status} | Phase: ${session.currentPhase} | Progress: ${session.progress}%\n`));
+    }
+
+  } catch (error) {
+    const message = error instanceof Error ? error.message : 'Unknown error';
+    console.log(chalk.red(`  Error: ${message}\n`));
+  }
+}

package/src/index.ts

@@ -23,6 +23,7 @@ import { pushPatterns, pushPatternsInteractive } from './commands/push-patterns.
 import { go } from './commands/go.js';
 import { extend } from './commands/extend.js';
 import { billing } from './commands/billing.js';
+import { build, buildStatus } from './commands/build.js';
 import { getCachedUpdateInfo, setCachedUpdateInfo, getCliVersion, getCachedPatternInfo, setCachedPatternInfo, getApiKey, getApiUrl, getTrialState, hasValidAccess, shouldAttemptCliUpdate, setCliUpdateAttempt, isCliAutoUpdateDisabled } from './config.js';
 import { execSync } from 'child_process';
 import { checkForUpdates } from './lib/api.js';
@@ -353,6 +354,7 @@ function showWelcome(): void {
 
   console.log(chalk.white('  Getting Started:\n'));
   console.log(chalk.cyan('    codebakers go') + chalk.gray('         Start free trial instantly (no signup!)'));
+  console.log(chalk.cyan('    codebakers build') + chalk.gray('      Describe your project → Get working code'));
   console.log(chalk.cyan('    codebakers scaffold') + chalk.gray('   Create a new project from scratch'));
   console.log(chalk.cyan('    codebakers init') + chalk.gray('       Add patterns to existing project\n'));
 
@@ -363,12 +365,12 @@ function showWelcome(): void {
   console.log(chalk.cyan('    codebakers config') + chalk.gray('     View or modify configuration\n'));
 
   console.log(chalk.white('  Examples:\n'));
+  console.log(chalk.gray('    $ ') + chalk.cyan('codebakers build "SaaS for invoicing"'));
+  console.log(chalk.gray('      AI generates full project with auth, payments, dashboard\n'));
   console.log(chalk.gray('    $ ') + chalk.cyan('codebakers scaffold'));
   console.log(chalk.gray('      Create a new Next.js + Supabase + Drizzle project\n'));
   console.log(chalk.gray('    $ ') + chalk.cyan('codebakers generate component Button'));
   console.log(chalk.gray('      Generate a React component with TypeScript\n'));
-  console.log(chalk.gray('    $ ') + chalk.cyan('codebakers g api users'));
-  console.log(chalk.gray('      Generate a Next.js API route with validation\n'));
 
   console.log(chalk.white('  Quality:\n'));
   console.log(chalk.cyan('    codebakers audit') + chalk.gray('      Run automated code quality checks'));
@@ -376,9 +378,9 @@ function showWelcome(): void {
   console.log(chalk.cyan('    codebakers doctor') + chalk.gray('     Check CodeBakers setup\n'));
 
   console.log(chalk.white('  All Commands:\n'));
-  console.log(chalk.gray('    go, extend, billing, setup, scaffold, init, generate, upgrade, status'));
-  console.log(chalk.gray('    audit, heal, doctor, config, login, install, uninstall'));
-  console.log(chalk.gray('    install-hook, uninstall-hook, serve, mcp-config, mcp-uninstall\n'));
+  console.log(chalk.gray('    go, extend, billing, build, build-status, setup, scaffold, init'));
+  console.log(chalk.gray('    generate, upgrade, status, audit, heal, doctor, config'));
+  console.log(chalk.gray('    login, install, uninstall, serve, mcp-config, mcp-uninstall\n'));
 
   console.log(chalk.gray('  Run ') + chalk.cyan('codebakers <command> --help') + chalk.gray(' for more info\n'));
 }
@@ -409,6 +411,23 @@ program
   .description('Manage subscription or upgrade to paid plan')
   .action(billing);
 
+// AI Build command - describe what you want, get working code
+program
+  .command('build [description]')
+  .description('Build a project from description - AI generates actual files')
+  .option('-o, --output <dir>', 'Output directory (default: current directory)')
+  .option('-v, --verbose', 'Show detailed progress')
+  .action((description, options) => build({
+    description,
+    output: options.output,
+    verbose: options.verbose,
+  }));
+
+program
+  .command('build-status')
+  .description('Check status of recent builds')
+  .action(buildStatus);
+
 // Primary command - one-time setup (for paid users)
 program
   .command('setup')