Worktrees

Criar um worktree#

1. Em um painel dentro do repositório, clique em Worktree na barra do painel (também disponível na lista de branches).
2. Em Criar a partir de, escolha Branch ou Pull request.
3. Escolha a Branch base (ou o pull request) e informe um nome em Nova branch.
4. Escolha Onde criar e, se quiser, uma nota para a sessão.
5. Clique em Criar. Uma nova sessão abre na pasta do worktree.

Onde ficam os worktrees#

Fora do repositório (padrão)

Os worktrees ficam agrupados em uma pasta com o nome do repositório, por exemplo ~/worktrees/acme-app/feature-login. Informe um caminho absoluto, ~ ou ... Seu .gitignore não é alterado.

Dentro do repositório

Os worktrees ficam em uma pasta dentro do repositório. Se essa pasta ainda não for ignorada, ela é adicionada ao .gitignore da raiz (como uma alteração normal de código).

Copiar arquivos ignorados#

Um worktree novo não tem nenhum dos seus arquivos ignorados pelo git, então normalmente ainda não consegue rodar. Com Arquivos ignorados: Copiar deste checkout (o padrão), o PATerminal copia arquivos como .env, node_modules e .venv do checkout atual para o novo worktree, com um indicador de progresso. Escolha Não copiar para pular essa etapa.

Worktree a partir de um pull request#

Escolha Pull request como origem para listar os pull requests abertos (pelo seu gh). O PATerminal cria um worktree na branch do PR e o abre como uma sessão — ideal para revisar ou corrigir um PR enquanto o seu checkout principal continua trabalhando. Se já existir um worktree para essa branch, ele é reutilizado.

Gerenciar worktrees#

A lista de worktrees na janela do Git mostra cada worktree com a branch e o estado (atual, principal, bloqueado, ausente). Remova um, ou selecione vários e clique em Remover selecionados. Remover um worktree mantém a branch dele; o worktree principal e o atual não podem ser removidos. Quando o Git recusa por causa de mudanças locais, a opção Forçar a remoção é oferecida.

Padrões de worktree#

Configurações → Local padrão do worktree define o local padrão e se os arquivos ignorados são copiados. Ative Automatically fill in the branch name para receber um nome formado pela data, pela hora e por um sufixo aleatório curto. Esses padrões também valem quando um worktree é criado a partir de uma issue ou pelo modo par.