Skip to content

Conversation

@eYdr1en
Copy link

@eYdr1en eYdr1en commented Jan 29, 2026

Problem

The Ralph Loop wizard (plan orchestrator) was failing with the error:

When using --print, --output-format=stream-json requires --verbose

Root Cause

Claude CLI v2.1.22+ changed its requirements - when using --print with --output-format=stream-json, the --verbose flag is now required.

Solution

Added --verbose flag to the runPrompt args in src/session.ts:

const args = [
  '-p',
  '--dangerously-skip-permissions',
  '--output-format', 'stream-json',
  '--verbose',  // Required for stream-json output format
];

Testing

  • Tested Ralph Loop wizard - now starts successfully without the error
  • Verified with claude --help that --verbose is a valid flag

🤖 Generated with Claude Code

When COLORTERM=truecolor is inherited from the outer terminal (e.g., Ghostty),
Claude Code's Ink UI tries to use truecolor mode which xterm.js doesn't
handle correctly, causing rendering issues (gray/white backgrounds).

This fix unsets COLORTERM in all PTY spawns so applications use standard
256-color mode which xterm.js fully supports.

Fixes: xtermjs/xterm.js#484
Claude CLI v2.1.22+ now requires --verbose when using
--output-format=stream-json with -p/--print mode.

Without this flag, the CLI errors with:
"Error: When using --print, --output-format=stream-json requires --verbose"

This broke the Ralph Loop wizard and plan orchestrator agents.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant