Struct FeaturesConfig 

pub struct FeaturesConfig {
    pub parallel: bool,
    pub auto_merge: bool,
    pub loop_naming: LoopNamingConfig,
    pub preflight: PreflightConfig,
}

Feature flags for optional Ralph capabilities.

Example configuration:

features:
  parallel: true  # Enable parallel loops via git worktrees
  auto_merge: false  # Auto-merge worktree branches on completion
  preflight:
    enabled: false      # Opt-in: run preflight checks before `ralph run`
    strict: false       # Treat warnings as failures
    skip: ["telegram"]  # Skip specific checks by name
  loop_naming:
    format: human-readable  # or "timestamp" for legacy format
    max_length: 50

Fields

parallel: bool

Whether parallel loops are enabled.

When true (default), if another loop holds the lock, Ralph spawns a parallel loop in a git worktree. When false, Ralph errors instead.

auto_merge: bool

Whether to automatically merge worktree branches on completion.

When false (default), completed worktree loops queue for manual merge. When true, Ralph automatically merges the worktree branch into the main branch after a parallel loop completes.

loop_naming: LoopNamingConfig

Loop naming configuration for worktree branches.

Controls how loop IDs are generated for parallel loops. Default uses human-readable format: fix-header-swift-peacock Legacy timestamp format: ralph-YYYYMMDD-HHMMSS-XXXX

preflight: PreflightConfig

Preflight check configuration.

Trait Implementations

impl Clone for FeaturesConfig

fn clone(&self) -> FeaturesConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FeaturesConfig

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

Formats the value using the given formatter.

impl Default for FeaturesConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for FeaturesConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for FeaturesConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.