Struct Config 

#[non_exhaustive]
pub struct Config {

    pub max_worktrees: usize,
    pub disk_threshold_percent: u8,
    pub gc_max_age_days: u32,
    pub port_range_start: u16,
    pub port_range_end: u16,
    pub min_free_disk_mb: u64,
    pub home_override: Option<PathBuf>,
    pub max_total_disk_bytes: Option<u64>,
    pub circuit_breaker_threshold: u32,
    pub stale_metadata_ttl_days: u32,
    pub lock_timeout_ms: u64,
    pub creator_name: String,
    pub offline: bool,
}

Configuration for a Manager instance.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

max_worktrees: usize

Maximum managed worktrees per repository. Default: 20.

disk_threshold_percent: u8

Refuse creation if aggregate worktree disk usage exceeds this percentage of the filesystem. Default: 90.

gc_max_age_days: u32

Auto-GC worktrees older than this many days. Default: 7.

port_range_start: u16

Start of the port range for lease allocation. Default: 3100.

port_range_end: u16

End of the port range for lease allocation (exclusive). Default: 5100.

min_free_disk_mb: u64

Minimum free disk space required to create a worktree. Default: 500 MB.

home_override: Option<PathBuf>

Override all state file paths (useful for CI and containers). Mirrors the ISO_CODE_HOME environment variable.

max_total_disk_bytes: Option<u64>

Maximum aggregate disk usage across all managed worktrees in bytes. None = unlimited. Default: None.

circuit_breaker_threshold: u32

Trip circuit breaker after this many consecutive git command failures. Default: 3.

stale_metadata_ttl_days: u32

How long evicted metadata is preserved in state.json before permanent deletion. Default: 30 days.

lock_timeout_ms: u64

Total timeout for state.lock acquisition including all retries. Default: 30,000 ms.

creator_name: String

Name recorded in state.json as creator_name for this Manager instance. Example: “claude-squad”, “workmux”, “my-orchestrator”

offline: bool

Skip network operations (e.g. git fetch in the five-step unmerged commit check). Set to true when running offline or in CI to avoid network latency per delete / per-candidate during gc(). Default: false.

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Config

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

Formats the value using the given formatter.

impl Default for Config

fn default() -> Self

Returns the “default value” for a type.