Enum WorktreeError 

pub enum WorktreeError {
    NoParent(String),
    GitSpawn(String),
    RemoveFailed(String),
    CreateFailed(String),
    OutsideWorktreesRoot {
        path: String,
        root: String,
    },
    NotAPlainDirectory(String),
    StillRegistered(String),
    ForeignLeftover {
        path: String,
        detail: String,
    },
    RegistrationUnusable {
        path: String,
        detail: String,
    },
    LeftoverUndeletable {
        path: String,
        error: String,
    },
}

Errors from remove_worktree.

Variants

NoParent(String)

The worktree path has no parent directory, so there is no in-repo location to run git worktree remove from.

GitSpawn(String)

git worktree remove could not be spawned at all.

RemoveFailed(String)

git worktree remove ran but exited non-zero (e.g. a dirty worktree without --force, or a transient git error). Carries git’s stderr.

CreateFailed(String)

git worktree add ran but exited non-zero. Carries git’s stderr.

OutsideWorktreesRoot

remove_orphaned_worktree_dir was handed a path that is not a direct child of the repo’s .claude/worktrees root.

Fields

path: String

root: String

NotAPlainDirectory(String)

remove_orphaned_worktree_dir was handed something that is not a plain directory (a file, a symlink, a missing path), so there is nothing safe to delete.

StillRegistered(String)

git still lists the path as a worktree, live or by the stale path a repo move leaves, so it is not a leftover: git may be holding uncommitted work in it. Also returned when the registration cannot be read - refusing is the safe direction.

ForeignLeftover

remove_orphaned_worktree_dir was handed a directory whose .git entry says it belongs to something else - a directory (a checkout of its own, never a worktree tail), a link naming a live foreign repo, or a stale link with no removal this repo recorded. Not this repo’s leftover, so not this repo’s to delete.

Fields

path: String

detail: String

RegistrationUnusable

The registration git lists at the worktree path cannot be reused: its gitdir link names a path the repo has left and git worktree repair could not rewrite it, or it carries a live foreign link that repair would adopt. Either way the worktree is not this spawn’s to use.

Fields

path: String

detail: String

LeftoverUndeletable

The leftover directory itself could not be deleted from disk.

Fields

path: String

error: String

Trait Implementations

impl Debug for WorktreeError

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

Formats the value using the given formatter.

impl Display for WorktreeError

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

Formats the value using the given formatter.

impl Error for WorktreeError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.