Benutzerhandbuch

Erstellen von Sitzungen und Zusammenarbeit in Git

Zwei Funktionen, die zusammenarbeiten: Das Erstellen von Unteraufgaben in unabhängigen Kindersitzungen mithilfe von vspawn (optional in isolierten git Worktrees) sowie eine grafische Verschmelzung, um parallele Branches wieder zusammenzuführen. Gemeinsam machen sie es möglich, dass „mehrere Agenten gleichzeitig am selben Repo arbeiten“, zu einem alltäglichen Workflow.

1. Was das Erstellen bedeutet

Von innen aus jeder Sitzung aus kann eine Unteraufgabe abgetrennt werden: VelaTerm erstellt eine neue Kindersitzung unter dem aktuellen Knoten (der Baum wird hierarchisch: Elternteil → Kind → Enkelkind), gibt ihr optional einen isolierten git Worktree und übernimmt die Aufgab Beschreibung als die erste Nachricht **** der neuen Sitzung – der neue Agent beginnt sofort mit der Arbeit, ohne erneute Erklärung nötig zu sein.

Was dabei herauskommt, ist eine echte Sitzung im Baum – mit eigenem Prozess, vollständig interaktiv und wiederaufnahmefähig –, die Sie jederzeit beobachten oder betreten können. Es handelt sich dabei nicht um eine versteckte Hintergrundaufgabe.

2. Vier Eingangspunkte

EingangWer es verwendetWorktree
Terminal-Befehl vspawn "task"Sie, in jeder SitzungStandardmäßig ausgeschaltet; --worktree schaltet es ein
Terminal-Befehl vspawn-tree "task"DasselbeImmer eingeschaltet
/vspawn task in einem Claude-GesprächClaude erzeugt sie (und erweitert die Aufgabe zu einem umfassenden, selbstständigen Prompt)Standardmäßig ausgeschaltet
/vspawn-tree task in einem Claude-GesprächDasselbeImmer eingeschaltet

Die beiden Terminal-Befehle werden automatisch in die PATH jeder Sitzung eingefügt – ohne Installation.

Voraussetzung für die /-Fähigkeiten: Damit Claude /vspawn oder /vspawn-tree verwenden kann (oder eigenständig Unter-Sitzungen erstellen kann), muss Vela Skills in Einstellungen ▸ Allgemein aktiviert werden. Dadurch werden die /vspawn, /vspawn-tree und /vopen-Fähigkeiten als Bundle in ~/.claude/skills/ installiert; sie werden bei App-Updates automatisch aktualisiert. Nach der Aktivierung sollten Sie eine neue Claude-Sitzung starten (oder eine bestehende neu starten), damit der Agent die Fähigkeiten herunterlädt. Ohne das weiß Claude einfach nicht um diese Befehle – nur die im Terminal eingegebenen vspawn / vspawn-tree funktionieren.

3. Bestätigung vor Erstellen

Standardmäßig zeigt jede Erstellung zunächst eine Bestätigungskarte an (oben rechts, nicht modaler Dialog, nimmt den Fokus nicht weg):

Bestätigungskarte für das Erstellen

  • Drei bearbeitbare Felder: der Prompt (mehrliniig), der Agent-Typ (standardmäßig der des Elternteils) und getrennter git Worktree.
  • „Starten“ beginnt die Kindersitzung; „Abbrechen“ lehnt die Anfrage ab. Wenn ein Agent mehrere gleichzeitig erstellt, werden die Karten nacheinander bearbeitet (die verbleibende Anzahl wird auf der Karte angezeigt).
  • Falls Sie die Bestätigung ganz überspringen möchten, deaktivieren Sie „Bestätigung vor Erstellen“ in Einstellungen ▸ Verhalten.

4. Worktrees: Parallelität ohne gegenseitige Störung

Mit aktivierter Worktree-Option arbeitet die Kindersitzung an einer neuen Branch in ihrem eigenen Arbeitsverzeichnis – isoliert vom Hauptarbeitsbereich sowie von anderen Kindern. Das ist die richtige Struktur für Multi-Agent-Parallelität. Die Verwaltung erfolgt über das Kontextmenü der Sitzung unter „Worktree ▸“: Änderungen ansehen, das Worktree-Verzeichnis kopieren/öffnen, das Worktree löschen (mit optionaler Zwangslöschung unkommitierter Änderungen).

Das Erstellen aus einem nicht-git-Verzeichnis funktioniert weiterhin; es greift dann auf das Verzeichnis des Elternteils zurück, ohne Worktree.

5. Verschmelzung: grafische Git-Verschmelzung

Sobald die Arbeit abgeschlossen ist, wird sie zusammengeführt. Jede Sitzung, deren Arbeitsverzeichnis ein git-Repo ist (mit oder ohne Worktree): Rechtsklick → „Git ▸ Verschmelzen…“ öffnet das Verschmelzungsdialogfeld:

  • Sie wählen sowohl die Quell- als auch die Ziel-Branch aus, und können die Richtung wechseln – eine Branch eines Kindes in die Haupt-Branch verschmelzen oder die Haupt-Branch in die des Kindes ziehen, um dessen Baseline zu aktualisieren – alles aus demselben Dialogfeld.
  • Die Verschmelzung wird im Arbeitsbaum durchgeführt, in dem die Ziel-Branch ausgecheckt ist; falls im Quellbaum unkommitierte Änderungen vorhanden sind, werden diese zuerst kommittiert, damit nichts verloren geht.
  • Bei Konflikten bleibt die Situation unverändert, damit Sie (oder ein Agent) sie im Terminal lösen und fortfahren können.

Die Verschmelzung löscht den Worktree nicht automatisch – räumen Sie ihn nach Abschluss über „Worktree ▸ Worktree löschen…“ auf, sobald Sie sicher sind.

6. Ein typischer Workflow

  1. In der Haupt-Sitzung lässt Claude die Aufgabe analysieren und dann /vspawn-tree refactor the checkout module nutzen, um sie zu erstellen (erfordert Vela Skills – siehe §2).
  2. Überprüfen Sie den Prompt auf der Bestätigungskarte und klicken Sie auf Starten – das Kind startet in seinem eigenen Worktree, der im Seitenbereich unter seinem Elternteil sichtbar ist und dessen Punkt grün wird.
  3. Sie arbeiten weiter in der Haupt-Sitzung; wenn das Kind etwas fragt oder fertig ist, wird sein Punkt gelb und es erscheint eine Benachrichtigung.
  4. Gehen Sie dazu über, es zu überprüfen, und klicken Sie anschließend rechtsklick → „Git ▸ Verschmelzen…“, um seine Branch wieder in die Haupt-Branch zu verschmelzen.
  5. „Worktree ▸ Worktree löschen…“, um aufzuräumen, und archivieren Sie anschließend die Kindersitzung zur Dokumentation.