KI-Agentensitzungen

Dieses Kapitel beschreibt, wie VelaTerm KI-Coding-Agenten als eigene Sitzungstypen ausführt: unterstützte Agenten, Live-Status, automatisches Fortsetzen von Gesprächen, Importieren und Forken von Gesprächen, Berechtigungsmodi, Starteinstellungen, Installationshilfe und das Infopanel. Die Gesprächsansicht hat ein eigenes Kapitel: Gesprächsansicht.

1. Unterstützte Agenten

VelaTerm kann diese Agenten starten: Claude Code (angezeigt als „Claude“), Codex, OpenCode, Copilot, Cursor, Antigravity, Cline, Pi, OMP, Crush, Kimi Code, Kiro, Grok Build und Zoo Code. Die CLI des jeweiligen Agenten muss installiert und angemeldet sein.

Die Fähigkeiten unterscheiden sich je nach Agent:

• Vom Agenten gemeldet bedeutet, dass der Agent VelaTerm selbst mitteilt, wann er zu arbeiten beginnt, wann er Sie braucht und wann er fertig ist; der Status ist daher exakt. Codex meldet jede Phase, sofern seine Version Lifecycle-Hooks unterstützt; ältere Codex-Versionen melden nur das Ende eines Durchlaufs. Steht in der Spalte „Wartet auf Sie“ ein ✗, meldet der Agent keine Fragen oder Berechtigungsabfragen; die Sitzung zeigt dann bis zum Ende des Durchlaufs den Status „Arbeitet“.
• Vom Bildschirm gelesen bedeutet, dass VelaTerm den Zustand des Agenten an dessen Terminaloberfläche erkennt.
• Bei Copilot, Cursor, Antigravity, Kimi Code, Kiro und Grok Build fügt VelaTerm beim ersten Start einer solchen Sitzung eigene Einträge in die Benutzerkonfiguration des Agenten ein. Läuft der Agent außerhalb von VelaTerm, bewirken diese Einträge nichts.
• Agenten, die Sie selbst in einem normalen Terminal starten, sind davon nicht betroffen; die Statusmeldung gilt nur für Agentensitzungen, die VelaTerm startet.

2. Eine Agentensitzung erstellen

• Kontextmenü. Klicken Sie mit der rechten Maustaste auf ein Projekt, eine Gruppe oder eine Sitzung. Die erste Menüebene bietet drei Agenten an: anfangs Claude, Codex und OpenCode, später die drei Agententypen, die Sie zuletzt erstellt haben. „Weitere Agent-Sitzung“ listet alle Agenten, Ihre gespeicherten Vorlagen, „Neu mit Startargumenten…“ und „Neue Agentensitzung“ (die durchsuchbare Auswahl) auf.
• Auswahl für neue Agentensitzungen. ⌘N unter macOS (Ctrl+Alt+N unter Windows, Linux und in normalen Browsern) öffnet eine durchsuchbare Liste von Agenten und Vorlagen; zuletzt gewählte Einträge sind mit „Zuletzt verwendet“ gekennzeichnet. Siehe Einstellungen und Tastenkürzel §9.
• Untersitzungen. Das Untermenü „Neue Untersitzung“ einer Sitzung erstellt die neue Sitzung unterhalb dieser Sitzung. Sitzungen lassen sich auch aus einem Gespräch heraus starten; siehe Untersitzungen und Git-Zusammenarbeit.

Neu mit Startargumenten… öffnet einen Dialog mit dem Agententyp („Agententyp“), einem optionalen Namen („Sitzungsname (leer = automatisch)“), „Startargumente (optional)“, „Programmdatei (optional)“ für eine abweichende Programmdatei, die nur diese Sitzung verwendet, der Berechtigungseinstellung, „Öffnet in“ („Terminalansicht“ oder „Gesprächsansicht“) für Agenten, die beide Ansichten unterstützen, sowie einer Auswahl für „Worktree“. „Als Vorlage speichern“ speichert die Einstellungen unter einem Namen, optional mit einem Symbol. Vorlagen erscheinen im Menü und in der Auswahl und starten mit der gespeicherten Programmdatei, den gespeicherten Argumenten und der gespeicherten Berechtigungseinstellung.

