Schnellstart

Das setzt voraus, dass Wyrm installiert ist und du angemeldet bist. Die Kürzel gelten für macOS.

1. Ein Repository öffnen

Nach der Anmeldung zeigt Wyrm Öffne ein Repository, um zu beginnen mit drei Buttons:

Öffnen… (⌘O): ein Ordner, den du schon hast, Git oder jj.
Klonen… (⌘⇧O): ein Repository von GitHub, GitLab oder einer beliebigen Git-URL auf deinen Mac kopieren.
Neues Repository… (⌘⇧N): ein neues Repository in einem leeren oder vorhandenen Ordner anlegen.

Dein vorhandenes Git-Repository

Öffnest du einen reinen Git-Ordner, fragt Wyrm zuerst mit Git-Repository erkannt: „Dies ist ein Git-Repository. Wyrmflow initialisiert jujutsu neben Git, damit du beide Werkzeuge nutzen kannst.“ Klicke auf Repository öffnen.

Was dabei passiert:

Es wird ein .jj/-Ordner neben .git/ angelegt. Dein .git/, deine Branches und deine Historie bleiben, wie sie sind.
.jj/ blendet sich mit einer eigenen Ignore-Datei aus git status aus. Die .gitignore deines Projekts wird nicht geändert, es gibt also nichts Neues zu committen.
Für dein Team ändert sich nichts. Alle nutzen weiter Git; was du pushst, sind ganz normale Git-Commits und -Branches.
Du kannst im selben Ordner weiterhin git ausführen. Rechne damit, dass git status einen detached HEAD meldet: So teilen sich jj und Git einen Ordner.

2. Das Log lesen

Das Log ist deine Historie als Graph, das Neueste oben. Jede Zeile ist ein Commit: seine Change-ID, seine Beschreibung, Autor und Alter. Die Zeile mit dem grünen Ring ist @, deine Working Copy. In jj sind die Dateien, die du bearbeitest, immer ein Commit, es gibt also keinen separaten Bereich für „nicht committete Änderungen“.

Klicke auf eine Zeile, um ihre Änderungen im Revisionsbereich zu sehen. Mit ↑ / ↓ bewegst du dich durch das Log, mit G springst du zurück zu @. Mehr dazu unter Log-Graph.

3. Etwas ändern

Bearbeite eine Datei in deinem Editor und speichere. Wyrm übernimmt die Änderung in @; die Zeile aktualisiert sich und die Datei erscheint in ihren Änderungen. Es gibt nichts zu stagen.

4. Beschreiben

Wähle @ aus und tippe im Revisionsbereich eine Nachricht in Diese Änderung beschreiben…, dann drücke ↩, um sie zu speichern. D öffnet dasselbe als Dialog, Beschreibung bearbeiten.

Wenn die Änderung fertig ist, drücke ⌘↩ (oder klicke auf Änderung abschließen). Dabei läuft jj commit: Deine Nachricht bleibt an diesem Commit, und obendrauf beginnt ein neues, leeres @ für das nächste Stück Arbeit. Um einen neuen Commit auf einem beliebigen anderen Commit zu beginnen, wähle diesen aus und drücke N (oder ⌘N, Neues Kind).

5. Pushen, mit Vorschau

Zu Git-Remotes werden Bookmarks gepusht (jjs Name für Branches).

Wähle den Commit aus, den du gerade abgeschlossen hast, und drücke B (Lesezeichen erstellen…). Gib ihm einen Namen wie fix-typo.
Klicke in der oberen Leiste auf Push. Noch wird nichts gesendet: Wyrm öffnet Push nach origin und listet jedes Bookmark mit dem, was damit passieren wird: Neu, Aktualisierung, Löschen oder Divergiert, wenn dein Bookmark und das auf dem Remote auseinandergelaufen sind.
Lies es durch und klicke dann auf 1 Lesezeichen pushen.

Die Vorschau vergleicht mit dem letzten Fetch, klicke also zuerst auf Fetch, falls dein Team gepusht haben könnte. Details unter Push-Vorschau. Wie du aus dem Bookmark einen Pull Request öffnest, steht unter Pull- & Merge-Requests.

6. Rückgängig machen

Klicke in der oberen Leiste auf Undo oder drücke ⌘Z. In jj wirkt Undo auf Operationen: ein Describe, ein Rebase, ein Abandon. Undo holt keine Commits zurück, die schon auf dem Remote sind. Jedes Undo geht einen Schritt weiter zurück, ⌘⇧Z stellt wieder her. Das Panel Operationen in der Icon-Leiste listet jede Operation, und du kannst das Repository auf jede davon zurücksetzen. Siehe Rückgängig & Operations-Log.

Nächste Schritte

Git → jj, Schritt für Schritt: jede Git-Gewohnheit neben ihrem jj-Gegenstück.
Historie bearbeiten: Änderungen aufteilen, squashen, absorbieren und verschieben.
Tastaturkürzel: Drücke ? in der App für dieselbe Liste.