Contextos de trabalho e worktrees
Você está no meio de uma correção quando chega um pedido de revisão. Um contexto ajuda a voltar à mesma visualização e ao rascunho. Uma worktree dá à outra tarefa seus próprios arquivos e área de staging. Escolha conforme o que precisa ficar separado.
Escolha como alternar tarefas
| Necessidade | Recurso |
|---|---|
| Voltar à seleção, aos filtros, à rolagem e ao rascunho de commit da aba durante a sessão | Fechar e retomar o contexto. |
| Trabalhar em outra revisão mantendo a cópia original intacta | Criar uma worktree em outra pasta. |
| Guardar edições temporariamente na mesma cópia | Salvar um stash com nome e restaurá-lo quando necessário. Consulte a rede de segurança. |
Feche e retome um contexto
Abra Contextos de trabalho para ver repositórios abertos, contextos fechados recentemente e worktrees encontradas. Confira a branch, o pull request associado, as alterações pendentes e o rascunho de commit. Se a inspeção estiver indisponível ou incompleta, abra o repositório e confira o estado antes de agir.
Selecione um contexto aberto e escolha Fechar contexto. Leia a confirmação, principalmente se houver uma operação Git em andamento. Fechar preserva o repositório, a branch e os arquivos no disco. Não conclui nem cancela merge, rebase ou outra operação Git, e não cria nem aplica stash.
Escolha Retomar contexto para voltar ao estado disponível da aba. O Riff mantém até dez contextos fechados recentes na memória do workspace atual. Seleção, filtros, rolagem e rascunhos são estado da sessão: reiniciar o Riff ou trocar de workspace não preserva esse cache. Isso é separado da ordem salva das abas e da sincronização do workspace.
Crie uma worktree separada
- Selecione um repositório em Contextos de trabalho e escolha Nova worktree.
- Escolha uma pasta vazia ou nova fora dos metadados do Git. Selecione a revisão inicial e, quando necessário, um nome de branch nova que respeite as regras da equipe.
- Confira as opções e crie a worktree. Sem uma branch nova, ela abre com HEAD destacado. Crie uma branch antes de fazer commits que pretende manter.
- Abra a pasta criada no Riff. Ela tem seus próprios arquivos e index, compartilhando o histórico Git do repositório. O limite do plano ou do modo convidado pode impedir abrir outro repositório acompanhado mesmo quando o Git criou a worktree; confira o resultado antes de repetir a criação.
Para um pull request, use Abrir em worktree na revisão para preparar o commit exato examinado. Alternar contextos não publica commits nem altera a cópia original.
Remova a worktree ao terminar
Faça commit ou salve o trabalho necessário antes de escolher Remover na worktree adicional. O Riff recusa a remoção se encontrar alterações pendentes, arquivos ignorados, operação em andamento, worktree bloqueada ou a árvore de trabalho principal. Examine saídas de build ignoradas e outros arquivos antes de decidir o que remover.
Se o HEAD estiver destacado, preserve o commit em uma branch ou tag local primeiro. Remover não exclui automaticamente a branch nem envia commits. Fechar um contexto só oculta sua aba; remover uma worktree remove sua pasta de trabalho. Mantenha essa diferença em mente ao concluir a tarefa.