wiggum-cli 0.14.0 → 0.16.0

package/README.md

@@ -9,6 +9,7 @@
 <p align="center">
   <a href="https://www.npmjs.com/package/wiggum-cli"><img src="https://img.shields.io/npm/v/wiggum-cli?color=F8DB27&labelColor=1a1a1a&style=flat-square" alt="npm"></a>
   <a href="https://www.npmjs.com/package/wiggum-cli"><img src="https://img.shields.io/npm/dm/wiggum-cli?color=F8DB27&labelColor=1a1a1a&style=flat-square" alt="downloads"></a>
+  <a href="https://github.com/federiconeri/wiggum-cli/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/federiconeri/wiggum-cli/ci.yml?branch=main&color=F8DB27&labelColor=1a1a1a&style=flat-square&label=CI" alt="CI"></a>
   <a href="https://github.com/federiconeri/wiggum-cli/stargazers"><img src="https://img.shields.io/github/stars/federiconeri/wiggum-cli?color=F8DB27&labelColor=1a1a1a&style=flat-square" alt="stars"></a>
   <a href="https://github.com/federiconeri/wiggum-cli/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT%20+%20Commons%20Clause-F8DB27?labelColor=1a1a1a&style=flat-square" alt="license"></a>
   <img src="https://img.shields.io/node/v/wiggum-cli?color=F8DB27&labelColor=1a1a1a&style=flat-square" alt="node">
@@ -18,16 +19,22 @@
   <a href="#-quick-start">Quick Start</a> ·
   <a href="#-how-it-works">How It Works</a> ·
   <a href="https://wiggum.app">Website</a> ·
+  <a href="https://wiggum.app/blog">Blog</a> ·
+  <a href="https://wiggum.app/pricing">Pricing</a> ·
   <a href="https://github.com/federiconeri/wiggum-cli/issues">Issues</a>
 </p>
 
+<p align="center">
+  <video src="https://github.com/user-attachments/assets/817edf0c-a7aa-418f-bf85-499be520fd94" width="800" controls></video>
+</p>
+
 ---
 
 ## What is Wiggum?
 
 Wiggum is an **AI agent** that plugs into any codebase and makes it ready for autonomous feature development — no configuration, no boilerplate.
 
