Worktrees

Ein Worktree checkt einen anderen Branch desselben Repositorys in einen eigenen Ordner aus. Mit einem Worktree pro Agent können mehrere Agenten gleichzeitig am selben Projekt arbeiten, ohne sich gegenseitig die Dateien zu bearbeiten. PATerminal erstellt den Worktree und öffnet ihn in einem Schritt als neue Sitzung.

Geschrieben für PATerminal v1.8.3

Einen Worktree erstellen

  1. Klicke in einem Bereich innerhalb des Repositorys in der Bereichsleiste auf Worktree (auch in der Branch-Liste verfügbar).
  2. Wähle unter Erstellen aus entweder Branch oder Pull Request.
  3. Wähle den Basis-Branch (bzw. den Pull Request) und gib unter Neuer Branch einen Namen ein.
  4. Wähle den Ablageort und optional eine Sitzungsnotiz.
  5. Klicke auf Erstellen. Im Ordner des Worktrees öffnet sich eine neue Sitzung.

Wo Worktrees abgelegt werden

Außerhalb des Repositorys (Standard)
Worktrees werden in einem nach dem Repository benannten Ordner gesammelt, z. B. ~/worktrees/acme-app/feature-login. Gib einen absoluten Pfad, ~ oder .. ein. Deine .gitignore bleibt unberührt.
Innerhalb des Repositorys
Worktrees landen in einem Ordner innerhalb des Repositorys. Wird dieser Ordner noch nicht ignoriert, wird er zur .gitignore im Stammverzeichnis hinzugefügt (als normale Quellcode-Änderung).

Ignorierte Dateien kopieren

Einem frischen Worktree fehlen alle von Git ignorierten Dateien, daher lässt er sich meist noch nicht ausführen. Mit Ignorierte Dateien: Aus diesem Checkout übernehmen (Standard) kopiert PATerminal Dateien wie .env, node_modules und .venv aus dem aktuellen Checkout in den neuen Worktree – mit Fortschrittsanzeige. Wähle Nicht übernehmen, um das zu überspringen.

Worktree aus einem Pull Request

Wähle Pull Request als Quelle, um offene Pull Requests aufzulisten (über dein gh). PATerminal erstellt einen Worktree auf dem Branch des PRs und öffnet ihn als Sitzung – ideal, um einen PR zu prüfen oder zu korrigieren, während dein Haupt-Checkout weiterarbeitet. Ein vorhandener Worktree für diesen Branch wird wiederverwendet.

Worktrees verwalten

Die Worktree-Liste im Git-Fenster zeigt jeden Worktree mit Branch und Zustand (aktuell, Haupt-Worktree, gesperrt, fehlend). Entferne einen einzelnen oder wähle mehrere aus und klicke auf Auswahl entfernen. Beim Entfernen eines Worktrees bleibt sein Branch erhalten; der Haupt-Worktree und der aktuelle Worktree lassen sich nicht entfernen. Entfernen erzwingen wird angeboten, wenn Git wegen lokaler Änderungen ablehnt.

Worktree-Standards

Unter Einstellungen → Standardort für Worktrees legst du den Standardort fest und ob ignorierte Dateien kopiert werden. Aktiviere Automatically fill in the branch name, um einen Namen aus Datum, Uhrzeit und einem kurzen Zufallssuffix zu erhalten. Diese Standards gelten auch, wenn ein Worktree aus einem Issue oder vom Pair-Modus erstellt wird.

Kommst du nicht weiter?

Schau in die FAQ oder schreib uns eine E-Mail mit deinem Betriebssystem, deiner PATerminal-Version und dem, was du schon versucht hast. Wir antworten auf jede Nachricht.

Zur FAQSupport per E-Mail