Sitzungen mit Claude, Codex, OpenCode, Pi und OMP öffnen sich standardmäßig in der Gesprächsansicht, die übrigen Agenten in der Terminalansicht. Einstellungen ▸ Agenten ▸ „Standardansicht“ ändert dies je Agent.

3. Statuspunkte: wer arbeitet, wer Sie braucht

Der Punkt neben jeder Agentensitzung wird laufend aktualisiert:

Wenn ein Agent für Sie anhält (wegen einer Frage, einer Berechtigungsanfrage oder am Ende eines Durchlaufs), erhalten Sie eine Systembenachrichtigung, die Sitzung wird als ungelesen markiert, und das Kennzeichen am Dock-Symbol zählt sie mit. Sehen Sie sich diese Sitzung bereits an, erscheint keine Benachrichtigung. Im signierten macOS-Build öffnet ein Klick auf eine Benachrichtigung die Sitzung. Der Eintrag „Notify: On/Off“ in der Statusleiste schaltet Systembenachrichtigungen ein oder aus; Ungelesen-Markierungen und Kennzeichen bleiben bestehen. Sind Kennzeichen vorhanden, zeigt der Kopfbereich der Seitenleiste eine Schaltfläche, die alle entfernt.

Die Zähler „Aktiv“, „Ausstehend“ und „Gesehen“ in der Statusleiste filtern die Seitenleiste auf Sitzungen in diesem Zustand; siehe Oberfläche und Sitzungsverwaltung §6.

4. Automatisches Fortsetzen: schließen, wieder öffnen, weiterarbeiten

Das Grundprinzip in einem Satz: Jeder Agentensitzungsknoten im Baum ist ein fortlaufendes Gespräch.

• Beim ersten Start merkt sich VelaTerm die eigene Gesprächs-ID des Agenten.
• Danach wird beim erneuten Öffnen des Knotens dasselbe Gespräch fortgesetzt, ganz gleich, ob Sie den Tab geschlossen oder die App beendet haben. Vor dem Fortsetzen prüft VelaTerm, ob das Gespräch noch existiert; wurde es gelöscht, startet die Sitzung neu, statt mit einem Fehler abzubrechen.
• Für ein neues Gespräch legen Sie einen neuen Sitzungsknoten an. In der Gesprächsansicht ersetzt /clear die Sitzung an derselben Stelle durch eine neue, leere Sitzung.

Sitzung fortsetzen… am Ende des Menüs „Neue Sitzung“ fügt ein bereits vorhandenes Gespräch hinzu, zum Beispiel eines, das Sie in einem normalen Terminal geführt haben. Wählen Sie den „Agententyp“, fügen Sie die Gesprächs-ID des Agenten ein und wählen Sie „Fortsetzen & öffnen“. Jeder Agententyp aus §1 lässt sich auf diese Weise fortsetzen.

Sitzungen importieren… im Kontextmenü eines Projekts listet vorhandene Gespräche von Codex, Claude, OpenCode und Kiro auf, deren Arbeitsverzeichnis genau das Projektverzeichnis ist. Suchen Sie nach Titel, Agent oder Sitzungs-ID („Nach Titel, Agent oder Sitzungs-ID suchen“), markieren Sie die gewünschten Zeilen und wählen Sie „Importieren“. Die Gespräche werden in den Projektbaum aufgenommen; öffnen Sie eines, um es fortzusetzen. Beim Importieren wird der eigene Verlauf des Agenten weder kopiert noch verändert. Gespräche, die bereits in VelaTerm vorhanden sind, auch archivierte, sind mit „Bereits importiert“ gekennzeichnet. Gespräche in Unterverzeichnissen oder separaten Worktrees erscheinen nur, wenn das betreffende Verzeichnis als eigenes Projekt geöffnet ist. Der Kiro-Verlauf lässt sich für reine Textaufzeichnungen anzeigen. Sind Sie mit einem VelaTerm auf einem Remote-Rechner verbunden, stammt die Liste von diesem Rechner.

