Struct WorktreeManager 

pub struct WorktreeManager { /* private fields */ }

Manages git worktree operations for a repository.

All commands are run via the git CLI in async subprocesses.

Implementations

impl WorktreeManager

pub fn new(repo_root: &Path) -> Result<Self>

Create a manager for the repository at repo_root.

Verifies that the directory is inside a git repository.

pub fn for_current_repo() -> Result<Self>

Create a manager by auto-detecting the git repo from the current directory (or any directory).

pub fn repo_root(&self) -> &Path

The repository root path.

pub async fn create(&self, opts: &WorktreeCreateOpts) -> Result<WorktreeInfo>

Create a new worktree with the given options.

pub async fn create_worktree( &self, branch: &str, target_path: &Path, start_point: Option<&str>, ) -> Result<WorktreeInfo>

Create a worktree at target_path that checks out branch.

If branch doesn’t exist yet, it is created from start_point (or HEAD).

pub async fn list(&self) -> Result<WorktreeList>

List all worktrees in the repository.

Uses git worktree list --porcelain for machine-readable output.

pub async fn remove(&self, path: &Path, force: bool) -> Result<()>

Remove a worktree by its path.

Fails if the worktree has uncommitted changes unless force is true.

pub async fn remove_by_branch(&self, branch: &str, force: bool) -> Result<()>

Remove a worktree by branch name.

Finds the worktree with the given branch and removes it.

pub async fn prune(&self) -> Result<()>

Prune deleted worktrees (clean up stale administrative files).

pub async fn remove_and_delete_branch( &self, branch: &str, force: bool, ) -> Result<()>

Remove a worktree and delete its branch.

pub async fn force_remove_and_delete_branch(&self, branch: &str) -> Result<()>

Remove a worktree and force-delete its branch (even if unmerged).

pub async fn merge( &self, source_branch: &str, target_branch: &str, ) -> Result<MergeResult>

Merge a worktree’s branch into a target branch.

This checks out target_branch in the main worktree, merges source_branch, and returns the result.

pub async fn merge_and_remove( &self, source_branch: &str, target_branch: &str, ) -> Result<MergeResult>

Merge a worktree’s branch into target_branch, then remove the worktree and delete the source branch.

On merge conflict, the worktree is NOT removed — the caller must resolve conflicts and then call remove_and_delete_branch.

pub async fn branch( &self, branch: &str, target_path: &Path, start_point: Option<&str>, ) -> Result<WorktreeInfo>

Create a new branch + worktree in one operation.

Equivalent to git worktree add -b <branch> <path> [<start-point>].

pub async fn feature(&self, branch: &str) -> Result<WorktreeInfo>

Create a feature worktree: sibling directory named after the branch.

pub async fn hotfix( &self, branch: &str, start_point: &str, ) -> Result<WorktreeInfo>

Create a hotfix worktree: branching off a specific start point.

pub async fn is_dirty(&self, worktree_path: &Path) -> Result<bool>

Check whether a worktree has uncommitted changes.

pub async fn current_branch(&self, worktree_path: &Path) -> Result<String>

Get the current branch name of a worktree.

pub async fn head_commit(&self, worktree_path: &Path) -> Result<String>

Get the commit SHA of HEAD in a worktree.

pub async fn branch_exists(&self, branch: &str) -> Result<bool>

Check if a branch name already exists in the repo.

Trait Implementations

impl Clone for WorktreeManager

fn clone(&self) -> WorktreeManager

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WorktreeManager

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

Formats the value using the given formatter.