Contextes de travail et worktrees
Vous êtes au milieu d'un correctif lorsqu'une demande de revue arrive. Un contexte vous aide à retrouver la même vue et le même brouillon. Un worktree donne à l'autre tâche ses propres fichiers et son index. Choisissez selon ce qui doit rester séparé.
Choisir comment changer de tâche
| Besoin | Solution |
|---|---|
| Retrouver la sélection, les filtres, le défilement et le brouillon de commit d'un onglet pendant la session | Fermer puis reprendre son contexte. |
| Travailler sur une autre révision sans toucher à la copie d'origine | Créer un worktree dans un autre dossier. |
| Mettre temporairement des modifications de côté dans la même copie | Enregistrer un stash nommé, puis le restaurer au moment voulu. Consultez le filet de sécurité. |
Fermer et reprendre un contexte
Ouvrez les contextes de travail pour voir les dépôts ouverts, les contextes récemment fermés et les worktrees trouvés. Vérifiez la branche, la pull request associée, les modifications en attente et le brouillon de commit. Si l'inspection est indisponible ou incomplète, ouvrez le dépôt et vérifiez son état avant d'agir.
Sélectionnez un contexte ouvert et choisissez Fermer le contexte. Lisez la confirmation, surtout si une opération Git est en cours. La fermeture conserve le dépôt, la branche et les fichiers sur disque. Elle ne termine ni n'annule une fusion, un rebase ou une autre opération Git, et ne crée ni n'applique de stash.
Choisissez Reprendre le contexte pour retrouver l'état disponible de l'onglet. Riff garde en mémoire jusqu'à dix contextes récemment fermés dans l'espace de travail actuel. Sélection, filtres, défilement et brouillons appartiennent à la session : redémarrer Riff ou changer d'espace ne conserve pas ce cache. Cela reste distinct de l'ordre enregistré des onglets et de la synchronisation de l'espace.
Créer un worktree séparé
- Sélectionnez un dépôt dans les contextes de travail et choisissez Nouveau worktree.
- Choisissez un dossier vide ou nouveau, en dehors des métadonnées Git. Sélectionnez la révision de départ et, si nécessaire, un nouveau nom de branche conforme aux règles de l'équipe.
- Vérifiez les choix et créez le worktree. Sans nouvelle branche, il s'ouvre avec HEAD détachée. Créez une branche avant de faire des commits à conserver.
- Ouvrez le dossier créé dans Riff. Il possède ses propres fichiers et son index, tout en partageant l'historique Git du dépôt. La limite du plan ou du mode invité peut empêcher l'ouverture d'un dépôt suivi supplémentaire même si Git a créé le worktree ; vérifiez le résultat avant de recommencer.
Pour une pull request, utilisez Ouvrir dans un worktree depuis la revue pour préparer le commit exact examiné. Changer de contexte ne publie pas de commits et ne modifie pas la copie d'origine.
Retirer le worktree à la fin
Faites un commit ou enregistrez le travail nécessaire avant de choisir Supprimer pour le worktree supplémentaire. Riff refuse la suppression s'il trouve des modifications en attente, des fichiers ignorés, une opération en cours, un worktree verrouillé ou l'arbre de travail principal. Examinez les fichiers de compilation ignorés et les autres fichiers avant de décider quoi supprimer.
Si HEAD est détachée, préservez d'abord le commit avec une branche ou une étiquette locale. Le retrait ne supprime pas automatiquement la branche et n'envoie pas les commits. Fermer un contexte masque seulement son onglet ; retirer un worktree supprime son dossier de travail. Gardez cette différence à l'esprit en terminant la tâche.