repo
Warum
Alle Klone laufen unter ~/.x-repo/<provider>/<owner>/<name> zusammen. Derselbe Pfad für jeden Agenten, jeden Menschen, jede CI — in Container oder Agent-Sandboxes einbindbar, sodass sie teilen können, ohne neu zu klonen. Eine Wurzel zum Sichern; auffindbar über x repo ls. Das Layout spiegelt die GitHub-Pfade, sodass ../<sibling> von jedem Worktree aus auf den Default-Worktree dieses Geschwisters zeigt — Configs und Skripte, die auf Geschwister verweisen, funktionieren einheitlich über alle Worktrees und Agenten hinweg.
Pfad-Layout
- bare:
~/.x-repo/.bare/<provider>/<owner>/<name>.git - Default-wt:
~/.x-repo/<provider>/<owner>/<name> - benannter wt:
~/.x-repo/<provider>/<owner>/<name>@<wtname>
@<wtname> — wtname ist ein beliebiger Bezeichner für diesen Workspace: Agent-/Worker-Name, Branch-Name, Tag, kurzer SHA, Issue-ID, Freitext-String. / im wtname wird zu ~ kodiert.
Standardmäßig sind Repos bare mit verknüpften Worktrees — das Bare-Repo in .bare/, ein vom Worktree getrenntes Verzeichnis, sodass ein rm -rf eines Worktrees es nicht erreichen kann. Ein einfaches git clone wird ebenfalls akzeptiert (x repo ls/which/update sieht es), aber ohne geometrischen Schutz. Bitte sei in dem Fall vorsichtig: kein rm -rf, lieber git worktree remove, und keine Cleanup-Heuristiken, die auf .git/ zielen. Auf diese Weise verlorene Arbeit lässt sich nicht mehr mit dem Original-Repo abgleichen.
Befehle
x repo <id> # in den Default-wt wechseln (klont automatisch, falls fehlend)
x repo wt <id> <wtname> # an bestehenden Branch anhängen oder neuen aus HEAD anlegen
x repo wt ls <id> # Worktrees auflisten
x repo wt rm <id> <wtname> # schonendes Entfernen (dieses, nicht rm -rf)
x repo update <id> # Default-wt nach Upstream-Änderungen auffrischen
x repo ls [--raw|--tsv] # herausfinden, was geklont ist
x repo which <id>[@<wtname>] # id zum absoluten Pfad auflösen
Nicht tun
- Einen benannten Worktree per
rm -rfentfernen. Das hinterlässt veraltete Einträge imworktrees/-Register des Bare-Repos. Nutzex repo wt rm. Falls es nicht anders geht, führe danachgit -C <bare> worktree pruneaus.
Verwandt
- doc/path-layout.md — vollständige Pfadgrammatik und Worktree-Benennung
- doc/workflow.md — Arbeitsablauf und Prinzipien zum Aufräumen ohne Löschen
- doc/design.md — warum das Layout so geformt ist