Struct WorktreeHandle 

pub struct WorktreeHandle {
    pub path: PathBuf,
    pub branch_name: String,
    pub base_ref_resolved: String,
    pub subagent_id: String,
    pub created_at: SystemTime,
}

A live record of a git worktree that WorktreeManager has created for a subagent.

Handles are stored in-memory for the duration of the session. They are not persisted to disk; on restart, WorktreeManager::reconcile re-discovers handles from the git worktree registry.

Fields

path: PathBuf

Absolute path on disk where the worktree was checked out.

branch_name: String

The git branch name created for this worktree.

For worktrees discovered by WorktreeManager::reconcile that are on a detached HEAD, this is DETACHED_BRANCH_SENTINEL rather than an actual branch name.

base_ref_resolved: String

The resolved base ref used to create the branch.

"HEAD" for WorktreeBaseRef::Head, "origin/{branch}" for WorktreeBaseRef::Fresh.

subagent_id: String

The subagent identifier that this worktree was created for.

created_at: SystemTime

Wall-clock time when the worktree was created.

Trait Implementations

impl Clone for WorktreeHandle

fn clone(&self) -> WorktreeHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WorktreeHandle

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

Formats the value using the given formatter.