wiggum-cli 0.17.2 → 0.18.3

package/dist/templates/scripts/loop.sh.tmpl

@@ -12,12 +12,15 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 if [ -f "$SCRIPT_DIR/../ralph.config.cjs" ]; then
     PROMPTS_DIR=$(node -e "console.log(require('$SCRIPT_DIR/../ralph.config.cjs').paths?.prompts || '.ralph/prompts')" 2>/dev/null || echo ".ralph/prompts")
     DEFAULT_MODEL=$(node -e "console.log(require('$SCRIPT_DIR/../ralph.config.cjs').loop?.defaultModel || 'sonnet')" 2>/dev/null || echo "sonnet")
+    CLAUDE_PERMISSION_MODE=$(node -e "console.log(require('$SCRIPT_DIR/../ralph.config.cjs').loop?.claudePermissionMode || 'default')" 2>/dev/null || echo "default")
 elif [ -f "$SCRIPT_DIR/../../ralph.config.cjs" ]; then
     PROMPTS_DIR=$(node -e "console.log(require('$SCRIPT_DIR/../../ralph.config.cjs').paths?.prompts || '.ralph/prompts')" 2>/dev/null || echo ".ralph/prompts")
     DEFAULT_MODEL=$(node -e "console.log(require('$SCRIPT_DIR/../../ralph.config.cjs').loop?.defaultModel || 'sonnet')" 2>/dev/null || echo "sonnet")
+    CLAUDE_PERMISSION_MODE=$(node -e "console.log(require('$SCRIPT_DIR/../../ralph.config.cjs').loop?.claudePermissionMode || 'default')" 2>/dev/null || echo "default")
 else
     PROMPTS_DIR=".ralph/prompts"
     DEFAULT_MODEL="sonnet"
+    CLAUDE_PERMISSION_MODE="default"
 fi
 
 # Navigate to project root
@@ -31,6 +34,7 @@ ITERATION=0
 echo "Starting Ralph loop"
 echo "  Prompt: $PROMPT_FILE"
 echo "  Model: $MODEL"
+echo "  Claude permission mode: $CLAUDE_PERMISSION_MODE"
 echo "  Max iterations: $MAX_ITERATIONS (0 = infinite)"
 echo "Press Ctrl+C to stop"
 echo ""
@@ -50,7 +54,7 @@ while true; do
     ITERATION=$((ITERATION + 1))
     echo "======================== ITERATION $ITERATION ========================"
 
-    cat "$PROMPT_FILE" | claude -p --dangerously-skip-permissions --model "$MODEL"
+    cat "$PROMPT_FILE" | claude -p --permission-mode "$CLAUDE_PERMISSION_MODE" --model "$MODEL"
 
     echo ""
     sleep 2

package/dist/templates/scripts/ralph-monitor.sh.tmpl

@@ -73,8 +73,6 @@ detect_phase() {
         echo "Planning"
     elif pgrep -f "PROMPT_e2e.md" > /dev/null 2>&1; then
         echo "E2E Testing"
-    elif pgrep -f "PROMPT_verify.md" > /dev/null 2>&1; then
-        echo "Verification"
     elif pgrep -f "PROMPT_review_manual.md" > /dev/null 2>&1; then
         echo "PR Review"
     elif pgrep -f "PROMPT_review_auto.md" > /dev/null 2>&1; then

package/dist/tui/app.d.ts

@@ -55,7 +55,11 @@ export interface RunAppProps {
     /** If true, opens in monitor-only (read-only) mode — no loop is spawned */
     monitorOnly?: boolean;
     /** Review mode override */
-    reviewMode?: 'manual' | 'auto';
+    reviewMode?: 'manual' | 'auto' | 'merge';
+    /** Implementation CLI override */
+    cli?: 'claude' | 'codex';
+    /** Review CLI override */
+    reviewCli?: 'claude' | 'codex';
 }
 /**
  * Props for the main App component

package/dist/tui/app.js

@@ -34,7 +34,13 @@ interviewProps, runProps, agentProps, onComplete, onExit, }) {
     const [currentScreen, setCurrentScreen] = useState(initialScreen);
     const [screenProps, setScreenProps] = useState(() => {
         if (initialScreen === 'run' && runProps) {
-            return { featureName: runProps.featureName, monitorOnly: runProps.monitorOnly, reviewMode: runProps.reviewMode };
+            return {
+                featureName: runProps.featureName,
+                monitorOnly: runProps.monitorOnly,
+                reviewMode: runProps.reviewMode,
+                cli: runProps.cli,
+                reviewCli: runProps.reviewCli,
+            };
         }
         if (interviewProps) {
             return { featureName: interviewProps.featureName };
@@ -49,9 +55,18 @@ interviewProps, runProps, agentProps, onComplete, onExit, }) {
     const columns = stdout?.columns ?? 80;
     const rows = stdout?.rows ?? 24;
     const compact = rows < 20 || columns < 60;
+    const agentModelOverride = currentScreen === 'agent'
+        ? (typeof screenProps?.modelOverride === 'string' ? screenProps.modelOverride : agentProps?.modelOverride)
+        : undefined;
+    const agentProviderOverride = currentScreen === 'agent'
+        ? (sessionState.config?.agent.defaultProvider || sessionState.provider || undefined)
+        : undefined;
+    const effectiveAgentModel = currentScreen === 'agent'
+        ? (agentModelOverride || sessionState.config?.agent.defaultModel || sessionState.model)
+        : undefined;
     // Shared header element - includes columns/rows in deps so the
     // header subtree re-renders on terminal resize (banner auto-compacts)
-    const headerElement = useMemo(() => (_jsx(HeaderContent, { version: version, sessionState: sessionState, backgroundRuns: backgroundRuns, compact: compact })), [version, sessionState, backgroundRuns, compact, columns, rows]);
+    const headerElement = useMemo(() => (_jsx(HeaderContent, { version: version, sessionState: sessionState, providerOverride: agentProviderOverride, modelOverride: effectiveAgentModel, backgroundRuns: backgroundRuns, compact: compact })), [version, sessionState, agentProviderOverride, effectiveAgentModel, backgroundRuns, compact, columns, rows]);
     /**
      * Navigate to a different screen
      */
@@ -211,7 +226,9 @@ interviewProps, runProps, agentProps, onComplete, onExit, }) {
                 return null; // useEffect will redirect to shell
             }
             const reviewMode = screenProps?.reviewMode;
