Struct WorktreeHandle 

#[non_exhaustive]
pub struct WorktreeHandle {
    pub path: PathBuf,
    pub branch: String,
    pub base_commit: String,
    pub state: WorktreeState,
    pub created_at: String,
    pub creator_pid: u32,
    pub creator_name: String,
    pub adapter: Option<String>,
    pub setup_complete: bool,
    pub port: Option<u16>,
    pub session_uuid: String,
}

A handle to a managed git worktree, containing all metadata tracked by iso-code.

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.

path: PathBuf

Absolute path to the worktree directory on disk.

branch: String

Branch name exactly as passed to create() — never transformed.

base_commit: String

Full 40-char commit SHA at creation time (the –base ref resolved).

state: WorktreeState

Current lifecycle state.

created_at: String

ISO 8601 creation timestamp (UTC).

creator_pid: u32

PID of the process that called Manager::create().

creator_name: String

Human-readable name of the tool that created this worktree. Examples: “claude-squad”, “workmux”, “claude-code”, “manual”

adapter: Option<String>

Name of the EcosystemAdapter used, if any.

setup_complete: bool

Whether adapter.setup() completed without error.

port: Option<u16>

Allocated port number (the actual port, not an offset). None if port allocation was not requested.

session_uuid: String

Stable UUID for this worktree’s entire lifetime. Used in multi-factor lock identity and port lease keying.

Implementations

impl WorktreeHandle

pub fn new( path: PathBuf, branch: String, base_commit: String, state: WorktreeState, created_at: String, creator_pid: u32, creator_name: String, adapter: Option<String>, setup_complete: bool, port: Option<u16>, session_uuid: String, ) -> Self

Create a new WorktreeHandle. Used internally by Manager.

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.