wiggum-cli 0.17.2 → 0.17.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 };
@@ -211,7 +217,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 +227,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/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() {
@@ -31,7 +31,7 @@ function appendLog(prev, message, level = 'info') {
  * Interpret a tool call name and extract relevant info from args/results
  * to drive TUI state transitions.
  */
-function interpretToolCalls(event, setActiveIssue, setQueue, setCompleted, setLogEntries, pollingRef, stopLoopPolling, ranLoopRef, activeIssueRef) {
+function interpretToolCalls(event, setActiveIssue, setQueue, setCompleted, setLogEntries, pollingRef, stopLoopPolling, ranLoopRef, activeIssueRef, issueNumberFilter) {
     // If a new tool call arrives while polling, the runLoop tool has finished — stop polling
     for (const tc of event.toolCalls) {
         if (tc.toolName !== 'runLoop' && pollingRef.current) {
@@ -207,7 +207,12 @@ function interpretToolCalls(event, setActiveIssue, setQueue, setCompleted, setLo
                     // 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) => ({
+                        // When --issues is configured, defensively filter queue to only those issues
+                        // (the tool should already filter, but this guards against edge cases)
+                        const relevantIssues = issueNumberFilter
+                            ? issues.filter(i => issueNumberFilter.has((i.number ?? i.issueNumber)))
+                            : issues;
+                        const queueItems = relevantIssues.map((issue) => ({
                             issueNumber: (issue.number ?? issue.issueNumber),
                             title: issue.title ?? `Issue #${issue.number ?? issue.issueNumber}`,
                             labels: Array.isArray(issue.labels) ? issue.labels : [],
@@ -268,7 +273,7 @@ export function useAgentOrchestrator(options) {
         const state = {
             featureName,
             interval: null,
-            lastLogTimestamp: undefined,
+            lastLogCursor: 0,
             lastPhases: undefined,
         };
         // Accumulated activity events across polls
@@ -304,9 +309,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);
@@ -374,6 +380,9 @@ export function useAgentOrchestrator(options) {
                     model: options.modelOverride,
                 });
                 setLogEntries((prev) => appendLog(prev, `Using ${env.provider}/${env.modelId ?? 'default'} on ${env.owner}/${env.repo}`));
+                const issueFilter = options.issues?.length
+                    ? new Set(options.issues)
+                    : undefined;
                 const agentConfig = {
                     model: env.model,
                     modelId: env.modelId,
@@ -388,7 +397,7 @@ export function useAgentOrchestrator(options) {
                     reviewMode: options.reviewMode,
                     dryRun: options.dryRun,
                     onStepUpdate: (event) => {
-                        interpretToolCalls(event, setActiveIssue, setQueue, setCompleted, setLogEntries, pollingRef, stopLoopPolling, ranLoopRef, activeIssueRef);
+                        interpretToolCalls(event, setActiveIssue, setQueue, setCompleted, setLogEntries, pollingRef, stopLoopPolling, ranLoopRef, activeIssueRef, issueFilter);
                     },
                     onProgress: (toolName, line) => {
                         // Detect generateSpec execution start (onStepFinish fires too late)

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/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) {

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

@@ -150,10 +150,14 @@ export interface RunScreenProps {
     /** Monitor-only mode: don't spawn, just poll status */
     monitorOnly?: boolean;
     /** Override review mode from CLI flags (takes precedence over config) */
-    reviewMode?: 'manual' | 'auto';
+    reviewMode?: 'manual' | 'auto' | 'merge';
+    /** Override implementation CLI from CLI flags (takes precedence over config) */
+    cli?: 'claude' | 'codex';
+    /** Override review CLI from CLI flags (takes precedence over config) */
+    reviewCli?: 'claude' | 'codex';
     onComplete: (summary: RunSummary) => void;
     /** Called when user presses Esc to background the run */
     onBackground?: (featureName: string) => void;
     onCancel: () => void;
 }
-export declare function RunScreen({ header, featureName, projectRoot, sessionState, monitorOnly, reviewMode: reviewModeProp, onComplete, onBackground, onCancel, }: RunScreenProps): React.ReactElement;
+export declare function RunScreen({ header, featureName, projectRoot, sessionState, monitorOnly, reviewMode: reviewModeProp, cli: cliProp, reviewCli: reviewCliProp, onComplete, onBackground, onCancel, }: RunScreenProps): React.ReactElement;

package/dist/tui/screens/RunScreen.js

@@ -33,6 +33,15 @@ import { readActionRequest, writeActionReply, cleanupActionFiles } from '../util
 const POLL_INTERVAL_MS = 2500;
 const ERROR_TAIL_LINES = 12;
 const RUN_REVIEW_MODES = ['manual', 'auto', 'merge'];
+const RUN_LOOP_CLIS = ['claude', 'codex'];
+const DEFAULT_CODEX_LOOP_MODEL = 'gpt-5.3-codex';
+function getLoopModelLabel(defaultClaudeModel, codingCli, reviewCli) {
+    if (codingCli === 'codex' && reviewCli === 'codex')
+        return DEFAULT_CODEX_LOOP_MODEL;
+    if (codingCli === 'claude' && reviewCli === 'claude')
+        return defaultClaudeModel;
+    return `${defaultClaudeModel} (claude) / ${DEFAULT_CODEX_LOOP_MODEL} (codex)`;
+}
 function findFeatureLoopScript(projectRoot, scriptsDir) {
     const localScript = join(projectRoot, scriptsDir, 'feature-loop.sh');
     if (existsSync(localScript)) {
@@ -48,6 +57,15 @@ function findFeatureLoopScript(projectRoot, scriptsDir) {
     }
     return null;
 }
+function scriptSupportsCliFlags(scriptPath) {
+    try {
+        const script = readFileSync(scriptPath, 'utf-8');
+        return script.includes('--cli') && script.includes('--review-cli');
+    }
+    catch {
+        return false;
+    }
+}
 function findSpecFile(projectRoot, feature, specsDir) {
     const possiblePaths = [
         join(projectRoot, specsDir, `${feature}.md`),
@@ -87,7 +105,7 @@ function readLogTail(logPath, maxLines) {
         return `[Unable to read log: ${err instanceof Error ? err.message : String(err)}]`;
     }
 }
-export function RunScreen({ header, featureName, projectRoot, sessionState, monitorOnly = false, reviewMode: reviewModeProp, onComplete, onBackground, onCancel, }) {
+export function RunScreen({ header, featureName, projectRoot, sessionState, monitorOnly = false, reviewMode: reviewModeProp, cli: cliProp, reviewCli: reviewCliProp, onComplete, onBackground, onCancel, }) {
     const [status, setStatus] = useState(() => {
         try {
             return readLoopStatus(featureName);
@@ -115,6 +133,8 @@ export function RunScreen({ header, featureName, projectRoot, sessionState, moni
     const [baselineCommit, setBaselineCommit] = useState(null);
     const [recentCommits, setRecentCommits] = useState([]);
     const [reviewMode, setReviewMode] = useState(reviewModeProp ?? 'manual');
+    const [loopCli, setLoopCli] = useState('claude');
+    const [reviewCli, setReviewCli] = useState('claude');
     const [loopModel, setLoopModel] = useState(null);
     const childRef = useRef(null);
     const stopRequestedRef = useRef(false);
@@ -351,8 +371,12 @@ export function RunScreen({ header, featureName, projectRoot, sessionState, moni
                     const config = sessionState.config ?? await loadConfigWithDefaults(projectRoot);
                     specsDirRef.current = config.paths.specs;
                     if (!cancelled) {
-                        setLoopModel(config.loop.defaultModel);
                         setReviewMode((prev) => reviewModeProp ?? config.loop.reviewMode ?? prev);
+                        const effectiveCli = (cliProp ?? config.loop.codingCli ?? 'claude');
+                        const effectiveReviewCli = (reviewCliProp ?? config.loop.reviewCli ?? effectiveCli);
+                        setLoopModel(getLoopModelLabel(config.loop.defaultModel, effectiveCli, effectiveReviewCli));
+                        setLoopCli(effectiveCli);
+                        setReviewCli(effectiveReviewCli);
                     }
                 }
                 catch (err) {
@@ -396,7 +420,11 @@ export function RunScreen({ header, featureName, projectRoot, sessionState, moni
                 configRootRef.current = config.paths.root;
                 maxIterationsRef.current = config.loop.maxIterations;
                 maxE2eAttemptsRef.current = config.loop.maxE2eAttempts;
-                setLoopModel(config.loop.defaultModel);
+                const effectiveCli = (cliProp ?? config.loop.codingCli ?? 'claude');
+                const effectiveReviewCli = (reviewCliProp ?? config.loop.reviewCli ?? effectiveCli);
+                setLoopModel(getLoopModelLabel(config.loop.defaultModel, effectiveCli, effectiveReviewCli));
+                setLoopCli(effectiveCli);
+                setReviewCli(effectiveReviewCli);
                 const specFile = findSpecFile(projectRoot, featureName, config.paths.specs);
                 if (!specFile) {
                     setError(`Spec file not found for "${featureName}". Run /new ${featureName} first.`);
@@ -409,6 +437,16 @@ export function RunScreen({ header, featureName, projectRoot, sessionState, moni
                     setIsStarting(false);
                     return;
                 }
+                if (!RUN_LOOP_CLIS.includes(effectiveCli) || !RUN_LOOP_CLIS.includes(effectiveReviewCli)) {
+                    setError(`Invalid CLI selection. Allowed values are: ${RUN_LOOP_CLIS.join(', ')}`);
+                    setIsStarting(false);
+                    return;
+                }
+                if ((effectiveCli !== 'claude' || effectiveReviewCli !== 'claude') && !scriptSupportsCliFlags(scriptPath)) {
+                    setError('Your feature-loop.sh is outdated and does not support --cli/--review-cli. Re-run /init, then try again.');
+                    setIsStarting(false);
+                    return;
+                }
                 const effectiveReviewMode = reviewModeProp ?? config.loop.reviewMode ?? 'manual';
                 setReviewMode(effectiveReviewMode);
                 if (effectiveReviewMode !== 'manual' && effectiveReviewMode !== 'auto' && effectiveReviewMode !== 'merge') {
@@ -428,6 +466,10 @@ export function RunScreen({ header, featureName, projectRoot, sessionState, moni
                         featureName,
                         String(config.loop.maxIterations),
                         String(config.loop.maxE2eAttempts),
+                        '--cli',
+                        effectiveCli,
+                        '--review-cli',
+                        effectiveReviewCli,
                         '--review-mode',
                         effectiveReviewMode,
                     ];
@@ -551,7 +593,7 @@ export function RunScreen({ header, featureName, projectRoot, sessionState, moni
         // Note: refreshStatusRef (not refreshStatus) is used inside to avoid re-spawning
         // the child process when the callback identity changes due to actionRequest updates.
         // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [featureName, projectRoot, monitorOnly, sessionState.config]);
+    }, [featureName, projectRoot, monitorOnly, sessionState.config, reviewModeProp, cliProp, reviewCliProp]);
     const totalTasks = tasks.tasksDone + tasks.tasksPending;
     const totalE2e = tasks.e2eDone + tasks.e2ePending;
     const totalAll = totalTasks + totalE2e;
@@ -613,8 +655,8 @@ export function RunScreen({ header, featureName, projectRoot, sessionState, moni
             action: 'Run Loop',
             phase: phaseLine,
             path: featureName,
-            extra: `review: ${reviewMode}`,
-        }, children: completionSummary ? (_jsx(RunCompletionSummary, { summary: completionSummary })) : (!error && (_jsxs(_Fragment, { children: [_jsxs(Box, { marginTop: 1, flexDirection: "row", children: [_jsx(Text, { children: "Phase: " }), _jsx(Text, { color: colors.yellow, children: phaseLine }), _jsx(Text, { dimColor: true, children: theme.statusLine.separator }), _jsx(Text, { children: "Iter: " }), _jsx(Text, { color: colors.green, children: status.iteration }), _jsxs(Text, { dimColor: true, children: ["/", status.maxIterations || maxIterationsRef.current || '-'] }), _jsx(Text, { dimColor: true, children: theme.statusLine.separator }), _jsx(Text, { children: "Branch: " }), _jsx(Text, { color: colors.blue, children: branch }), loopModel && (_jsxs(_Fragment, { children: [_jsx(Text, { dimColor: true, children: theme.statusLine.separator }), _jsx(Text, { children: "Model: " }), _jsx(Text, { color: colors.blue, children: loopModel })] }))] }), _jsxs(Box, { marginTop: 1, flexDirection: "row", children: [_jsx(Text, { children: "Tokens: " }), _jsx(Text, { color: colors.pink, children: formatNumber(totalTokens) }), _jsxs(Text, { dimColor: true, children: [" (in:", formatNumber(status.tokensInput), " out:", formatNumber(status.tokensOutput), " cache:", formatNumber(status.cacheRead), ")"] }), _jsx(Text, { dimColor: true, children: theme.statusLine.separator }), _jsxs(Text, { dimColor: true, children: ["Elapsed: ", formatDuration(startTimeRef.current)] })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Box, { flexDirection: "row", alignItems: "center", gap: 1, children: [_jsx(Text, { bold: true, children: padLabel('Implementation:') }), _jsx(ProgressBar, { percent: percentTasks }), _jsxs(Text, { children: [String(percentTasks).padStart(3), "%"] }), _jsxs(Text, { color: colors.green, children: ['\u2713', " ", tasks.tasksDone] }), _jsxs(Text, { color: colors.yellow, children: ['\u25cb', " ", tasks.tasksPending] })] }), totalE2e > 0 && (_jsxs(Box, { flexDirection: "row", alignItems: "center", gap: 1, children: [_jsx(Text, { bold: true, children: padLabel('E2E Tests:') }), _jsx(ProgressBar, { percent: percentE2e }), _jsxs(Text, { children: [String(percentE2e).padStart(3), "%"] }), _jsxs(Text, { color: colors.green, children: ['\u2713', " ", tasks.e2eDone] }), _jsxs(Text, { color: colors.yellow, children: ['\u25cb', " ", tasks.e2ePending] })] })), _jsxs(Box, { flexDirection: "row", alignItems: "center", gap: 1, marginTop: 1, children: [_jsx(Text, { bold: true, children: padLabel('Overall:') }), _jsx(ProgressBar, { percent: percentAll }), _jsxs(Text, { children: [String(percentAll).padStart(3), "%"] }), _jsxs(Text, { color: colors.green, children: ['\u2713', " ", doneAll] }), _jsxs(Text, { color: colors.yellow, children: ['\u25cb', " ", totalAll - doneAll] })] })] }), recentCommits.length > 0 && (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { bold: true, children: "Recent Commits" }), recentCommits.map((c) => (_jsx(Box, { flexDirection: "row", children: _jsxs(Text, { dimColor: true, children: ["  ", c.hash, " ", c.title] }) }, c.hash)))] })), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { bold: true, children: "Activity" }), _jsx(ActivityFeed, { events: activityEvents, latestCommit: baselineCommit && latestCommit && baselineCommit !== latestCommit
+            extra: `review: ${reviewMode} | cli: ${loopCli} | review-cli: ${reviewCli}`,
+        }, children: completionSummary ? (_jsx(RunCompletionSummary, { summary: completionSummary })) : (!error && (_jsxs(_Fragment, { children: [_jsxs(Box, { marginTop: 1, flexDirection: "row", children: [_jsx(Text, { children: "Phase: " }), _jsx(Text, { color: colors.yellow, children: phaseLine }), _jsx(Text, { dimColor: true, children: theme.statusLine.separator }), _jsx(Text, { children: "Iter: " }), _jsx(Text, { color: colors.green, children: status.iteration }), _jsxs(Text, { dimColor: true, children: ["/", status.maxIterations || maxIterationsRef.current || '-'] }), _jsx(Text, { dimColor: true, children: theme.statusLine.separator }), _jsx(Text, { children: "Branch: " }), _jsx(Text, { color: colors.blue, children: branch }), loopModel && (_jsxs(_Fragment, { children: [_jsx(Text, { dimColor: true, children: theme.statusLine.separator }), _jsx(Text, { children: "Model: " }), _jsx(Text, { color: colors.blue, children: loopModel })] })), _jsx(Text, { dimColor: true, children: theme.statusLine.separator }), _jsx(Text, { children: "CLI: " }), _jsx(Text, { color: colors.blue, children: loopCli }), _jsx(Text, { dimColor: true, children: "/" }), _jsx(Text, { color: colors.blue, children: reviewCli })] }), _jsxs(Box, { marginTop: 1, flexDirection: "row", children: [_jsx(Text, { children: "Tokens: " }), _jsx(Text, { color: colors.pink, children: formatNumber(totalTokens) }), _jsxs(Text, { dimColor: true, children: [" (in:", formatNumber(status.tokensInput), " out:", formatNumber(status.tokensOutput), " cache:", formatNumber(status.cacheRead), ")"] }), _jsx(Text, { dimColor: true, children: theme.statusLine.separator }), _jsxs(Text, { dimColor: true, children: ["Elapsed: ", formatDuration(startTimeRef.current)] })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Box, { flexDirection: "row", alignItems: "center", gap: 1, children: [_jsx(Text, { bold: true, children: padLabel('Implementation:') }), _jsx(ProgressBar, { percent: percentTasks }), _jsxs(Text, { children: [String(percentTasks).padStart(3), "%"] }), _jsxs(Text, { color: colors.green, children: ['\u2713', " ", tasks.tasksDone] }), _jsxs(Text, { color: colors.yellow, children: ['\u25cb', " ", tasks.tasksPending] })] }), totalE2e > 0 && (_jsxs(Box, { flexDirection: "row", alignItems: "center", gap: 1, children: [_jsx(Text, { bold: true, children: padLabel('E2E Tests:') }), _jsx(ProgressBar, { percent: percentE2e }), _jsxs(Text, { children: [String(percentE2e).padStart(3), "%"] }), _jsxs(Text, { color: colors.green, children: ['\u2713', " ", tasks.e2eDone] }), _jsxs(Text, { color: colors.yellow, children: ['\u25cb', " ", tasks.e2ePending] })] })), _jsxs(Box, { flexDirection: "row", alignItems: "center", gap: 1, marginTop: 1, children: [_jsx(Text, { bold: true, children: padLabel('Overall:') }), _jsx(ProgressBar, { percent: percentAll }), _jsxs(Text, { children: [String(percentAll).padStart(3), "%"] }), _jsxs(Text, { color: colors.green, children: ['\u2713', " ", doneAll] }), _jsxs(Text, { color: colors.yellow, children: ['\u25cb', " ", totalAll - doneAll] })] })] }), recentCommits.length > 0 && (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { bold: true, children: "Recent Commits" }), recentCommits.map((c) => (_jsx(Box, { flexDirection: "row", children: _jsxs(Text, { dimColor: true, children: ["  ", c.hash, " ", c.title] }) }, c.hash)))] })), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { bold: true, children: "Activity" }), _jsx(ActivityFeed, { events: activityEvents, latestCommit: baselineCommit && latestCommit && baselineCommit !== latestCommit
                                 ? `${baselineCommit} \u2192 ${latestCommit}`
                                 : latestCommit || undefined })] })] }))) }));
 }

package/dist/tui/utils/loop-status.d.ts

@@ -109,6 +109,14 @@ export interface ActivityEvent {
     /** Inferred status based on event content */
     status: 'success' | 'error' | 'in-progress';
 }
+/**
+ * Incremental parse result for loop logs.
+ * `nextCursor` is a character offset for the next poll.
+ */
+export interface LoopLogDelta {
+    events: ActivityEvent[];
+    nextCursor: number;
+}
 /**
  * Returns true if a log line should be excluded from the activity feed.
  */
@@ -123,6 +131,13 @@ export declare function shouldSkipLine(line: string): boolean;
  * @param since - Optional epoch ms cutoff; only return events at or after this time.
  */
 export declare function parseLoopLog(logPath: string, since?: number): ActivityEvent[];
+/**
+ * Incrementally parse only the new portion of a loop log.
+ *
+ * The cursor is a character offset in UTF-16 code units. If the file shrinks,
+ * parsing restarts from the beginning.
+ */
+export declare function parseLoopLogDelta(logPath: string, cursor?: number): LoopLogDelta;
 /**
  * Detect phase changes by comparing current phases file to a known previous state,
  * and emit activity events for newly completed or started phases.