Method setupWorktree

cmd/root/run.go:581–622

setupWorktree creates the git worktree requested by --worktree or --worktree-pr, returning nil when neither was given. The returned worktree (when non-nil) becomes the session's working directory and is cleaned up when an interactive run ends.

(ctx context.Context, wd string)

// (when non-nil) becomes the session's working directory and is cleaned up
// when an interactive run ends.
func (f *runExecFlags) setupWorktree(ctx context.Context, wd string) (*worktree.Worktree, error) {
	switch {
	case f.worktreePR != "":
		wt, err := worktree.CreatePR(ctx, wd, f.worktreePR)
		if err != nil {
			switch {
			case errors.Is(err, worktree.ErrNotGitRepository):
				return nil, fmt.Errorf("--worktree-pr requires %s to be inside a git repository", wd)
			case errors.Is(err, worktree.ErrInvalidPRRef):
				return nil, fmt.Errorf("invalid --worktree-pr value: %w", err)
			case errors.Is(err, worktree.ErrGHNotFound):
				return nil, fmt.Errorf("--worktree-pr requires the GitHub CLI: %w", err)
			default:
				return nil, err
			}
		}
		return wt, nil

	case f.worktree:
		name := f.worktreeName
		if name == worktreeAutoName {
			name = ""
		}
		wt, err := worktree.Create(ctx, wd, name, worktree.WithBase(f.worktreeBase))
		if err != nil {
			switch {
			case errors.Is(err, worktree.ErrNotGitRepository):
				return nil, fmt.Errorf("--worktree requires %s to be inside a git repository", wd)
			case errors.Is(err, worktree.ErrInvalidName):
				return nil, fmt.Errorf("invalid --worktree name: %w", err)
			case errors.Is(err, worktree.ErrInvalidBase):
				return nil, fmt.Errorf("invalid --worktree-base: %w", err)
			default:
				return nil, err
			}
		}
		return wt, nil

	default:
		return nil, nil
	}
}

// cleanupWorktree removes a worktree created for an interactive run once it
// ends. A clean worktree (no uncommitted changes, untracked files, or new