Struct WorktreeConfig 

pub struct WorktreeConfig {
    pub enabled: bool,
    pub base_ref: WorktreeBaseRef,
    pub default_branch: String,
    pub root: String,
    pub branch_prefix: String,
    pub prune_branch_on_remove: bool,
    pub cleanup_on_completion: bool,
    pub bg_isolation: BgIsolation,
    pub git_timeout_secs: u64,
}

Configuration for the per-subagent git worktree isolation feature.

When enabled = true, each subagent that opts in via SubAgentPermissions::worktree receives a dedicated git worktree on a fresh branch, ensuring that file edits from concurrent agents do not interfere with each other or with the main working tree.

Examples

use zeph_config::WorktreeConfig;

let cfg = WorktreeConfig::default();
assert!(!cfg.enabled);
assert_eq!(cfg.root, ".claude/worktrees");
assert_eq!(cfg.branch_prefix, "agent/");
assert_eq!(cfg.git_timeout_secs, 30);

Fields

enabled: bool

Enable per-subagent git worktrees. When false, no worktrees are created regardless of other settings.

base_ref: WorktreeBaseRef

Base commit strategy for new worktree branches.

default_branch: String

Default remote branch used when base_ref = "fresh".

Empty string triggers auto-detection of origin/HEAD.

root: String

Root directory for worktrees, relative to the repository root.

Each worktree is placed in a subdirectory named after the subagent ID.

branch_prefix: String

Branch name prefix. The full branch name is "{prefix}{subagent_id}".

prune_branch_on_remove: bool

Delete the worktree branch after the worktree is removed.

When false (default), the branch persists so the agent’s work can be reviewed, merged, or discarded manually.

cleanup_on_completion: bool

Remove the worktree when the agent completes or is cancelled.

When false, worktrees persist until an explicit worktree clean command.

bg_isolation: BgIsolation

Background subagent isolation mode.

Controls whether background subagents receive a dedicated worktree or edit the working copy directly.

git_timeout_secs: u64

Per-command timeout for git invocations, in seconds.

Applied to every git call issued by the worktree subsystem (e.g. git worktree add, git fetch, git rev-parse). Increase this value on repositories that are slow to clone or when running over high-latency network links. A value of 0 is treated as 1 at the call site.

Trait Implementations

impl Clone for WorktreeConfig

fn clone(&self) -> WorktreeConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WorktreeConfig

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

Formats the value using the given formatter.

impl Default for WorktreeConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for WorktreeConfig

where WorktreeConfig: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for WorktreeConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.