Struct RalphOptions 

pub struct RalphOptions {

    pub prompt: String,
    pub change_id: Option<String>,
    pub module_id: Option<String>,
    pub model: Option<String>,
    pub min_iterations: u32,
    pub max_iterations: Option<u32>,
    pub completion_promise: String,
    pub allow_all: bool,
    pub no_commit: bool,
    pub interactive: bool,
    pub status: bool,
    pub add_context: Option<String>,
    pub clear_context: bool,
    pub verbose: bool,
    pub continue_module: bool,
    pub continue_ready: bool,
    pub inactivity_timeout: Option<Duration>,
    pub skip_validation: bool,
    pub validation_command: Option<String>,
    pub exit_on_error: bool,
    pub error_threshold: u32,
    pub worktree: WorktreeConfig,
}

Runtime options for a single Ralph loop invocation.

Fields

prompt: String

Base prompt content appended after any change/module context.

change_id: Option<String>

Optional change id to scope the loop to.

module_id: Option<String>

Optional module id to scope the loop to.

model: Option<String>

Optional model override passed through to the harness.

min_iterations: u32

Minimum number of iterations required before a completion promise is honored.

max_iterations: Option<u32>

Optional maximum iteration count.

completion_promise: String

Completion token that signals the loop is done (e.g. COMPLETE).

allow_all: bool

Auto-approve all harness prompts and actions.

no_commit: bool

Skip creating a git commit after each iteration.

interactive: bool

Enable interactive mode when supported by the harness.

status: bool

Print the current saved state without running a new iteration.

add_context: Option<String>

Append additional markdown to the saved Ralph context and exit.

clear_context: bool

Clear any saved Ralph context and exit.

verbose: bool

Print the full prompt sent to the harness.

continue_module: bool

When targeting a module, continue through ready changes until module work is complete.

continue_ready: bool

When set, continuously process eligible changes across the repo.

Eligible changes are those whose derived work status is Ready or InProgress.

inactivity_timeout: Option<Duration>

Inactivity timeout - restart iteration if no output for this duration.

skip_validation: bool

Skip all completion validation.

When set, the loop trusts the completion promise and exits immediately.

validation_command: Option<String>

Additional validation command to run when a completion promise is detected.

This runs after the project validation steps.

exit_on_error: bool

Exit immediately when the harness process returns non-zero.

When false, Ralph captures the failure output and continues iterating.

error_threshold: u32

Maximum number of non-zero harness exits allowed before failing.

Applies only when exit_on_error is false.

worktree: WorktreeConfig

Worktree configuration for working directory resolution.

Trait Implementations

impl Clone for RalphOptions

fn clone(&self) -> RalphOptions

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RalphOptions

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.