-It works in two phases. First, **Wiggum itself is the agent**: it scans your project, detects your stack, and runs an AI-guided interview to produce detailed specs, prompts, and scripts — all tailored to your codebase. Then it delegates the actual coding to [Claude Code](https://docs.anthropic.com/en/docs/claude-code), Codex, or any CLI-based coding agent, running an autonomous **implement → test → fix** loop until the feature ships.
+It works in two phases. First, **Wiggum itself is the agent**: it scans your project, detects your stack, and runs an AI-guided interview to produce detailed specs, prompts, and scripts — all tailored to your codebase. Then it delegates the actual coding to [Claude Code](https://docs.anthropic.com/en/docs/claude-code) or any CLI-based coding agent, running an autonomous **implement → test → fix** loop until the feature ships.
 
 Plug & play. Point it at a repo. It figures out the rest.
 
@@ -41,7 +48,7 @@ Plug & play. Point it at a repo. It figures out the rest.
   │  plug&play   prompts     guides    until done        │
   │                            │    │                    │
   └────────────────────────────┘    └────────────────────┘
-       runs in your terminal          Claude Code / Codex
+       runs in your terminal          Claude Code / any agent
 ```
 
 ---
@@ -76,6 +83,12 @@ npx wiggum-cli init
 
 🔁 **Autonomous Coding Loops** — Hands specs to Claude Code (or any agent) and runs implement → test → fix cycles with git worktree isolation.
 
+✨ **Spec Autocomplete** — AI pre-fills spec names from your codebase context when running `/run`.
+
+📥 **Action Inbox** — Review AI decisions inline without breaking your flow. The loop pauses, you approve or redirect, it continues.
+
+📊 **Run Summaries** — See exactly what changed and why after each loop completes, with activity feed and diff stats.
+
 📋 **Tailored Prompts** — Generates prompts, guides, and scripts specific to your stack. Not generic templates — actual context about *your* project.
 
 🔌 **BYOK** — Bring your own API keys. Works with Anthropic, OpenAI, or OpenRouter. Keys stay local, never leave your machine.
@@ -163,7 +176,8 @@ $ wiggum
 │   ├── PROMPT_e2e.md         # E2E testing
 │   ├── PROMPT_verify.md      # Verification
 │   ├── PROMPT_review_manual.md  # PR review (manual - stop at PR)
-│   └── PROMPT_review_auto.md    # PR review (auto - review + merge)
+│   ├── PROMPT_review_auto.md    # PR review (auto - review, no merge)
+│   └── PROMPT_review_merge.md   # PR review (merge - review + auto-merge)
 ├── guides/
 │   ├── AGENTS.md             # Agent instructions (CLAUDE.md)
 │   ├── FRONTEND.md           # Frontend patterns
@@ -218,8 +232,9 @@ Run the autonomous development loop.
 | `--worktree` | Git worktree isolation (parallel features) |
 | `--resume` | Resume an interrupted loop |
 | `--model <model>` | Claude model (`opus`, `sonnet`) |
-| `--max-iterations <n>` | Max iterations (default: 50) |
-| `--max-e2e-attempts <n>` | Max E2E retries (default: 3) |
+| `--max-iterations <n>` | Max iterations (default: 10) |
+| `--max-e2e-attempts <n>` | Max E2E retries (default: 5) |
+| `--review-mode <mode>` | `manual` (stop at PR), `auto` (review, no merge), or `merge` (review + merge). Default: `manual` |
 
 </details>
 
@@ -307,6 +322,16 @@ npm test
 
 ---
 
+## 📖 Learn More
+
+- [What Is Wiggum CLI?](https://wiggum.app/blog/what-is-wiggum-cli) — Overview of the autonomous coding agent
+- [What Is the Ralph Loop?](https://wiggum.app/blog/what-is-the-ralph-loop) — Deep dive into the Ralph loop methodology
+- [Wiggum vs Bash Scripts](https://wiggum.app/blog/wiggum-vs-ralph-wiggum-scripts) — Why spec generation matters
+- [Roadmap](https://wiggum.app/roadmap) — What's coming next
+- [Changelog](https://wiggum.app/changelog) — Release history
+
+---
+
 ## 📄 License
 
 **MIT + Commons Clause** — see [LICENSE](LICENSE).

package/dist/ai/providers.js

@@ -34,21 +34,25 @@ export const KNOWN_API_KEYS = [
  */
 export const AVAILABLE_MODELS = {
     anthropic: [
-        { value: 'claude-opus-4-5-20250514', label: 'Claude Opus 4.5', hint: 'most capable' },
-        { value: 'claude-sonnet-4-5-20250514', label: 'Claude Sonnet 4.5', hint: 'recommended' },
-        { value: 'claude-haiku-4-5-20250514', label: 'Claude Haiku 4.5', hint: 'fastest' },
+        { value: 'claude-opus-4-6', label: 'Claude Opus 4.6', hint: 'most capable' },
+        { value: 'claude-sonnet-4-5-20250929', label: 'Claude Sonnet 4.5', hint: 'recommended' },
+        { value: 'claude-haiku-4-5-20251001', label: 'Claude Haiku 4.5', hint: 'fastest' },
     ],
     openai: [
-        { value: 'gpt-5.1', label: 'GPT-5.1', hint: 'most capable' },
-        { value: 'gpt-5.1-codex-max', label: 'GPT-5.1 Codex Max', hint: 'best for code' },
+        { value: 'gpt-5.2', label: 'GPT-5.2', hint: 'most capable' },
+        { value: 'gpt-5.2-codex', label: 'GPT-5.2 Codex', hint: 'best for code' },
+        { value: 'gpt-5.1', label: 'GPT-5.1', hint: 'previous gen' },
+        { value: 'gpt-5.1-codex-max', label: 'GPT-5.1 Codex Max', hint: 'previous codex' },
         { value: 'gpt-5-mini', label: 'GPT-5 Mini', hint: 'fastest' },
     ],
     openrouter: [
-        { value: 'google/gemini-3-pro-preview', label: 'Gemini 3 Pro', hint: 'Google' },
-        { value: 'google/gemini-3-flash-preview', label: 'Gemini 3 Flash', hint: 'fast' },
-        { value: 'deepseek/deepseek-v3.2', label: 'DeepSeek v3.2', hint: 'efficient' },
-        { value: 'z-ai/glm-4.7', label: 'GLM 4.7', hint: 'Z-AI' },
+        { value: 'google/gemini-3-pro-preview', label: 'Gemini 3 Pro Preview', hint: 'Google' },
+        { value: 'google/gemini-3-flash-preview', label: 'Gemini 3 Flash Preview', hint: 'fast' },
+        { value: 'moonshotai/kimi-k2.5', label: 'Kimi K2.5', hint: 'Moonshot' },
+        { value: 'deepseek/deepseek-v3.2', label: 'DeepSeek V3.2', hint: 'efficient' },
         { value: 'minimax/minimax-m2.1', label: 'MiniMax M2.1', hint: 'MiniMax' },
+        { value: 'z-ai/glm-4.7', label: 'GLM 4.7', hint: 'Z-AI' },
+        { value: 'x-ai/grok-4.1-fast', label: 'Grok 4.1 Fast', hint: 'xAI' },
     ],
 };
 /**
@@ -56,17 +60,17 @@ export const AVAILABLE_MODELS = {
  * Using balanced models for good results
  */
 const DEFAULT_MODELS = {
-    anthropic: 'claude-sonnet-4-5-20250514',
-    openai: 'gpt-5.1',
+    anthropic: 'claude-sonnet-4-5-20250929',
+    openai: 'gpt-5.2',
     openrouter: 'google/gemini-3-pro-preview',
 };
 /**
  * Anthropic shorthand aliases for legacy configs
  */
 const ANTHROPIC_MODEL_ALIASES = {
-    sonnet: 'claude-sonnet-4-5-20250514',
-    opus: 'claude-opus-4-5-20250514',
-    haiku: 'claude-haiku-4-5-20250514',
+    sonnet: 'claude-sonnet-4-5-20250929',
+    opus: 'claude-opus-4-6',
+    haiku: 'claude-haiku-4-5-20251001',
 };
 /**
  * Check if a model id is an Anthropic alias (sonnet/opus/haiku)
@@ -173,6 +177,7 @@ const REASONING_MODELS = [
     'o3', 'o3-mini',
     'gpt-5', 'gpt-5.1', 'gpt-5-mini',
     'gpt-5.1-codex', 'gpt-5.1-codex-max',
+    'gpt-5.2', 'gpt-5.2-codex',
 ];
 /**
  * Check if a model is a reasoning model that doesn't support temperature

package/dist/commands/run.d.ts

@@ -8,7 +8,7 @@ export interface RunOptions {
     model?: string;
     maxIterations?: number;
     maxE2eAttempts?: number;
-    reviewMode?: 'manual' | 'auto';
+    reviewMode?: 'manual' | 'auto' | 'merge';
 }
 /**
  * Run the feature development loop for a specific feature

package/dist/commands/run.js

@@ -113,8 +113,8 @@ export async function runCommand(feature, options = {}) {
     }
     // Resolve and validate reviewMode
     const reviewMode = options.reviewMode ?? config.loop.reviewMode ?? 'manual';
-    if (reviewMode !== 'manual' && reviewMode !== 'auto') {
-        logger.error(`Invalid reviewMode '${reviewMode}'. Allowed values are 'manual' or 'auto'.`);
+    if (reviewMode !== 'manual' && reviewMode !== 'auto' && reviewMode !== 'merge') {
+        logger.error(`Invalid reviewMode '${reviewMode}'. Allowed values are 'manual', 'auto', or 'merge'.`);
         process.exit(1);
     }
     args.push('--review-mode', reviewMode);

package/dist/generator/templates.d.ts

@@ -28,6 +28,7 @@ export interface TemplateVariables {
     typecheckCommand: string;
     formatCommand: string;
     appDir: string;
+    isTui: string;
     aiEntryPoints: string;
     aiKeyDirectories: string;
     aiNamingConventions: string;

package/dist/generator/templates.js

@@ -3,7 +3,7 @@
  * Reads template files with {{variable}} placeholders and substitutes values
  */
 import { readFile, readdir } from 'node:fs/promises';
-import { existsSync } from 'node:fs';
+import { existsSync, readFileSync } from 'node:fs';
 import { join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 const __filename = fileURLToPath(import.meta.url);
@@ -150,6 +150,18 @@ export function extractVariables(scanResult, customVars = {}) {
         existsSync(join(projectRoot, 'src', 'main.ts'))) {
         appDir = 'src';
     }
+    // Detect TUI (Ink) projects
+    let isTui = '';
+    try {
+        const pkgPath = join(projectRoot, 'package.json');
+        if (existsSync(pkgPath)) {
+            const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+            const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
+            if (allDeps['ink'])
+                isTui = 'true';
+        }
+    }
+    catch { /* ignore */ }
     return {
         projectName,
         projectRoot,
@@ -166,6 +178,7 @@ export function extractVariables(scanResult, customVars = {}) {
         stylingVersion,
         stylingVariant,
         appDir,
+        isTui,
         ...commands,
         ...aiData,
         ...customVars,

package/dist/index.d.ts

@@ -1,6 +1,19 @@
+/**
+ * Parsed CLI arguments
+ */
+export interface ParsedArgs {
+    command: string | undefined;
+    positionalArgs: string[];
+    flags: Record<string, string | boolean>;
+}
+/**
+ * Parse CLI arguments into command, positional args, and flags.
+ * Supports: --flag value, --flag=value, boolean flags, short flags (-i, -y, -e, -f, -h, -v).
+ */
+export declare function parseCliArgs(argv: string[]): ParsedArgs;
 /**
  * Main entry point for the Wiggum CLI
- * TUI-first: routes args to appropriate TUI screens
+ * TUI-first: routes args to appropriate TUI screens or CLI commands
  */
 export declare function main(): Promise<void>;
 export { displayHeader } from './utils/header.js';

package/dist/index.js

@@ -1,5 +1,6 @@
 import { createSessionState } from './repl/session-state.js';
 import { hasConfig, loadConfigWithDefaults } from './utils/config.js';
+import { listSpecNames } from './utils/spec-names.js';
 import { AVAILABLE_MODELS, getAvailableProvider, isAnthropicAlias } from './ai/providers.js';
 import { notifyIfUpdateAvailable } from './utils/update-check.js';
 import { renderApp } from './tui/app.js';
@@ -8,6 +9,87 @@ import { loadApiKeysFromEnvLocal } from './utils/env.js';
 import { readFileSync } from 'fs';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
+import { runCommand } from './commands/run.js';
+import { monitorCommand } from './commands/monitor.js';
+import { handleConfigCommand } from './commands/config.js';
+import { isCI } from './utils/ci.js';
+/**
+ * Normalize a flag name: strip '--' prefix and convert kebab-case to camelCase
+ */
+function normalizeFlagName(flag) {
+    return flag.replace(/^--/, '').replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+}
+/**
+ * Parse CLI arguments into command, positional args, and flags.
+ * Supports: --flag value, --flag=value, boolean flags, short flags (-i, -y, -e, -f, -h, -v).
+ */
+export function parseCliArgs(argv) {
+    const positionalArgs = [];
+    const flags = {};
+    let command;
+    const shortFlags = {
+        '-i': 'interactive',
+        '-y': 'yes',
+        '-e': 'edit',
+        '-f': 'force',
+        '-h': 'help',
+        '-v': 'version',
+    };
+    // Flags that consume the next argument as their value
+    const valueFlagSet = new Set([
+        '--model',
+        '--max-iterations',
+        '--max-e2e-attempts',
+        '--interval',
+        '--provider',
+        '--review-mode',
+    ]);
+    let i = 0;
+    while (i < argv.length) {
+        const arg = argv[i];
+        if (arg in shortFlags) {
+            flags[shortFlags[arg]] = true;
+            i++;
+            continue;
+        }
+        if (arg.startsWith('--') && arg.includes('=')) {
+            const eqIdx = arg.indexOf('=');
+            const key = normalizeFlagName(arg.slice(0, eqIdx));
+            const value = arg.slice(eqIdx + 1);
+            flags[key] = value;
+            i++;
+            continue;
+        }
+        if (arg.startsWith('--')) {
+            const normalized = normalizeFlagName(arg);
+            if (valueFlagSet.has(arg) && i + 1 < argv.length && !argv[i + 1].startsWith('-')) {
+                flags[normalized] = argv[i + 1];
+                i += 2;
+            }
+            else {
+                flags[normalized] = true;
+                i++;
+            }
+            continue;
+        }
+        if (command === undefined) {
+            command = arg;
+        }
+        else {
+            positionalArgs.push(arg);
+        }
+        i++;
+    }
+    return { command, positionalArgs, flags };
+}
+function parseIntFlag(value, flagName) {
+    const n = parseInt(value, 10);
+    if (Number.isNaN(n)) {
+        console.error(`Error: ${flagName} must be a number, got "${value}"`);
+        process.exit(1);
+    }
+    return n;
+}
 /**
  * Get version from package.json
  */
@@ -28,7 +110,8 @@ function getVersion() {
  * Start Ink TUI mode
  * Called when wiggum is invoked with no arguments or with screen-routing args
  */
-async function startInkTui(initialScreen = 'shell', interviewFeature) {
+async function startInkTui(initialScreen = 'shell', options) {
+    const interviewFeature = options?.interviewFeature;
     const projectRoot = process.cwd();
     const version = getVersion();
     /**
@@ -54,9 +137,14 @@ async function startInkTui(initialScreen = 'shell', interviewFeature) {
                 model = configuredModel;
             }
         }
-        return createSessionState(projectRoot, provider, // May be null if no API key
+        const specsDir = config
+            ? join(projectRoot, config.paths.specs)
+            : join(projectRoot, '.ralph/specs');
+        const specNames = await listSpecNames(specsDir);
+        const state = createSessionState(projectRoot, provider, // May be null if no API key
         model, undefined, // No scan result yet
         config, isInitialized);
+        return { ...state, specNames };
     }
     const initialState = await createCurrentSessionState();
     // Build interview props if starting on interview screen
@@ -69,11 +157,16 @@ async function startInkTui(initialScreen = 'shell', interviewFeature) {
             scanResult: initialState.scanResult,
         }
         : undefined;
+    // Build run props if starting on run/monitor screen
+    const runProps = options?.runFeature
+        ? { featureName: options.runFeature, monitorOnly: options.monitorOnly }
+        : undefined;
     const instance = renderApp({
         screen: initialScreen,
         initialSessionState: initialState,
         version,
         interviewProps,
+        runProps,
         onComplete: (specPath) => {
             // Spec was saved to disk by app.tsx (avoid stdout noise during TUI)
             logger.debug(`Created spec: ${specPath}`);
@@ -87,62 +180,157 @@ async function startInkTui(initialScreen = 'shell', interviewFeature) {
 }
 /**
  * Main entry point for the Wiggum CLI
- * TUI-first: routes args to appropriate TUI screens
+ * TUI-first: routes args to appropriate TUI screens or CLI commands
  */
 export async function main() {
     // Load API keys from .ralph/.env.local before any provider detection
     loadApiKeysFromEnvLocal();
-    const args = process.argv.slice(2);
+    const parsed = parseCliArgs(process.argv.slice(2));
     // Check for updates (non-blocking, fails silently)
     await notifyIfUpdateAvailable();
-    // No args = start with shell
-    if (args.length === 0) {
+    // Handle --help / -h
+    if (parsed.flags.help) {
+        console.log(`
+Wiggum CLI - AI-powered feature development assistant
+
+Usage:
+  wiggum                    Start interactive TUI
+  wiggum init               Initialize project (TUI)
+  wiggum new <name>         Create new feature spec (TUI)
+  wiggum run <feature>      Run feature development loop
+  wiggum monitor <feature>  Monitor a running feature loop
+  wiggum config [args...]   Manage API keys and settings
+
+Options for run:
+  --worktree                Use git worktree isolation
+  --resume                  Resume from last checkpoint
+  --model <model>           AI model to use
+  --max-iterations <n>      Maximum loop iterations
+  --max-e2e-attempts <n>    Maximum E2E test attempts
+  --review-mode <mode>      Review mode: manual, auto, merge
+
+Options for monitor:
+  --interval <seconds>      Refresh interval (default: 5)
+  --bash                    Use bash monitor script
+  --stream                  Force headless streaming output (skip TUI)
+
+Options for init:
+  --provider <name>         AI provider (anthropic, openai, openrouter)
+  -i, --interactive         Interactive mode
+  -y, --yes                 Accept all defaults
+
+Options for new:
+  --provider <name>         AI provider
+  --model <model>           AI model
+  -e, --edit                Open in editor after creation
+  -f, --force               Overwrite existing spec
+
+In the TUI:
+  /init                     Initialize or reconfigure project
+  /new <name>               Create a new feature specification
+  /run <name>               Run the feature development loop
+  /monitor <name>           Monitor a running feature loop
+  /sync                     Sync context from git history
+  /config [set <svc> <key>] Manage API keys and settings
+  /help                     Show available commands
+  /exit                     Exit the application
+
+Press Esc to cancel any operation.
+`);
+        return;
+    }
+    // Handle --version / -v
+    if (parsed.flags.version) {
+        console.log(getVersion());
+        return;
+    }
+    // No command = start with shell
+    if (!parsed.command) {
         await startInkTui('shell');
         return;
     }
-    // Route commands to TUI screens
-    const command = args[0];
-    switch (command) {
-        case 'init':
-            // Start TUI at init screen
+    switch (parsed.command) {
+        case 'init': {
+            // TODO: pass parsed flags to startInkTui once TUI supports init flags
             await startInkTui('init');
             break;
-        case 'new':
-            // Start TUI at interview screen with feature name
-            const featureName = args[1];
+        }
+        case 'new': {
+            const featureName = parsed.positionalArgs[0];
             if (!featureName) {
-                logger.error('Feature name required. Usage: wiggum new <feature-name>');
+                console.error('Error: <name> is required for "new"');
+                console.error('Usage: wiggum new <name> [--provider <name>] [--model <model>] [-e] [-f]');
                 process.exit(1);
             }
-            await startInkTui('interview', featureName);
+            // TODO: pass parsed flags to startInkTui once TUI supports new flags
+            await startInkTui('interview', { interviewFeature: featureName });
             break;
-        case '--help':
-        case '-h':
-            // Show help
-            console.log(`
-Wiggum CLI - AI-powered feature development assistant
-
-Usage:
-  wiggum              Start interactive TUI
-  wiggum init         Initialize project (TUI)
-  wiggum new <name>   Create new feature spec (TUI)
-
-In the TUI:
-  /init               Initialize or reconfigure project
-  /new <name>         Create a new feature specification
-  /help               Show available commands
-  /exit               Exit the application
-
-Press Esc to cancel any operation.
-`);
-            return;
-        case '--version':
-        case '-v':
-            console.log(getVersion());
-            return;
+        }
+        case 'run': {
+            const feature = parsed.positionalArgs[0];
+            if (!feature) {
+                console.error('Error: <feature> is required for "run"');
+                console.error('Usage: wiggum run <feature> [--worktree] [--resume] [--model <model>] [--max-iterations <n>] [--max-e2e-attempts <n>]');
+                process.exit(1);
+            }
+            const runOptions = {
+                worktree: parsed.flags.worktree === true,
+                resume: parsed.flags.resume === true,
+                model: typeof parsed.flags.model === 'string' ? parsed.flags.model : undefined,
+                maxIterations: typeof parsed.flags.maxIterations === 'string' ? parseIntFlag(parsed.flags.maxIterations, '--max-iterations') : undefined,
+                maxE2eAttempts: typeof parsed.flags.maxE2eAttempts === 'string' ? parseIntFlag(parsed.flags.maxE2eAttempts, '--max-e2e-attempts') : undefined,
+                reviewMode: typeof parsed.flags.reviewMode === 'string' ? parsed.flags.reviewMode : undefined,
+            };
+            await runCommand(feature, runOptions);
+            break;
+        }
+        case 'monitor': {
+            const feature = parsed.positionalArgs[0];
+            if (!feature) {
+                console.error('Error: <feature> is required for "monitor"');
+                console.error('Usage: wiggum monitor <feature> [--interval <seconds>] [--bash] [--stream]');
+                process.exit(1);
+            }
+            const interval = typeof parsed.flags.interval === 'string'
+                ? parseIntFlag(parsed.flags.interval, '--interval')
+                : undefined;
+            // Routing order per spec:
+            // 1. --bash → always use bash script path
+            // 2. --stream → force headless streaming
+            // 3. TTY and not CI → start Ink TUI in monitor-only mode
+            // 4. default → headless streaming monitor
+            if (parsed.flags.bash === true) {
+                await monitorCommand(feature, { bash: true, interval });
+            }
+            else if (parsed.flags.stream === true) {
+                await monitorCommand(feature, { interval });
+            }
+            else if (process.stdout.isTTY && !isCI()) {
+                try {
+                    await startInkTui('run', { runFeature: feature, monitorOnly: true });
+                }
+                catch (err) {
+                    logger.error(`TUI failed to start: ${err instanceof Error ? err.message : String(err)}. Falling back to headless monitor.`);
+                    await monitorCommand(feature, { interval });
+                }
+            }
+            else {
+                await monitorCommand(feature, { interval });
+            }
+            break;
+        }
+        case 'config': {
+            const provider = getAvailableProvider();
+            const model = provider
+                ? (AVAILABLE_MODELS[provider].find((m) => m.hint?.includes('recommended'))?.value ?? AVAILABLE_MODELS[provider][0].value)
+                : 'sonnet';
+            const state = createSessionState(process.cwd(), provider, model);
+            await handleConfigCommand(parsed.positionalArgs, state);
+            break;
+        }
         default:
             // Unknown command - start TUI at shell
-            logger.warn(`Unknown command: ${command}. Starting TUI...`);
+            logger.warn(`Unknown command: ${parsed.command}. Starting TUI...`);
             await startInkTui('shell');
     }
 }

package/dist/repl/session-state.d.ts

@@ -25,6 +25,8 @@ export interface SessionState {
     conversationContext?: string;
     /** Whether /init has been run in this session */
     initialized: boolean;
+    /** Cached spec names from the configured specs directory */
+    specNames?: string[];
 }
 /**
  * Create a new session state

package/dist/templates/config/ralph.config.cjs.tmpl

@@ -34,6 +34,6 @@ module.exports = {
     maxE2eAttempts: 5,
     defaultModel: 'sonnet',
     planningModel: 'opus',
-    reviewMode: 'manual', // 'manual' = stop at PR, 'auto' = review + auto-merge
+    reviewMode: 'manual', // 'manual' = stop at PR, 'auto' = review (no merge), 'merge' = review + auto-merge
   },
 };