Ein Git-Worktree ist eine separate Kopie deines Repositorys auf einem eigenen Branch. Er nutzt dieselbe Git-Historie wie dein Haupt-Repo, hat aber eigene Dateien in einem eigenen Ordner. Du kannst beliebig viele gleichzeitig öffnen.
welches Problem Worktrees lösen
Normalerweise ist dein Repo ein Ordner, in dem ein Branch ausgecheckt ist. Willst du gleichzeitig an zwei Features arbeiten, musst du deine Änderungen stashen, den Branch wechseln, die andere Arbeit erledigen, zurückwechseln und den Stash wieder anwenden. Das nervt.
Mit Worktrees bekommst du einen zweiten Ordner, in dem bereits ein anderer Branch ausgecheckt ist. Arbeite in einem Ordner an Feature A und im anderen an Feature B. Kein Stashen, kein Wechseln. Beides existiert gleichzeitig.
warum das für KI-Agenten wichtig ist
Wenn du zwei KI-Agenten im selben Ordner ausführst, überschreiben sie gegenseitig ihre Änderungen. Agent A bearbeitet auth.ts. Agent B bearbeitet ebenfalls auth.ts. Wer zuletzt speichert, gewinnt. Die Arbeit des anderen Agenten ist weg.
Worktrees lösen das. Jeder Agent bekommt einen eigenen Ordner, einen eigenen Branch und eine eigene Kopie der Dateien. Beide können gleichzeitig auth.ts bearbeiten, ohne sich in die Quere zu kommen. Wenn sie fertig sind, mergst du jeden Branch einzeln.
so sieht es auf der Festplatte aus
my-project/ ← your main repo (main branch)
../my-project-feature-a/ ← worktree (feature-a branch)
../my-project-feature-b/ ← worktree (feature-b branch)
Alle drei Ordner teilen dieselbe Git-Historie. Änderungen, die in einem Worktree committet wurden, sind nach dem Merge in den anderen sichtbar. Nicht committete Dateiänderungen sind aber vollständig isoliert.
so automatisiert Pane das
Du musst keine Git-Befehle selbst ausführen. Wenn du einen neuen Pane in Pane erstellst:
Pane erstellt den Worktree und den Branch für dich.
Pane kopiert deine Umgebungsvariablen, node_modules und andere wichtige Verzeichnisse. Dein Agent kann sofort loslegen.
Wenn du den Pane archivierst, räumt Pane den Worktree automatisch auf.
der manuelle Weg, als Referenz
So würdest du es ohne Pane machen:
git worktree add ../feature-a feature-a
cd ../feature-a
claude # start your agent here
# when done:
git worktree remove ../feature-a
Ein Git-Worktree ist ein separater Checkout deines Repositorys. Er hat einen eigenen Ordner, einen eigenen Branch und eigene Dateien. Die Git-Historie teilt er mit deinem Haupt-Repo. Du kannst mehrere Worktrees gleichzeitig öffnen, jeweils auf einem anderen Branch.
Ein Branch ist nur ein Zeiger auf einen Commit. In einem Ordner kann immer nur ein Branch ausgecheckt sein. Ein Worktree gibt dir einen zweiten, dritten oder vierten Ordner. In jedem ist ein eigener Branch ausgecheckt. Du kannst die Dateien in allen Ordnern gleichzeitig bearbeiten.
Ein Klon kopiert das gesamte Repository samt Git-Historie. Ein Worktree teilt die Git-Historie mit deinem ursprünglichen Repo. Deshalb braucht er fast keinen zusätzlichen Speicherplatz und bleibt automatisch synchron.
Wenn zwei Agenten im selben Ordner an denselben Dateien arbeiten, überschreiben sie gegenseitig ihre Änderungen. Worktrees geben jedem Agent eine eigene, isolierte Kopie. Agent A kann auth.ts in einem Worktree bearbeiten, während Agent B auth.ts in einem anderen bearbeitet. Sie arbeiten auf verschiedenen Branches und kommen sich nicht in die Quere.
Ja. Wenn du einen neuen Pane mit aktivierten Worktrees erstellst, führt Pane git worktree add für dich aus. Pane richtet den Branch ein, kopiert deine Umgebungsvariablen und node_modules und räumt alles auf, wenn du den Pane archivierst.
Ja. Deaktiviere im Dialog „New Pane“ die Option „Use Worktrees“. Der Agent läuft dann in deinem Haupt-Worktree statt auf einem isolierten Branch. Das eignet sich für schnelle Einzelaufgaben, bei denen Isolation keine Rolle spielt.
Ja. Jeder Worktree enthält das vollständige Monorepo. So können Agenten parallel an verschiedenen Paketen arbeiten. Weise jedem Agent den Ordner seines Pakets zu, damit sie sich nicht in die Quere kommen.
Windows SmartScreen-WarnungBei direkten Downloads kann eine SmartScreen-Warnung erscheinen, solange Pane unsigniert ist. Pane ist vollständig Open Source. Du kannst den Code prüfen und die App selbst aus dem Quellcode bauen.1. Klicke auf Weitere Informationen2. Klicke auf Trotzdem ausführen3. Fahre mit der Installation fortDie PowerShell-Installation lädt das offizielle Release direkt herunter und umgeht die meisten Browser-Hürden.globale npm-Installation
