repo
Pourquoi
Tous les clones convergent vers ~/.x-repo/<provider>/<owner>/<name>. Même chemin pour chaque agent, humain, CI — montable dans des conteneurs ou des sandbox agents pour partager sans re-cloner. Une racine à sauvegarder ; découvrable via x repo ls. La disposition reflète les chemins github de sorte que ../<sibling> depuis n'importe quel worktree résolve vers le worktree par défaut de ce sibling — les configs et scripts qui référencent des siblings fonctionnent uniformément à travers les wts et les agents.
Disposition des chemins
- bare :
~/.x-repo/.bare/<provider>/<owner>/<name>.git - wt par défaut :
~/.x-repo/<provider>/<owner>/<name> - wt nommé :
~/.x-repo/<provider>/<owner>/<name>@<wtname>
@<wtname> — wtname est n'importe quel identifiant pour ce workspace : nom d'agent/worker, nom de branche, tag, SHA court, id d'issue, chaîne libre. / dans wtname s'encode en ~.
Par défaut, les repos sont bare avec des worktrees liés — le bare dans .bare/, un répertoire séparé des worktrees, de sorte qu'un rm -rf d'un wt ne puisse pas l'atteindre. Un git clone classique est aussi accepté (x repo ls/which/update le voit) mais sans la protection géométrique. Dans ce cas, soyez prudent : évitez rm -rf, préférez git worktree remove, et évitez les heuristiques de nettoyage qui visent .git/. Le travail de mi-tâche perdu ainsi ne peut pas être réaligné avec le repo d'origine.
Commandes
x repo <id> # cd vers le wt par défaut (auto-clone si manquant)
x repo wt <id> <wtname> # attacher à une branche existante, ou en créer depuis HEAD
x repo wt ls <id> # lister les wts
x repo wt rm <id> <wtname> # suppression gracieuse (utilisez ceci, pas rm -rf)
x repo update <id> # rafraîchir le wt par défaut après changements upstream
x repo ls [--raw|--tsv] # découvrir ce qui est cloné
x repo which <id>[@<wtname>] # résoudre id vers chemin absolu
À ne pas faire
rm -rfun worktree nommé. Ça laisse des entrées obsolètes dans le registreworktrees/du bare. Utilisezx repo wt rm. Si vous devez, lancezgit -C <bare> worktree pruneensuite.
Related
- doc/path-layout.md — grammaire complète des chemins et nommage des worktrees
- doc/workflow.md — procédure opérationnelle et principes de non-suppression de nettoyage
- doc/design.md — pourquoi la disposition est ainsi formée