5. Forken: ein Gespräch abzweigen

Bei Sitzungen mit Claude, Codex, Pi und OMP, die bereits ein Gespräch haben, wählen Sie Rechtsklick → „Sitzung forken“. Dadurch entsteht ein Geschwisterknoten, der vom aktuellen Verlauf des Ausgangsgesprächs ausgeht und das Ausgangsgespräch unverändert lässt, ähnlich einem Git-Branch. So können Sie zwei Lösungswege aus demselben Kontext heraus ausprobieren.

6. Berechtigungen

Die Berechtigungseinstellungen legen fest, wie viel der Agent tun darf, ohne Sie zu fragen.

• Claude, Codex und OpenCode haben benannte Modi. Claude: „Planmodus“, „Immer fragen“, „Änderungen annehmen“, „Automatik“, „Ohne Nachfrage“. Codex: „Schreibgeschützt“, „Automatik“, „Vollzugriff“. OpenCode: „Immer fragen“, „Ohne Nachfrage“.
• Copilot, Cursor, Antigravity, Cline, OMP, Crush, Kimi Code, Kiro, Grok Build und Zoo Code haben einen einzelnen Schalter, „Alle Berechtigungsabfragen überspringen“, der den Agenten mit dessen eigener Option zum Umgehen der Abfragen startet. In der Gesprächsansicht bietet OMP „Immer fragen“ und „Ohne Nachfrage“.
• Pi führt Tools ohne Rückfrage aus und hat daher keine Berechtigungseinstellung.

Hier ändern Sie die Einstellung:

• Je Sitzung: im Formular „Bearbeiten“ der Sitzung („Berechtigung“ oder das Kontrollkästchen „Alle Berechtigungsabfragen überspringen“); in der Terminalansicht über den Berechtigungseintrag in der Statusleiste („Rechte: Fragen“ / „Rechte: Überspringen“ oder der Name des aktuellen Modus); in der Gesprächsansicht über das Berechtigungssteuerelement unter dem Nachrichtenfeld.
• Standard für neue Sitzungen: Einstellungen ▸ Agenten ▸ „Berechtigung“. Die Menüs in der Statusleiste und in der Gesprächsansicht bieten außerdem „Als Standard“.

Manche Änderungen wirken erst nach einem Neustart des Agenten. VelaTerm bietet dann „Jetzt neu starten“ oder „Später“ an; der Neustart setzt das Gespräch fort, unterbricht aber eine laufende Aufgabe. „Ohne Nachfrage“, „Vollzugriff“ und „Alle Berechtigungsabfragen überspringen“ überspringen jede Bestätigung; verwenden Sie diese Optionen daher mit Bedacht.

7. Starteinstellungen und Installationshilfe

Startargumente. Das Formular „Bearbeiten“ der Sitzung enthält „Startargumente (optional)“, womit Sie Kommandozeilenargumente für diese Sitzung hinzufügen. Unter Einstellungen ▸ Agenten legen Sie einen Standardwert je Agententyp fest.

Pfad zur ausführbaren Datei. Ist ein Agent außerhalb Ihres PATH installiert, tragen Sie unter Einstellungen ▸ Agenten den „Pfad zur ausführbaren Datei (optional)“ ein. Bleibt das Feld leer, wird der Befehl im PATH gesucht.

Nicht installiert? Wenn Sie einen Agenten starten, der nicht installiert ist, zeigt die Sitzung eine Karte „<Agent> ist nicht installiert“ mit dem empfohlenen Installationsbefehl für Ihr System.

