Ralphex compatibility
This is the authoritative compatibility table between ralphex flags and RalphTerm. Status legend:
- Supported — same behavior as ralphex.
- Accepted — parsed without error, but may warn or no-op when the corresponding behavior is not yet wired.
- Pending — recognized by the parser, planned for a near-term release.
Flag table
| Ralphex flag | RalphTerm equivalent | Status | Notes |
|---|---|---|---|
-m, --max-iterations | --max-iterations | Supported | Implementation+review iteration cap per task. |
--max-external-iterations | --max-external-iterations | Supported | External-review loop cap. |
--review-patience | --review-patience | Supported | Number of consecutive clean reviews required before acceptance. |
--task-model | --task-model | Supported | Model identifier passed to the implementation CLI. |
--review-model | --review-model | Supported | Model identifier passed to the review CLI. |
--claude-command | --claude-command | Supported | Drives a PTY command. Never claude -p or --print. |
--claude-args | --claude-args | Supported | Joined with --claude-command. |
--external-review-tool | --external-review-tool=codex|custom|none | Supported | custom requires --custom-review-script; none disables review. |
--custom-review-script | --custom-review-script | Supported | Maps directly to RalphTerm's independent review command. |
-r, --review | --review | Supported | Review-only mode: skip task execution, run the full review pipeline. |
-e, --external-only | --external-only | Supported | Run external review and fixer loop only. |
-c, --codex-only | --codex-only | Supported | Alias for the codex external-only loop. |
-t, --tasks-only | --tasks-only | Supported | Skip review intentionally. Default full mode is review-gated. |
-b, --base-ref | --base-ref | Supported | Diff baseline for reviewer context and final review. |
--wait | --wait | Supported | Block until the daemon/run finishes. |
--session-timeout | --session-timeout | Supported | Per-session wall-clock timeout. |
--idle-timeout | --idle-timeout | Supported | Idle PTY timeout before the session is cancelled. |
--skip-finalize | --skip-finalize | Accepted | Suppresses the final-review pass; commits still gated by per-task review. |
--preserve-anthropic-api-key | --preserve-anthropic-api-key | Supported | Passes ANTHROPIC_API_KEY through to the agent process. |
--worktree | --worktree | Supported | Creates an isolated git worktree for the run. |
--branch | --branch | Supported | Worktree branch override; defaults to plan filename slug. |
--plan | positional <plan> | Supported | RalphTerm accepts a positional plan path; --plan still parses. |
-d, --debug | --debug | Supported | Verbose logging. |
--no-color | --no-color | Supported | Disable ANSI color in RalphTerm-owned output. |
-v, --version | --version | Supported | Prints the RalphTerm version. |
-s, --serve | --serve | Supported | Starts the local daemon with progress/dashboard endpoints. |
-p, --port | --port | Supported | Daemon port; default 7878. |
--host | --host | Supported | Daemon bind host; default 127.0.0.1. |
-w, --watch | --watch | Supported | Watch a plans directory and process new plans automatically. |
--init | --init | Pending | Scaffolds a .ralphex/ directory with default config. |
--reset | --reset | Pending | Reset local .ralphex/ state to defaults. |
--dump-defaults | --dump-defaults | Accepted | Prints the default config to stdout. |
--config-dir / RALPHEX_CONFIG_DIR | --config-dir / RALPHEX_CONFIG_DIR | Supported | Overrides global config dir (default ~/.config/ralphex/). |
Modes
- Full mode (no
--tasks-only): task execution plus review gate. Fails before agent execution if no reviewer is configured. - Tasks-only (
--tasks-only): execution only, no review. - Review-only (
--review): skip task execution, run review pipeline. - External-only (
--external-only/--codex-only): run external review/fixer loop only.
Signals
The signal detector recognizes the ralphex signals and RalphTerm's native aliases:
<<<RALPHEX:ALL_TASKS_DONE>>><<<RALPHEX:TASK_FAILED>>><<<RALPHEX:REVIEW_DONE>>><<<RALPHEX:CODEX_REVIEW_DONE>>>COMPLETED,FAILED,REVIEW_PASS,REVIEW_FAIL(RalphTerm-native aliases).
REVIEW_DONE means this iteration found zero actionable issues, not that all fixes are accepted.