wiggum-cli 0.8.0 → 0.9.0

package/dist/tui/screens/WelcomeScreen.d.ts

@@ -0,0 +1,45 @@
+/**
+ * WelcomeScreen - Dexter-inspired welcome screen
+ *
+ * Displays the Wiggum CLI banner, version, and current model info.
+ * Press Enter to continue to the main shell.
+ */
+import React from 'react';
+import type { AIProvider } from '../../ai/providers.js';
+/**
+ * Props for WelcomeScreen component
+ */
+export interface WelcomeScreenProps {
+    /** Current AI provider */
+    provider: AIProvider | null;
+    /** Current model ID */
+    model: string;
+    /** CLI version */
+    version: string;
+    /** Whether the project is initialized */
+    isInitialized: boolean;
+    /** Called when user presses Enter to continue */
+    onContinue: () => void;
+}
+/**
+ * WelcomeScreen component
+ *
+ * Displays a Dexter-inspired welcome screen with:
+ * - ASCII art banner
+ * - Version info
+ * - Current model configuration
+ * - Instructions to continue
+ *
+ * @example
+ * ```tsx
+ * <WelcomeScreen
+ *   provider="anthropic"
+ *   model="sonnet"
+ *   version="0.8.0"
+ *   isInitialized={true}
+ *   onContinue={() => navigate('shell')}
+ * />
+ * ```
+ */
+export declare function WelcomeScreen({ provider, model, version, isInitialized, onContinue, }: WelcomeScreenProps): React.ReactElement;
+//# sourceMappingURL=WelcomeScreen.d.ts.map

package/dist/tui/screens/WelcomeScreen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WelcomeScreen.d.ts","sourceRoot":"","sources":["../../../src/tui/screens/WelcomeScreen.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAA8B,MAAM,OAAO,CAAC;AAInD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,QAAQ,EAAE,UAAU,GAAG,IAAI,CAAC;IAC5B,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,aAAa,EAAE,OAAO,CAAC;IACvB,iDAAiD;IACjD,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AASD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,KAAK,EACL,OAAO,EACP,aAAa,EACb,UAAU,GACX,EAAE,kBAAkB,GAAG,KAAK,CAAC,YAAY,CA8EzC"}

package/dist/tui/screens/WelcomeScreen.js

@@ -0,0 +1,56 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * WelcomeScreen - Dexter-inspired welcome screen
+ *
+ * Displays the Wiggum CLI banner, version, and current model info.
+ * Press Enter to continue to the main shell.
+ */
+import { useState, useEffect } from 'react';
+import { Box, Text, useInput } from 'ink';
+import { WiggumBanner } from '../components/WiggumBanner.js';
+import { colors } from '../theme.js';
+/**
+ * Get version from package.json (client-side compatible)
+ */
+function getVersionDisplay(version) {
+    return version || '0.5.0';
+}
+/**
+ * WelcomeScreen component
+ *
+ * Displays a Dexter-inspired welcome screen with:
+ * - ASCII art banner
+ * - Version info
+ * - Current model configuration
+ * - Instructions to continue
+ *
+ * @example
+ * ```tsx
+ * <WelcomeScreen
+ *   provider="anthropic"
+ *   model="sonnet"
+ *   version="0.8.0"
+ *   isInitialized={true}
+ *   onContinue={() => navigate('shell')}
+ * />
+ * ```
+ */
+export function WelcomeScreen({ provider, model, version, isInitialized, onContinue, }) {
+    const [blinkVisible, setBlinkVisible] = useState(true);
+    // Blink effect for "Press Enter"
+    useEffect(() => {
+        const interval = setInterval(() => {
+            setBlinkVisible((v) => !v);
+        }, 800);
+        return () => clearInterval(interval);
+    }, []);
+    // Handle Enter key to continue
+    useInput((input, key) => {
+        if (key.return) {
+            onContinue();
+        }
+    });
+    const versionDisplay = getVersionDisplay(version);
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsx(WiggumBanner, {}), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: colors.brown, children: "Your AI assistant for feature development" }) }), _jsxs(Box, { marginTop: 1, children: [_jsx(Text, { dimColor: true, children: "Version " }), _jsx(Text, { color: colors.pink, children: versionDisplay })] }), _jsxs(Box, { marginTop: 1, children: [_jsx(Text, { dimColor: true, children: "Model: " }), provider ? (_jsxs(Text, { color: colors.blue, children: [provider, "/", model] })) : (_jsx(Text, { color: colors.orange, children: "Not configured (run /init)" }))] }), _jsxs(Box, { marginTop: 1, children: [_jsx(Text, { dimColor: true, children: "Project: " }), isInitialized ? (_jsx(Text, { color: colors.green, children: "Initialized" })) : (_jsx(Text, { color: colors.orange, children: "Not initialized" }))] }), _jsxs(Box, { marginTop: 2, flexDirection: "column", children: [_jsx(Text, { dimColor: true, children: "Tips:" }), _jsx(Text, { dimColor: true, children: "  /init    - Initialize or reconfigure this project" }), _jsx(Text, { dimColor: true, children: "  /new     - Create a new feature specification" }), _jsx(Text, { dimColor: true, children: "  /help    - Show all available commands" })] }), _jsx(Box, { marginTop: 2, children: _jsx(Text, { color: blinkVisible ? colors.yellow : colors.brown, children: "Press Enter to continue..." }) })] }));
+}
+//# sourceMappingURL=WelcomeScreen.js.map

package/dist/tui/screens/WelcomeScreen.js.map

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

package/dist/tui/theme.d.ts

@@ -22,6 +22,10 @@ export declare const colors: {
     readonly white: "#ffffff";
     /** Danger/warnings/errors */
     readonly pink: "#ff81c1";
+    /** Success/completion */
+    readonly green: "#4ade80";
+    /** Warnings/caution */
+    readonly orange: "#fb923c";
 };
 /**
  * Box drawing characters for custom borders

package/dist/tui/theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/tui/theme.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,MAAM;IACjB,oCAAoC;;IAEpC,gDAAgD;;IAEhD,kDAAkD;;IAElD,8BAA8B;;IAE9B,6BAA6B;;CAErB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,GAAG;;;;;;;CAON,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,KAAK;;;;;CAKR,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,KAAK,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,MAAM,CAAC;AAE5C;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAExD"}
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/tui/theme.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,MAAM;IACjB,oCAAoC;;IAEpC,gDAAgD;;IAEhD,kDAAkD;;IAElD,8BAA8B;;IAE9B,6BAA6B;;IAE7B,yBAAyB;;IAEzB,uBAAuB;;CAEf,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,GAAG;;;;;;;CAON,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,KAAK;;;;;CAKR,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,KAAK,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,MAAM,CAAC;AAE5C;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAExD"}

package/dist/tui/theme.js

@@ -22,6 +22,10 @@ export const colors = {
     white: '#ffffff',
     /** Danger/warnings/errors */
     pink: '#ff81c1',
+    /** Success/completion */
+    green: '#4ade80',
+    /** Warnings/caution */
+    orange: '#fb923c',
 };
 /**
  * Box drawing characters for custom borders

package/dist/tui/theme.js.map

@@ -1 +1 @@
-{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/tui/theme.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,oCAAoC;IACpC,IAAI,EAAE,SAAS;IACf,gDAAgD;IAChD,MAAM,EAAE,SAAS;IACjB,kDAAkD;IAClD,KAAK,EAAE,SAAS;IAChB,8BAA8B;IAC9B,KAAK,EAAE,SAAS;IAChB,6BAA6B;IAC7B,IAAI,EAAE,SAAS;CACP,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,OAAO,EAAE,QAAQ;IACjB,QAAQ,EAAE,QAAQ;IAClB,UAAU,EAAE,QAAQ;IACpB,WAAW,EAAE,QAAQ;IACrB,UAAU,EAAE,QAAQ;IACpB,QAAQ,EAAE,QAAQ;CACV,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,OAAO,EAAE,QAAQ,EAAE,IAAI;IACvB,MAAM,EAAE,QAAQ,EAAE,IAAI;IACtB,QAAQ,EAAE,QAAQ,EAAE,IAAI;IACxB,KAAK,EAAE,QAAQ,EAAE,IAAI;CACb,CAAC;AAYX;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAe;IACtC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAmB;IAC9C,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC;AACvB,CAAC"}
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/tui/theme.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,oCAAoC;IACpC,IAAI,EAAE,SAAS;IACf,gDAAgD;IAChD,MAAM,EAAE,SAAS;IACjB,kDAAkD;IAClD,KAAK,EAAE,SAAS;IAChB,8BAA8B;IAC9B,KAAK,EAAE,SAAS;IAChB,6BAA6B;IAC7B,IAAI,EAAE,SAAS;IACf,yBAAyB;IACzB,KAAK,EAAE,SAAS;IAChB,uBAAuB;IACvB,MAAM,EAAE,SAAS;CACT,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,OAAO,EAAE,QAAQ;IACjB,QAAQ,EAAE,QAAQ;IAClB,UAAU,EAAE,QAAQ;IACpB,WAAW,EAAE,QAAQ;IACrB,UAAU,EAAE,QAAQ;IACpB,QAAQ,EAAE,QAAQ;CACV,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,OAAO,EAAE,QAAQ,EAAE,IAAI;IACvB,MAAM,EAAE,QAAQ,EAAE,IAAI;IACtB,QAAQ,EAAE,QAAQ,EAAE,IAAI;IACxB,KAAK,EAAE,QAAQ,EAAE,IAAI;CACb,CAAC;AAYX;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAe;IACtC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAmB;IAC9C,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC;AACvB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wiggum-cli",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "AI-powered feature development loop CLI",
   "type": "module",
   "main": "dist/index.js",

package/src/ai/conversation/conversation-manager.ts

@@ -37,6 +37,11 @@ export interface ConversationContext {
  */
 export type ToolUseCallback = (toolName: string, args: Record<string, unknown>) => void;
 