• „Jetzt installieren“ führt den Befehl in der Sitzung aus. Sobald das installierte Programm gefunden wird, wird sein Pfad in den Einstellungen gespeichert, und ein Dialog bietet „Jetzt neu starten“ oder „Später“ an.
• „Erneut starten“ startet die Sitzung neu, etwa nachdem Sie den Agenten selbst installiert haben.
• Ist der Agent bereits außerhalb des PATH installiert, geben Sie unter „Pfad zur ausführbaren Datei“ den vollständigen Pfad ein und wählen Sie „Diesen Pfad verwenden“, oder verwenden Sie „Durchsuchen…“.
• „Anleitung“ öffnet die Installationsdokumentation des Agenten; „Mache ich selbst“ schließt die Karte.

Nach der Installation benötigt jeder Agent weiterhin seine eigene Anmeldung oder einen API-Schlüssel.

8. Das Infopanel: Nutzung, Kontext und Ressourcen

Bei geöffneter Agentensitzung zeigt der Tab Info im rechten Panel Folgendes:

• Agent: Agententyp, Sitzungsname, Arbeitsverzeichnis, Git-Branch, Startzeit und Laufzeit. Bei Kiro-Sitzungen enthält der Abschnitt außerdem einen Link zu einer schreibgeschützten Ansicht des Gesprächsverlaufs.
• Nutzung (Claude, Codex, Grok Build): die Kontingentnutzung des Kontos, zum Beispiel im Fünf-Stunden- und im Sieben-Tage-Fenster, mit den jeweiligen Rücksetzzeiten. Die Schaltfläche ↻ aktualisiert sofort. Automatische Aktualisierung und Intervall legen Sie unter Einstellungen ▸ Verhalten fest („Usage auto-refresh“, „Usage refresh“). Schlägt eine Aktualisierung fehl, bleiben die letzten Werte mit der Markierung „stale“ sichtbar.
• Dieser Durchlauf (Claude, Codex, Grok Build, OpenCode, Pi, OMP, Kiro): das Modell, der Füllstand des Kontextfensters sowie Token-Zahlen und Tools des aktuellen Durchlaufs.
• Ressourcen: CPU- und Speicherverbrauch der Prozesse der Sitzung; die Option „system“ ergänzt Werte für den gesamten Computer.

9. Transkripte, Export und Archivieren

• Rechtsklick → „Sitzung exportieren…“ (Claude und Codex, sobald ein Gespräch existiert) schreibt das vollständige Gespräch in eine Markdown-Datei, einschließlich der Denkschritte und aller Tool-Aufrufe mit Eingaben und Ergebnissen.
• „Für die Sitzungswissensdatenbank aufbereiten“ im Sitzungsmenü lässt einen Agenten wiederverwendbares Wissen aus dem Gespräch extrahieren; siehe Sitzungswissensdatenbank.
• Archivierte Sitzungen lassen sich in der Ansicht „Archivierte Sitzungen“ der Wissensdatenbank lesen. Gespräche von Claude, Codex, OpenCode, Pi, OMP, Grok Build und Kiro erscheinen als Nachrichten; bei anderen Agenten wird die Terminalaufzeichnung angezeigt, sofern eine vorhanden ist. Beim Wiederherstellen einer archivierten Sitzung bleibt ihre Gesprächs-ID erhalten, sodass sie wie gewohnt fortgesetzt wird. Siehe Oberfläche und Sitzungsverwaltung §8.

10. Weiteres Verhalten

• Automatische Namen: Eine Sitzung, die Sie nicht benannt haben, erhält ihren Namen aus Ihrer ersten Nachricht.
• Designwechsel: Beim Umschalten zwischen hellem und dunklem Design werden laufende Claude-Sitzungen in der Terminalansicht ohne Neustart angepasst.
• Vela Skills: Einstellungen ▸ Allgemein ▸ „Vela Skills“ installiert Skills für Claude Code und Codex, mit denen sich Untersitzungen starten, Dateien öffnen sowie andere Sitzungen lesen oder ihnen Nachrichten senden lassen; siehe Sitzungsbefehle.
• Windows: Claude Code und Codex werden vollständig unterstützt (sie laufen in PowerShell); die übrigen Agenten werden nach Möglichkeit unterstützt.