-            return (_jsx(RunScreen, { header: headerElement, featureName: featureName, projectRoot: sessionState.projectRoot, sessionState: sessionState, monitorOnly: monitorOnly, reviewMode: reviewMode, onComplete: handleRunComplete, onBackground: handleRunBackground, onCancel: () => navigate('shell') }));
+            const cli = screenProps?.cli;
+            const reviewCli = screenProps?.reviewCli;
+            return (_jsx(RunScreen, { header: headerElement, featureName: featureName, projectRoot: sessionState.projectRoot, sessionState: sessionState, monitorOnly: monitorOnly, reviewMode: reviewMode, cli: cli, reviewCli: reviewCli, onComplete: handleRunComplete, onBackground: handleRunBackground, onCancel: () => navigate('shell') }));
         }
         case 'agent': {
             // Merge CLI-provided agentProps with navigation screenProps (from /agent command)
@@ -219,6 +236,8 @@ interviewProps, runProps, agentProps, onComplete, onExit, }) {
                 ...agentProps,
                 ...(screenProps?.dryRun != null ? { dryRun: screenProps.dryRun } : {}),
                 ...(screenProps?.maxItems != null ? { maxItems: screenProps.maxItems } : {}),
+                ...(screenProps?.maxSteps != null ? { maxSteps: screenProps.maxSteps } : {}),
+                ...(screenProps?.labels != null ? { labels: screenProps.labels } : {}),
                 ...(screenProps?.reviewMode != null ? { reviewMode: screenProps.reviewMode } : {}),
                 ...(screenProps?.issues != null ? { issues: screenProps.issues } : {}),
             };

package/dist/tui/components/HeaderContent.d.ts