+/**
+ * Tool result callback for capturing tool completion
+ */
+export type ToolResultCallback = (toolName: string, result: unknown) => void;
+
 /**
  * Conversation manager options
  */
@@ -48,6 +53,8 @@ export interface ConversationManagerOptions {
   tools?: Record<string, Tool>;
   /** Callback when a tool is used */
   onToolUse?: ToolUseCallback;
+  /** Callback when a tool completes with result */
+  onToolResult?: ToolResultCallback;
   /** Maximum tool calling steps (default: 5) */
   maxToolSteps?: number;
 }
@@ -94,6 +101,7 @@ export class ConversationManager {
   private systemPrompt: string;
   private tools?: Record<string, Tool>;
   private onToolUse?: ToolUseCallback;
+  private onToolResult?: ToolResultCallback;
   private maxToolSteps: number;
 
   constructor(options: ConversationManagerOptions) {
@@ -102,6 +110,7 @@ export class ConversationManager {
     this.systemPrompt = options.systemPrompt || this.getDefaultSystemPrompt();
     this.tools = options.tools;
     this.onToolUse = options.onToolUse;
+    this.onToolResult = options.onToolResult;
     this.maxToolSteps = options.maxToolSteps ?? 5;
   }
 
@@ -119,6 +128,13 @@ export class ConversationManager {
     this.onToolUse = callback;
   }
 
+  /**
+   * Set tool result callback
+   */
+  setOnToolResult(callback: ToolResultCallback): void {
+    this.onToolResult = callback;
+  }
+
   /**
    * Update the system prompt
    */
@@ -230,6 +246,12 @@ Be concise but thorough. Focus on understanding the user's needs before proposin
             this.onToolUse(toolCall.toolName, toolCall.input as Record<string, unknown>);
           }
         }
+        // Call onToolResult callback for each tool result
+        if (step.toolResults && this.onToolResult) {
+          for (const toolResult of step.toolResults) {
+            this.onToolResult(toolResult.toolName, toolResult.output);
+          }
+        }
       };
     }
 

package/src/cli.ts

@@ -205,6 +205,7 @@ Dashboard Shows:
     .option('-y, --yes', 'Skip confirmation prompts')
     .option('-f, --force', 'Overwrite existing spec file without prompting')
     .option('--ai', 'Use AI interview to generate the spec')
+    .option('--tui', 'Use Ink TUI for AI interview (with --ai)')
     .option(
       '--provider <name>',
       'AI provider for spec generation (anthropic, openai, openrouter)'
@@ -216,6 +217,7 @@ Dashboard Shows:
 Examples:
   $ wiggum new user-dashboard              Create spec from template
   $ wiggum new user-dashboard --ai         Use AI interview to generate spec
+  $ wiggum new user-dashboard --ai --tui   Use AI with Ink TUI interface
   $ wiggum new user-dashboard --edit       Create and open in editor
   $ wiggum new user-dashboard -e --editor vim  Open in vim
   $ wiggum new user-dashboard --yes        Skip confirmations
@@ -228,6 +230,7 @@ AI Mode (--ai):
   - Gathers context from URLs/files you provide
   - Conducts an interview to understand your requirements
   - Generates a detailed, project-specific specification
+  - Add --tui for a beautiful Ink-based terminal interface
 
 Template Mode (default):
   - Uses a standard template with sections for:
@@ -242,6 +245,7 @@ Template Mode (default):
           yes: options.yes,
           force: options.force,
           ai: options.ai,
+          tui: options.tui,
           provider: options.provider,
           model: options.model,
         };

package/src/commands/new.ts

@@ -15,6 +15,8 @@ import { Scanner, type ScanResult } from '../scanner/index.js';
 import { flushTracing, traced, initTracing } from '../utils/tracing.js';
 import pc from 'picocolors';
 import * as prompts from '@clack/prompts';
+import { renderApp } from '../tui/app.js';
+import { createSessionState } from '../repl/session-state.js';
 
 export interface NewOptions {
   /** Open in editor after creation */
@@ -27,6 +29,8 @@ export interface NewOptions {
   force?: boolean;
   /** Use AI interview to generate spec */
   ai?: boolean;
+  /** Use Ink TUI for AI interview (instead of readline) */
+  tui?: boolean;
   /** AI provider (anthropic, openai, openrouter) */
   provider?: AIProvider;
   /** Model to use for AI generation */
@@ -273,37 +277,85 @@ export async function newCommand(feature: string, options: NewOptions = {}): Pro
       scanResult = await scanner.scan(projectRoot);
     }
 
-    const specGenerator = new SpecGenerator({
-      featureName: feature,
-      projectRoot,
-      provider,
-      model,
-      scanResult,
-    });
-
-    // Initialize tracing BEFORE creating parent span (ensures logger is ready)
-    initTracing();
-
-    const generatedSpec = await traced(
-      async () => {
-        // All AI calls inside run() automatically become child spans
-        return await specGenerator.run();
-      },
-      {
-        name: `generate-spec-${feature}`,
-        type: 'task',
+    // Check if TUI mode is requested
+    if (options.tui) {
+      // Use Ink TUI for interview
+      logger.info('Starting interactive TUI mode...');
+      console.log('');
+
+      // Create session state for TUI
+      const sessionState = createSessionState(
+        projectRoot,
+        provider,
+        model,
+        scanResult,
+        config,
+        true // initialized
+      );
+
+      // Wrap in a promise to get the generated spec
+      const generatedSpec = await new Promise<string | null>((resolve) => {
+        const instance = renderApp({
+          screen: 'interview',
+          initialSessionState: sessionState,
+          interviewProps: {
+            featureName: feature,
+            projectRoot,
+            provider,
+            model,
+            scanResult,
+          },
+          onComplete: (spec) => {
+            instance.unmount();
+            resolve(spec);
+          },
+          onExit: () => {
+            instance.unmount();
+            resolve(null);
+          },
+        });
+      });
+
+      if (!generatedSpec) {
+        logger.info('Spec generation cancelled');
+        return;
       }
-    );
 
-    // Flush any pending Braintrust tracing spans
-    await flushTracing();
+      specContent = generatedSpec;
+    } else {
+      // Use readline-based SpecGenerator
+      const specGenerator = new SpecGenerator({
+        featureName: feature,
+        projectRoot,
+        provider,
+        model,
+        scanResult,
+      });
 
-    if (!generatedSpec) {
-      logger.info('Spec generation cancelled');
-      return;
-    }
+      // Initialize tracing BEFORE creating parent span (ensures logger is ready)
+      initTracing();
+
+      const generatedSpec = await traced(
+        async () => {
+          // All AI calls inside run() automatically become child spans
+          return await specGenerator.run();
+        },
+        {
+          name: `generate-spec-${feature}`,
+          type: 'task',
+        }
+      );
 
-    specContent = generatedSpec;
+      // Flush any pending Braintrust tracing spans
+      await flushTracing();
+
+      if (!generatedSpec) {
+        logger.info('Spec generation cancelled');
+        return;
+      }
+
+      specContent = generatedSpec;
+    }
 
     // Confirm saving (unless --yes)
     if (!options.yes) {

package/src/index.ts

@@ -1,45 +1,124 @@
 import { createCli } from './cli.js';
-import { startRepl, createSessionState } from './repl/index.js';
+import { createSessionState } from './repl/index.js';
 import { hasConfig, loadConfigWithDefaults } from './utils/config.js';
 import { getAvailableProvider } from './ai/providers.js';
-import { displayHeader } from './utils/header.js';
 import { notifyIfUpdateAvailable } from './utils/update-check.js';
+import { renderApp } from './tui/app.js';
+import { runInitWorkflow } from './commands/init.js';
+import { logger } from './utils/logger.js';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import type { Instance } from 'ink';
 
 /**
- * Start REPL-first mode
+ * Get version from package.json
+ */
+function getVersion(): string {
+  try {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = dirname(__filename);
+    const packagePath = join(__dirname, '..', 'package.json');
+    const pkg = JSON.parse(readFileSync(packagePath, 'utf-8'));
+    return pkg.version || '0.8.0';
+  } catch {
+    return '0.8.0';
+  }
+}
+
+/**
+ * Start Ink TUI mode
  * Called when wiggum is invoked with no arguments
  */
-async function startReplFirst(): Promise<void> {
+async function startInkTui(): Promise<void> {
   const projectRoot = process.cwd();
-  const provider = getAvailableProvider();
+  const version = getVersion();
+
+  // Track current Ink instance for init workflow
+  let instance: Instance | null = null;
+  let shouldRestart = false;
 
-  // Display header
-  displayHeader();
+  /**
+   * Create session state based on current project state
+   */
+  async function createCurrentSessionState() {
+    const provider = getAvailableProvider();
+    const isInitialized = hasConfig(projectRoot);
+    let config = null;
 
-  // Check if already initialized
-  const isInitialized = hasConfig(projectRoot);
-  let config = null;
+    if (isInitialized) {
+      config = await loadConfigWithDefaults(projectRoot);
+    }
 
-  if (isInitialized) {
-    config = await loadConfigWithDefaults(projectRoot);
+    return createSessionState(
+      projectRoot,
+      provider, // May be null if no API key
+      'sonnet', // Default model, will be updated after /init
+      undefined, // No scan result yet
+      config,
+      isInitialized
+    );
   }
 
-  // Create initial state (may not have config yet)
-  const initialState = createSessionState(
-    projectRoot,
-    provider, // May be null if no API key
-    'sonnet', // Default model, will be updated after /init
-    undefined, // No scan result yet
-    config,
-    isInitialized
-  );
-
-  await startRepl(initialState);
+  /**
+   * Render the TUI app
+   */
+  async function renderTui(screen: 'welcome' | 'shell' = 'welcome') {
+    const initialState = await createCurrentSessionState();
+
+    instance = renderApp({
+      screen,
+      initialSessionState: initialState,
+      version,
+      onComplete: (specPath) => {
+        // Spec was saved to disk by app.tsx
+        logger.success(`Created spec: ${specPath}`);
+      },
+      onExit: () => {
+        instance?.unmount();
+        if (!shouldRestart) {
+          process.exit(0);
+        }
+      },
+      onRunInit: async () => {
+        // Unmount Ink to run init workflow with readline prompts
+        shouldRestart = true;
+        instance?.unmount();
+
+        // Clear screen for init workflow
+        console.clear();
+
+        try {
+          const result = await runInitWorkflow(projectRoot, {});
+
+          if (result) {
+            logger.success('Initialization complete!');
+            console.log('');
+          } else {
+            logger.info('Initialization cancelled');
+            console.log('');
+          }
+        } catch (error) {
+          logger.error(`Init failed: ${error instanceof Error ? error.message : String(error)}`);
+          console.log('');
+        }
+
+        // Re-render TUI with updated state
+        shouldRestart = false;
+        await renderTui('shell');
+      },
+    });
+
+    await instance.waitUntilExit();
+  }
+
+  // Start with welcome screen
+  await renderTui('welcome');
 }
 
 /**
- * Main entry point for the Ralph CLI
- * REPL-first: no args = start REPL, otherwise use CLI
+ * Main entry point for the Wiggum CLI
+ * TUI-first: no args = start Ink TUI, otherwise use CLI
  */
 export async function main(): Promise<void> {
   const args = process.argv.slice(2);
@@ -47,9 +126,9 @@ export async function main(): Promise<void> {
   // Check for updates (non-blocking, fails silently)
   await notifyIfUpdateAvailable();
 
-  // REPL-first: no args = start REPL
+  // TUI-first: no args = start Ink TUI
   if (args.length === 0) {
-    await startReplFirst();
+    await startInkTui();
     return;
   }
 
@@ -89,3 +168,6 @@ export type {
   WriteOptions,
   WriteSummary,
 } from './generator/index.js';
+
+// Export TUI components for programmatic use
+export { renderApp, type RenderAppOptions, type AppScreen } from './tui/app.js';