Method Remove

pkg/worktree/worktree.go:303–313

Remove deletes the worktree's directory and its branch, discarding any uncommitted changes, untracked files, and commits. Callers decide when removal is appropriate (e.g. only for worktrees they created, never pre-existing ones).

(ctx context.Context)

// removal is appropriate (e.g. only for worktrees they created, never
// pre-existing ones).
func (wt *Worktree) Remove(ctx context.Context) error {
	if err := git(ctx, wt.SourceDir, "worktree", "remove", "--force", wt.Dir); err != nil {
		return fmt.Errorf("removing git worktree: %w", err)
	}
	// The branch can only be deleted once the worktree no longer occupies it;
	// -D discards unmerged commits, which is the intended "remove and forget".
	if err := git(ctx, wt.SourceDir, "branch", "-D", wt.Branch); err != nil {
		return fmt.Errorf("deleting worktree branch: %w", err)
	}
	return nil
}

// validateName rejects names that would escape the worktrees directory or
// produce an invalid git branch. Names must be a single path segment made of