OpenCode Worktree: parallele Coding-Aufgaben mit Git isolieren

Ein Git-Worktree ist ein weiteres Arbeitsverzeichnis am selben Repository. Der Haupt-Checkout kann auf main bleiben, während ein Nachbarordner work/auth auscheckt. Dateien und aktueller Branch sind getrennt; Git teilt weiterhin Objekte und Verlauf. Deshalb ist meist kein vollständiger Klon pro Aufgabe nötig.

Für diesen Ablauf ist kein spezieller OpenCode-Worktree-Modus nötig. Starten Sie die CLI im neuen Verzeichnis; dieses wird zum Projektkontext. Globale Einstellungen können weiter gelten, aber nicht versionierte Dateien und lokale Umgebungsdaten werden nicht automatisch kopiert.

Prüfen Sie zuerst Branch und Änderungen des aktuellen Checkouts. Ein sauberer Startpunkt hilft, spätere Unterschiede der neuen Aufgabe zuzuordnen. Erstellen Sie vom Repository-Stamm aus einen Branch samt Worktree in einem Nachbarordner außerhalb des ursprünglichen Verzeichnisses.

Das Beispiel legt work/auth am aktuellen Commit an und speichert den Checkout unter ../app-auth. Falls der Branch bereits existiert, prüfen Sie, ob ihn ein anderer Worktree verwendet. Git verhindert normalerweise, denselben Branch gleichzeitig in mehreren verknüpften Worktrees auszuchecken.

Führen Sie die Befehle im Stamm des Haupt-Repositorys aus. Der neue Branch beginnt beim aktuellen Commit.

git status --short --branch
git worktree add -b work/auth ../app-auth
cd ../app-auth
opencode
git worktree list
git -C ../app-auth status --short --branch

Führen Sie nach cd ../app-auth in dieser Shell opencode aus. Das aktuelle Verzeichnis ist die wichtige Grenze: Nutzen Sie pro Worktree ein eigenes Terminal oder eine eigene Sitzung und prüfen Sie den Projektstamm, bevor Dateien geändert werden. Eine erste reine Leseaufgabe kann Branch und zu prüfende Dateien zusammenfassen.

Geben Sie jeder Sitzung eine eng umrissene Aufgabe und notieren Sie den Branch. Ein Checkout kann Authentifizierungstests übernehmen, ein anderer die Dokumentation. Lassen Sie nicht zwei Sitzungen dieselbe Datei oder denselben Ausgabeordner ändern. Getrennte Ordner reduzieren Konflikte, koordinieren Agents aber nicht automatisch.

Ein Worktree trennt Git-Dateien und Index, ist aber weder Container noch Sicherheitsgrenze. Eine lokale Datenbank, ein Testserver, Cache, Docker-Projekt oder externes Konto kann weiterhin gemeinsam genutzt werden. Trennen Sie bei Bedarf Schema, Port, Projektnamen oder eine wegwerfbare Umgebung.

Git checkt die verfolgten Dateien des gewählten Commits aus. .env, Zertifikate, Cache und ignorierte Build-Ausgaben fehlen im neuen Worktree möglicherweise. Richten Sie nur die nötige Umgebung ein, laden Sie Geheimnisse über den freigegebenen Weg und prüfen Sie git status --short --branch vor und nach der Agent-Arbeit.

Prüfen Sie den Worktree-Branch als eigenständige Änderung. Sehen Sie git diff durch, führen Sie Projektprüfungen in diesem Verzeichnis aus und bestätigen Sie, dass nur erwartete Dateien enthalten sind. Führen Sie nach bestandenen Tests gemäß Teamprozess zusammen oder rebasen Sie. Änderungen erscheinen erst nach geteilten Commits in anderen Checkouts.

Suchen Sie vor dem Entfernen nach nicht bestätigten Änderungen und entscheiden Sie, ob sie commit, stash oder erhalten werden. git worktree remove ../app-auth entfernt einen sauberen Checkout; bei Änderungen verweigert Git dies ohne Force-Option. Nutzen Sie Force nicht als normale Bereinigung. git worktree prune entfernt veraltete Einträge, keine aktiven Verzeichnisse.

Ein Worktree eignet sich für getrennte Branches, Dateistände oder Review-Grenzen, die Stunden oder Tage bestehen bleiben. Für reine Recherche oder Aufgaben, die aktuelle nicht bestätigte Dateien lesen müssen, ist eine weitere Sitzung im selben Checkout einfacher. Bei aufeinanderfolgenden Aufgaben reicht ein Branch-Wechsel.

Ein Worktree bringt zusätzliche Verwaltung für Branch-Namen, Abhängigkeiten, Dienste, Tests, Zusammenführung und Bereinigung. Ändern mehrere Agents dieselben Dateien, kann die spätere Integration schwieriger werden. Teilen Sie die Arbeit zuerst in getrennte Änderungen auf oder führen Sie die Bearbeitung nacheinander aus.

Meldet git worktree add, dass ein Branch bereits ausgecheckt ist, prüfen Sie git worktree list und wählen einen neuen Branch oder den bestehenden Worktree. Zeigt OpenCode unerwartete Dateien, prüfen Sie erst Terminalpfad und Projektstamm. Ignorierte und nicht verfolgte Dateien gehören nicht zum Checkout.

Stören sich Tests zwischen Sitzungen, suchen Sie außerhalb von Git: Datenbanken, Ports, temporäre Ordner, Generatoren und gemeinsam genutzte Caches sind typische Ursachen. Wenn das Entfernen scheitert, führen Sie git status im Worktree aus und sichern nötige Änderungen. Lassen Sie den Haupt-Checkout für die Integration bestehen.