@@ -15,6 +15,9 @@ export interface HeaderContentProps {
     version: string;
     /** Current session state */
     sessionState: SessionState;
+    /** Optional provider/model display overrides for screen-specific modes */
+    providerOverride?: string;
+    modelOverride?: string;
     /** Background runs (only active ones are displayed) */
     backgroundRuns?: BackgroundRun[];
     /** Use compact banner for small terminals */
@@ -25,4 +28,4 @@ export interface HeaderContentProps {
  *
  * Renders the banner and status row for the AppShell header zone.
  */
-export declare function HeaderContent({ version, sessionState, backgroundRuns, compact, }: HeaderContentProps): React.ReactElement;
+export declare function HeaderContent({ version, sessionState, providerOverride, modelOverride, backgroundRuns, compact, }: HeaderContentProps): React.ReactElement;

package/dist/tui/components/HeaderContent.js

@@ -7,10 +7,12 @@ import { colors, theme } from '../theme.js';
  *
  * Renders the banner and status row for the AppShell header zone.
  */
-export function HeaderContent({ version, sessionState, backgroundRuns, compact = false, }) {
+export function HeaderContent({ version, sessionState, providerOverride, modelOverride, backgroundRuns, compact = false, }) {
     const activeRuns = backgroundRuns?.filter((r) => !r.completed && !r.pollError) ?? [];
     const errorRuns = backgroundRuns?.filter((r) => r.pollError) ?? [];
-    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [_jsx(WiggumBanner, { compact: compact }), _jsxs(Box, { flexDirection: "row", children: [_jsxs(Text, { color: colors.pink, children: ["v", version] }), _jsx(Text, { dimColor: true, children: theme.statusLine.separator }), sessionState.provider ? (_jsxs(Text, { color: colors.blue, children: [sessionState.provider, "/", sessionState.model] })) : (_jsx(Text, { color: colors.orange, children: "not configured" })), _jsx(Text, { dimColor: true, children: theme.statusLine.separator }), _jsx(Text, { color: sessionState.initialized ? colors.green : colors.orange, children: sessionState.initialized ? 'Ready' : 'Not initialized' }), activeRuns.length > 0 && (_jsxs(_Fragment, { children: [_jsx(Text, { dimColor: true, children: theme.statusLine.separator }), _jsxs(Text, { color: colors.green, children: [theme.chars.bulletLarge, " ", activeRuns[0].featureName, activeRuns[0].lastStatus.iteration > 0
+    const provider = providerOverride || sessionState.provider;
+    const model = modelOverride || sessionState.model;
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [_jsx(WiggumBanner, { compact: compact }), _jsxs(Box, { flexDirection: "row", children: [_jsxs(Text, { color: colors.pink, children: ["v", version] }), _jsx(Text, { dimColor: true, children: theme.statusLine.separator }), provider ? (_jsxs(Text, { color: colors.blue, children: [provider, "/", model] })) : (_jsx(Text, { color: colors.orange, children: "not configured" })), _jsx(Text, { dimColor: true, children: theme.statusLine.separator }), _jsx(Text, { color: sessionState.initialized ? colors.green : colors.orange, children: sessionState.initialized ? 'Ready' : 'Not initialized' }), activeRuns.length > 0 && (_jsxs(_Fragment, { children: [_jsx(Text, { dimColor: true, children: theme.statusLine.separator }), _jsxs(Text, { color: colors.green, children: [theme.chars.bulletLarge, " ", activeRuns[0].featureName, activeRuns[0].lastStatus.iteration > 0
                                         ? ` (${activeRuns[0].lastStatus.iteration}/${activeRuns[0].lastStatus.maxIterations || '?'})`
                                         : ''] }), activeRuns.length > 1 && (_jsxs(Text, { dimColor: true, children: [" +", activeRuns.length - 1, " more"] }))] })), errorRuns.length > 0 && (_jsxs(_Fragment, { children: [_jsx(Text, { dimColor: true, children: theme.statusLine.separator }), _jsxs(Text, { color: colors.orange, children: [theme.chars.bullet, " ", errorRuns[0].featureName, " (status unknown)"] })] }))] })] }));
 }

package/dist/tui/hooks/useAgentOrchestrator.d.ts

@@ -6,7 +6,7 @@
  * calls into structured state (active issue, queue, completed, log).
  * Exposes an abort() function for clean shutdown on q/Esc.
  */
-import type { AgentIssueState, AgentLogEntry, ReviewMode } from '../../agent/types.js';
+import type { AgentOrchestratorEvent, AgentIssueState, AgentLogEntry, ReviewMode } from '../../agent/types.js';
 import { type LoopStatus, type TaskCounts, type ActivityEvent } from '../utils/loop-status.js';
 import { type CommitLogEntry } from '../utils/git-summary.js';
 export type AgentStatus = 'idle' | 'running' | 'complete' | 'error';
@@ -38,4 +38,5 @@ export interface UseAgentOrchestratorResult {
     error: string | null;
     abort: () => void;
 }
+export declare function applyOrchestratorEvent(event: AgentOrchestratorEvent, setActiveIssue: React.Dispatch<React.SetStateAction<AgentIssueState | null>>, setQueue: React.Dispatch<React.SetStateAction<AgentIssueState[]>>, setCompleted: React.Dispatch<React.SetStateAction<AgentIssueState[]>>, setLogEntries: React.Dispatch<React.SetStateAction<AgentLogEntry[]>>, completedIssuesRef: React.MutableRefObject<Set<number>>): void;
 export declare function useAgentOrchestrator(options: UseAgentOrchestratorOptions): UseAgentOrchestratorResult;

package/dist/tui/hooks/useAgentOrchestrator.js

@@ -10,7 +10,7 @@ import { useState, useEffect, useRef, useCallback } from 'react';
 import { resolveAgentEnv } from '../../agent/resolve-config.js';
 import { createAgentOrchestrator, } from '../../agent/orchestrator.js';
 import { initTracing, flushTracing } from '../../utils/tracing.js';
-import { readCurrentPhase, readLoopStatus, parseLoopLog, parsePhaseChanges, parseImplementationPlan, getLoopLogPath, shouldSkipLine, getGitBranch, } from '../utils/loop-status.js';
+import { readCurrentPhase, readLoopStatus, parseLoopLogDelta, parsePhaseChanges, parseImplementationPlan, getLoopLogPath, shouldSkipLine, getGitBranch, } from '../utils/loop-status.js';
 import { getRecentCommits } from '../utils/git-summary.js';
 const MAX_LOG_ENTRIES = 500;
 function now() {
@@ -27,6 +27,11 @@ function appendLog(prev, message, level = 'info') {
     }
     return next;
 }
+function shouldReopenCompletedIssue(issue) {
+    return issue.recommendation === 'resume_pr_phase'
+        || issue.recommendation === 'pr_merged'
+        || issue.recommendation === 'linked_pr_merged';
+}
 /**
  * Interpret a tool call name and extract relevant info from args/results
  * to drive TUI state transitions.
@@ -188,15 +193,6 @@ function interpretToolCalls(event, setActiveIssue, setQueue, setCompleted, setLo
                 break;
         }
     }
-    // Detect whether listIssues was called with a label filter (e.g. P0 check)
-    // so we don't overwrite the queue with a filtered subset.
-    const listIssuesHasLabelFilter = event.toolCalls.some((tc) => {
-        if (tc.toolName !== 'listIssues')
-            return false;
-        const args = tc.args;
-        const labels = args?.labels;
-        return Array.isArray(labels) && labels.length > 0;
-    });
     // Process tool results for additional state updates
     for (const tr of event.toolResults) {
         const result = tr.result;
@@ -204,30 +200,10 @@ function interpretToolCalls(event, setActiveIssue, setQueue, setCompleted, setLo
             case 'listIssues': {
                 const issues = (result?.issues ?? result);
                 if (Array.isArray(issues)) {
-                    // Only update queue from unfiltered listIssues calls (full backlog scan).
-                    // Filtered calls (e.g. labels: ["bug"]) are P0/blocker checks — not the backlog.
-                    if (!listIssuesHasLabelFilter) {
-                        const queueItems = issues.map((issue) => ({
-                            issueNumber: (issue.number ?? issue.issueNumber),
-                            title: issue.title ?? `Issue #${issue.number ?? issue.issueNumber}`,
-                            labels: Array.isArray(issue.labels) ? issue.labels : [],
-                            phase: 'idle',
-                        }));
-                        setQueue(queueItems);
-                    }
                     setLogEntries((prev) => appendLog(prev, `Found ${issues.length} issue(s) in backlog`));
                 }
                 break;
             }
-            case 'readIssue': {
-                // Update queue entry titles from full issue data (agent reads many issues during triage)
-                const issueNumber = (result?.number ?? result?.issueNumber);
-                const title = result?.title;
-                if (issueNumber && title) {
-                    setQueue((prev) => prev.map((i) => i.issueNumber === issueNumber ? { ...i, title } : i));
-                }
-                break;
-            }
             case 'checkLoopStatus': {
                 const iteration = (result?.iteration ?? result?.currentIteration);
                 if (iteration != null) {
@@ -240,6 +216,78 @@ function interpretToolCalls(event, setActiveIssue, setQueue, setCompleted, setLo
         }
     }
 }
+export function applyOrchestratorEvent(event, setActiveIssue, setQueue, setCompleted, setLogEntries, completedIssuesRef) {
+    switch (event.type) {
+        case 'scope_expanded':
+            setLogEntries((prev) => appendLog(prev, `Expanded scope with ${event.expansions.map(expansion => `#${expansion.issueNumber}`).join(', ')}`));
+            break;
+        case 'backlog_progress':
+            setLogEntries((prev) => appendLog(prev, event.message));
+            break;
+        case 'backlog_timing':
+            setLogEntries((prev) => appendLog(prev, `${event.phase} took ${event.durationMs}ms${event.count != null ? ` (${event.count})` : ''}`));
+            break;
+        case 'backlog_scanned':
+            setLogEntries((prev) => appendLog(prev, `Scanned ${event.total} backlog issue(s)`));
+            break;
+        case 'candidate_enriched':
+            setLogEntries((prev) => appendLog(prev, `Enriched #${event.issue.issueNumber}: ${event.issue.title}`));
+            break;
+        case 'dependencies_inferred':
+            if (event.edges.length > 0) {
+                setLogEntries((prev) => appendLog(prev, `Inferred ${event.edges.length} dependency edge(s) for #${event.issueNumber}`));
+            }
+            break;
+        case 'queue_ranked':
+            {
+                const resumedIssueNumbers = new Set(event.queue
+                    .filter(shouldReopenCompletedIssue)
+                    .map(issue => issue.issueNumber));
+                if (resumedIssueNumbers.size > 0) {
+                    for (const issueNumber of resumedIssueNumbers) {
+                        completedIssuesRef.current.delete(issueNumber);
+                    }
+                    setCompleted((prev) => prev.filter((issue) => !resumedIssueNumbers.has(issue.issueNumber)));
+                }
+                setQueue(event.queue.filter((issue) => !completedIssuesRef.current.has(issue.issueNumber)));
+            }
+            break;
+        case 'task_selected':
+            completedIssuesRef.current.delete(event.issue.issueNumber);
+            setCompleted((prev) => prev.filter((issue) => issue.issueNumber !== event.issue.issueNumber));
+            setActiveIssue({ ...event.issue, phase: 'planning' });
+            setQueue((prev) => prev.filter((issue) => issue.issueNumber !== event.issue.issueNumber));
+            setLogEntries((prev) => appendLog(prev, `Selected #${event.issue.issueNumber}: ${event.issue.title}`));
+            break;
+        case 'task_blocked':
+            setLogEntries((prev) => appendLog(prev, `Blocked #${event.issue.issueNumber}: ${event.issue.blockedBy?.[0]?.reason ?? event.issue.actionability ?? 'blocked'}`, 'warn'));
+            break;
+        case 'task_started':
+            setActiveIssue((prev) => ({ ...(prev ?? event.issue), ...event.issue }));
+            setLogEntries((prev) => appendLog(prev, `Started #${event.issue.issueNumber}`));
+            break;
+        case 'task_completed':
+            setCompleted((prev) => {
+                const filtered = prev.filter((issue) => issue.issueNumber !== event.issue.issueNumber);
+                return [...filtered, {
+                        ...event.issue,
+                        error: event.outcome === 'failure' ? 'failed' : event.issue.error,
+                    }];
+            });
+            if (event.outcome === 'success' || event.outcome === 'skipped') {
+                completedIssuesRef.current.add(event.issue.issueNumber);
+            }
+            else {
+                completedIssuesRef.current.delete(event.issue.issueNumber);
+            }
+            setQueue((prev) => prev.filter((issue) => issue.issueNumber !== event.issue.issueNumber));
+            setActiveIssue((prev) => prev?.issueNumber === event.issue.issueNumber ? null : prev);
+            setLogEntries((prev) => appendLog(prev, `${event.outcome === 'failure' ? 'Failed' : event.outcome === 'partial' ? 'Paused' : 'Completed'} #${event.issue.issueNumber} (${event.outcome})`, event.outcome === 'failure' ? 'error' : event.outcome === 'partial' ? 'warn' : 'success'));
+            break;
+        default:
+            break;
+    }
+}
 export function useAgentOrchestrator(options) {
     const [status, setStatus] = useState('idle');
     const [activeIssue, setActiveIssue] = useState(null);
@@ -253,6 +301,7 @@ export function useAgentOrchestrator(options) {
     const pollingRef = useRef(null);
     const ranLoopRef = useRef(new Set());
     const activeIssueRef = useRef(null);
+    const completedIssuesRef = useRef(new Set());
     // Keep ref in sync for use inside polling callback
     useEffect(() => { activeIssueRef.current = activeIssue; }, [activeIssue]);
     const stopLoopPolling = useCallback(() => {
@@ -268,7 +317,7 @@ export function useAgentOrchestrator(options) {
         const state = {
             featureName,
             interval: null,
-            lastLogTimestamp: undefined,
+            lastLogCursor: 0,
             lastPhases: undefined,
         };
         // Accumulated activity events across polls
@@ -304,9 +353,10 @@ export function useAgentOrchestrator(options) {
             const recentCommits = getRecentCommits(options.projectRoot, 3);
             // Parse loop log for new events
             const logPath = getLoopLogPath(featureName);
-            const logEvents = parseLoopLog(logPath, state.lastLogTimestamp);
+            const logDelta = parseLoopLogDelta(logPath, state.lastLogCursor);
+            const logEvents = logDelta.events;
+            state.lastLogCursor = logDelta.nextCursor;
             if (logEvents.length > 0) {
-                state.lastLogTimestamp = logEvents[logEvents.length - 1].timestamp + 1;
                 activityEventsAcc.push(...logEvents);
                 if (activityEventsAcc.length > MAX_ACTIVITY) {
                     activityEventsAcc.splice(0, activityEventsAcc.length - MAX_ACTIVITY);
@@ -390,6 +440,9 @@ export function useAgentOrchestrator(options) {
                     onStepUpdate: (event) => {
                         interpretToolCalls(event, setActiveIssue, setQueue, setCompleted, setLogEntries, pollingRef, stopLoopPolling, ranLoopRef, activeIssueRef);
                     },
+                    onOrchestratorEvent: (event) => {
+                        applyOrchestratorEvent(event, setActiveIssue, setQueue, setCompleted, setLogEntries, completedIssuesRef);
+                    },
                     onProgress: (toolName, line) => {
                         // Detect generateSpec execution start (onStepFinish fires too late)
                         if (toolName === 'generateSpec') {

package/dist/tui/hooks/useInit.d.ts

@@ -19,7 +19,7 @@ import type { ActionStatus } from '../components/ActionOutput.js';
 /**
  * Init workflow phases
  */
-export type InitPhase = 'scanning' | 'provider-select' | 'key-input' | 'key-save' | 'model-select' | 'ai-analysis' | 'confirm' | 'generating' | 'complete' | 'error';
+export type InitPhase = 'scanning' | 'provider-select' | 'key-input' | 'key-save' | 'model-select' | 'coding-cli-select' | 'ai-analysis' | 'confirm' | 'generating' | 'complete' | 'error';
 /**
  * Phase configuration for display
  */
@@ -66,6 +66,8 @@ export interface InitState {
     provider: AIProvider | null;
     /** Selected model */
     model: string | null;
+    /** Selected coding CLI for generated loop config */
+    codingCli: 'claude' | 'codex';
     /** API key entered (not persisted in state for security) */
     hasApiKey: boolean;
     /** Whether API key was entered this session (needs save prompt) */
@@ -109,6 +111,8 @@ export interface UseInitReturn {
     setSaveKey: (save: boolean) => void;
     /** Select model and advance to AI analysis */
     selectModel: (model: string) => void;
+    /** Select coding CLI and advance to AI analysis */
+    selectCodingCli: (cli: 'claude' | 'codex') => void;
     /** Set AI analysis progress */
     setAiProgress: (status: string) => void;
     /** Update tool call (add or update status) */

package/dist/tui/hooks/useInit.js

@@ -42,6 +42,11 @@ export const INIT_PHASE_CONFIGS = {
         name: 'Model',
         description: 'Select AI model',
     },
+    'coding-cli-select': {
+        number: 3,
+        name: 'Coding CLI',
+        description: 'Select coding CLI for loops',
+    },
     'ai-analysis': {
         number: 4,
         name: 'Analysis',
@@ -82,6 +87,7 @@ const initialState = {
     enhancedResult: null,
     provider: null,
     model: null,
+    codingCli: 'claude',
     hasApiKey: false,
     apiKeyEnteredThisSession: false,
     saveKeyToEnv: false,
@@ -168,12 +174,22 @@ export function useInit() {
         }));
     }, []);
     /**
-     * Select model and advance to AI analysis
+     * Select model and advance to coding CLI selection
      */
     const selectModel = useCallback((model) => {
         setState((prev) => ({
             ...prev,
             model,
+            phase: 'coding-cli-select',
+        }));
+    }, []);
+    /**
+     * Select coding CLI and advance to AI analysis
+     */
+    const selectCodingCli = useCallback((cli) => {
+        setState((prev) => ({
+            ...prev,
+            codingCli: cli,
             phase: 'ai-analysis',
             isWorking: true,
             workingStatus: 'Initializing AI analysis...',
@@ -325,7 +341,8 @@ export function useInit() {
                 'key-input': 'provider-select',
                 'key-save': 'key-input',
                 'model-select': prev.apiKeyEnteredThisSession ? 'key-save' : 'provider-select',
-                'ai-analysis': 'model-select',
+                'coding-cli-select': 'model-select',
+                'ai-analysis': 'coding-cli-select',
                 confirm: 'ai-analysis',
                 generating: 'confirm',
             };
@@ -345,6 +362,7 @@ export function useInit() {
         setApiKey,
         setSaveKey,
         selectModel,
+        selectCodingCli,
         setAiProgress,
         updateToolCall,
         setEnhancedResult,

package/dist/tui/screens/AgentScreen.js

@@ -82,7 +82,9 @@ function SectionSeparator({ width }) {
  * Issues panel content — shared between wide and narrow layouts
  */
 function IssuesPanel({ activeIssue, queue, completed, panelWidth, }) {
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, color: colors.yellow, children: "Active Issue" }), activeIssue ? (_jsxs(Box, { flexDirection: "column", marginLeft: 1, children: [_jsxs(Text, { children: [_jsxs(Text, { color: colors.blue, children: ["#", activeIssue.issueNumber] }), _jsxs(Text, { children: [" ", activeIssue.title] })] }), _jsxs(Text, { dimColor: true, children: [phase.active, " ", phaseLabel(activeIssue.phase, activeIssue), activeIssue.loopIterations != null ? ` (iter ${activeIssue.loopIterations})` : ''] })] })) : (_jsx(Box, { marginLeft: 1, children: _jsx(Text, { dimColor: true, children: "No active issue" }) })), _jsx(SectionSeparator, { width: panelWidth }), _jsxs(Text, { bold: true, color: colors.yellow, children: ["Queue", _jsxs(Text, { dimColor: true, children: [" (", queue.length, ")"] })] }), queue.length === 0 ? (_jsx(Box, { marginLeft: 1, children: _jsx(Text, { dimColor: true, children: "Empty" }) })) : (queue.slice(0, 5).map((issue) => (_jsx(Box, { marginLeft: 1, children: _jsxs(Text, { children: [_jsxs(Text, { dimColor: true, children: ["#", issue.issueNumber] }), _jsxs(Text, { children: [" ", issue.title] })] }) }, issue.issueNumber)))), queue.length > 5 && (_jsx(Box, { marginLeft: 1, children: _jsxs(Text, { dimColor: true, children: ["...and ", queue.length - 5, " more"] }) })), _jsx(SectionSeparator, { width: panelWidth }), _jsxs(Text, { bold: true, color: colors.yellow, children: ["Completed", _jsxs(Text, { dimColor: true, children: [" (", completed.length, ")"] })] }), completed.length === 0 ? (_jsx(Box, { marginLeft: 1, children: _jsx(Text, { dimColor: true, children: "None yet" }) })) : (completed.slice(-5).map((issue) => (_jsxs(Box, { marginLeft: 1, children: [_jsxs(Text, { children: [_jsx(Text, { color: issue.error ? colors.pink : colors.green, children: issue.error ? phase.error : phase.complete }), _jsxs(Text, { dimColor: true, children: [" #", issue.issueNumber] }), _jsxs(Text, { children: [" ", issue.title] })] }), issue.prUrl && (_jsxs(Text, { dimColor: true, children: ["  \\u2514 PR: ", issue.prUrl] }))] }, issue.issueNumber))))] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, color: colors.yellow, children: "Active Issue" }), activeIssue ? (_jsxs(Box, { flexDirection: "column", marginLeft: 1, children: [_jsxs(Text, { children: [_jsxs(Text, { color: colors.blue, children: ["#", activeIssue.issueNumber] }), _jsxs(Text, { children: [" ", activeIssue.title] })] }), _jsxs(Text, { dimColor: true, children: [phase.active, " ", phaseLabel(activeIssue.phase, activeIssue), activeIssue.loopIterations != null ? ` (iter ${activeIssue.loopIterations})` : ''] })] })) : (_jsx(Box, { marginLeft: 1, children: _jsx(Text, { dimColor: true, children: "No active issue" }) })), _jsx(SectionSeparator, { width: panelWidth }), _jsxs(Text, { bold: true, color: colors.yellow, children: ["Queue", _jsxs(Text, { dimColor: true, children: [" (", queue.length, ")"] })] }), queue.length === 0 ? (_jsx(Box, { marginLeft: 1, children: _jsx(Text, { dimColor: true, children: "Empty" }) })) : (queue.slice(0, 5).map((issue) => (_jsxs(Box, { marginLeft: 1, flexDirection: "column", children: [_jsxs(Text, { children: [_jsxs(Text, { dimColor: true, children: ["#", issue.issueNumber] }), _jsxs(Text, { children: [" ", issue.title] })] }), (issue.actionability || issue.recommendation || issue.dependsOn?.length || issue.inferredDependsOn?.length) && (_jsxs(Text, { dimColor: true, children: [issue.scopeOrigin === 'dependency' && issue.requestedBy?.length
+                                ? `dependency for ${issue.requestedBy.map(n => `#${n}`).join(', ')} · `
+                                : '', issue.actionability ?? 'ready', issue.recommendation ? ` · ${issue.recommendation}` : '', issue.dependsOn?.length ? ` · explicit: ${issue.dependsOn.map(n => `#${n}`).join(', ')}` : '', issue.inferredDependsOn?.length ? ` · inferred: ${issue.inferredDependsOn.map(dep => `#${dep.issueNumber} (${dep.confidence})`).join(', ')}` : ''] })), issue.blockedBy?.length ? (_jsxs(Text, { color: colors.orange, children: ["  blocked: ", issue.blockedBy[0].reason] })) : null] }, issue.issueNumber)))), queue.length > 5 && (_jsx(Box, { marginLeft: 1, children: _jsxs(Text, { dimColor: true, children: ["...and ", queue.length - 5, " more"] }) })), _jsx(SectionSeparator, { width: panelWidth }), _jsxs(Text, { bold: true, color: colors.yellow, children: ["Completed", _jsxs(Text, { dimColor: true, children: [" (", completed.length, ")"] })] }), completed.length === 0 ? (_jsx(Box, { marginLeft: 1, children: _jsx(Text, { dimColor: true, children: "None yet" }) })) : (completed.slice(-5).map((issue) => (_jsxs(Box, { marginLeft: 1, children: [_jsxs(Text, { children: [_jsx(Text, { color: issue.error ? colors.pink : colors.green, children: issue.error ? phase.error : phase.complete }), _jsxs(Text, { dimColor: true, children: [" #", issue.issueNumber] }), _jsxs(Text, { children: [" ", issue.title] })] }), issue.prUrl && (_jsxs(Text, { dimColor: true, children: ["  \\u2514 PR: ", issue.prUrl] }))] }, issue.issueNumber))))] }));
 }
 /**
  * Log panel content — shared between wide and narrow layouts.

package/dist/tui/screens/InitScreen.js

@@ -38,6 +38,10 @@ const PROVIDER_OPTIONS = [
     { value: 'openai', label: 'OpenAI' },
     { value: 'openrouter', label: 'OpenRouter', hint: 'multiple providers' },
 ];
+const CODING_CLI_OPTIONS = [
+    { value: 'claude', label: 'Claude Code', hint: 'default' },
+    { value: 'codex', label: 'Codex (OpenAI)' },
+];
 function getModelOptions(provider) {
     return AVAILABLE_MODELS[provider].map((m) => ({
         value: m.value,
@@ -51,7 +55,7 @@ function getModelOptions(provider) {
  * The complete Ink-based init workflow wrapped in AppShell.
  */
 export function InitScreen({ header, projectRoot, sessionState, onComplete, onCancel, }) {
-    const { state, initialize, setScanResult, setExistingProvider, selectProvider, setApiKey, setSaveKey, selectModel, setAiProgress, updateToolCall, setEnhancedResult, setAiError, confirmGeneration, setGenerating, setGenerationComplete, setError, } = useInit();
+    const { state, initialize, setScanResult, setExistingProvider, selectProvider, setApiKey, setSaveKey, selectModel, selectCodingCli, setAiProgress, updateToolCall, setEnhancedResult, setAiError, confirmGeneration, setGenerating, setGenerationComplete, setError, } = useInit();
     const apiKeyRef = useRef(null);
     const aiAnalysisStarted = useRef(false);
     const generationStarted = useRef(false);
@@ -189,6 +193,8 @@ export function InitScreen({ header, projectRoot, sessionState, onComplete, onCa
                 customVariables: {
                     ...(state.provider ? { agentProvider: state.provider } : {}),
                     ...(state.model ? { agentModel: state.model } : {}),
+                    codingCli: state.codingCli,
+                    reviewCli: state.codingCli,
                 },
             });
             try {
@@ -261,6 +267,9 @@ export function InitScreen({ header, projectRoot, sessionState, onComplete, onCa
     const handleModelSelect = useCallback((model) => {
         selectModel(model);
     }, [selectModel]);
+    const handleCodingCliSelect = useCallback((cli) => {
+        selectCodingCli(cli);
+    }, [selectCodingCli]);
     const handleConfirmGeneration = useCallback((confirmed) => {
         confirmGeneration(confirmed);
     }, [confirmGeneration]);
@@ -292,6 +301,8 @@ export function InitScreen({ header, projectRoot, sessionState, onComplete, onCa
                 if (!state.provider)
                     return null;
                 return (_jsx(Select, { message: "Select model:", options: getModelOptions(state.provider), onSelect: handleModelSelect, onCancel: onCancel }));
+            case 'coding-cli-select':
+                return (_jsx(Select, { message: "Which coding CLI do you use for loops?", options: CODING_CLI_OPTIONS, onSelect: handleCodingCliSelect, onCancel: onCancel }));
             case 'confirm':
                 return (_jsx(Confirm, { message: "Generate Ralph configuration files?", onConfirm: handleConfirmGeneration, onCancel: onCancel, initialValue: true }));
             default:

package/dist/tui/screens/MainShell.js

@@ -137,6 +137,8 @@ export function MainShell({ header, sessionState, onNavigate, backgroundRuns, in
         }
         // Parse optional flags, separating them from positional args
         let reviewMode;
+        let cli;
+        let reviewCli;
         const positional = [];
         for (let i = 0; i < args.length; i++) {
             if (args[i] === '--review-mode') {
@@ -146,18 +148,44 @@ export function MainShell({ header, sessionState, onNavigate, backgroundRuns, in
                 }
                 continue;
             }
+            if (args[i] === '--cli') {
+                if (i + 1 < args.length) {
+                    cli = args[i + 1];
+                    i++;
+                }
+                continue;
+            }
+            if (args[i] === '--review-cli') {
+                if (i + 1 < args.length) {
+                    reviewCli = args[i + 1];
+                    i++;
+                }
+                continue;
+            }
+            if (args[i]?.startsWith('--')) {
+                addSystemMessage(`Unknown flag '${args[i]}' for /run.`);
+                return;
+            }
             positional.push(args[i]);
         }
-        if (reviewMode !== undefined && reviewMode !== 'manual' && reviewMode !== 'auto') {
-            addSystemMessage(`Invalid --review-mode value '${reviewMode}'. Use 'manual' or 'auto'.`);
+        if (reviewMode !== undefined && !['manual', 'auto', 'merge'].includes(reviewMode)) {
+            addSystemMessage(`Invalid --review-mode value '${reviewMode}'. Use 'manual', 'auto', or 'merge'.`);
+            return;
+        }
+        if (cli !== undefined && !['claude', 'codex'].includes(cli)) {
+            addSystemMessage(`Invalid --cli value '${cli}'. Use 'claude' or 'codex'.`);
+            return;
+        }
+        if (reviewCli !== undefined && !['claude', 'codex'].includes(reviewCli)) {
+            addSystemMessage(`Invalid --review-cli value '${reviewCli}'. Use 'claude' or 'codex'.`);
             return;
         }
         const featureName = positional[0];
         if (!featureName) {
-            addSystemMessage('Feature name required. Usage: /run <feature-name> [--review-mode auto|manual]');
+            addSystemMessage('Feature name required. Usage: /run <feature-name> [--review-mode manual|auto|merge] [--cli claude|codex] [--review-cli claude|codex]');
             return;
         }
-        onNavigate('run', { featureName, reviewMode });
+        onNavigate('run', { featureName, reviewMode, cli, reviewCli });
     }, [sessionState.initialized, addSystemMessage, onNavigate]);
     const handleMonitor = useCallback((args) => {
         if (args.length === 0) {
@@ -198,29 +226,65 @@ export function MainShell({ header, sessionState, onNavigate, backgroundRuns, in
         // Parse optional flags
         let dryRun = false;
         let maxItems;
+        let maxSteps;
         let reviewMode;
+        let labels;
+        let issues;
         for (let i = 0; i < args.length; i++) {
             if (args[i] === '--dry-run') {
                 dryRun = true;
             }
             else if (args[i] === '--max-items' && i + 1 < args.length) {
                 maxItems = parseInt(args[i + 1], 10);
-                if (Number.isNaN(maxItems)) {
+                if (Number.isNaN(maxItems) || maxItems < 1) {
                     addSystemMessage(`Invalid --max-items value '${args[i + 1]}'. Must be a number.`);
                     return;
                 }
                 i++;
             }
+            else if (args[i] === '--max-steps' && i + 1 < args.length) {
+                maxSteps = parseInt(args[i + 1], 10);
+                if (Number.isNaN(maxSteps) || maxSteps < 1) {
+                    addSystemMessage(`Invalid --max-steps value '${args[i + 1]}'. Must be a number.`);
+                    return;
+                }
+                i++;
+            }
+            else if (args[i] === '--labels' && i + 1 < args.length) {
+                labels = args[i + 1].split(',').map(l => l.trim()).filter(Boolean);
+                if (labels.length === 0) {
+                    addSystemMessage(`Invalid --labels value '${args[i + 1]}'. Use comma-separated labels.`);
+                    return;
+                }
+                i++;
+            }
+            else if (args[i] === '--issues' && i + 1 < args.length) {
+                const raw = args[i + 1];
+                const parsed = raw.split(',').map((s) => {
+                    const n = parseInt(s.trim(), 10);
+                    return Number.isNaN(n) || n < 1 ? null : n;
+                });
+                if (parsed.some((n) => n == null)) {
+                    addSystemMessage(`Invalid --issues value '${raw}'. Use comma-separated issue numbers.`);
+                    return;
+                }
+                issues = parsed;
+                i++;
+            }
             else if (args[i] === '--review-mode' && i + 1 < args.length) {
                 reviewMode = args[i + 1];
                 i++;
             }
+            else if (args[i]?.startsWith('--')) {
+                addSystemMessage(`Unknown flag '${args[i]}' for /agent.`);
+                return;
+            }
         }
         if (reviewMode !== undefined && !['manual', 'auto', 'merge'].includes(reviewMode)) {
             addSystemMessage(`Invalid --review-mode value '${reviewMode}'. Use 'manual', 'auto', or 'merge'.`);
             return;
         }
-        onNavigate('agent', { dryRun, maxItems, reviewMode });
+        onNavigate('agent', { dryRun, maxItems, maxSteps, reviewMode, labels, issues });
     }, [sessionState.initialized, addSystemMessage, onNavigate]);
     const handleIssueCommand = useCallback(async (searchQuery) => {
         if (!sessionState.initialized) {