Oberfläche und Sitzungsverwaltung

Dieses Kapitel beschreibt das Organisationsmodell von VelaTerm: den Fensteraufbau, die Verwaltung des Baums, das Verhalten von Tabs und geteilten Bereichen, Statuspunkte und Filter, das Archivieren, die globale Suche und das Speichern des Arbeitsbereichs beim Beenden. Die übrigen Kapitel bauen darauf auf.

1. Der Fensteraufbau

Fernzugriff und Mit Remote-Server verbinden stehen in der Desktop-App zur Verfügung; siehe Fernentwicklung und -verwaltung. Feedback öffnet die Feedback-Seite von VelaTerm in Ihrem Browser. Unter Windows und Linux blendet die Taste Alt eine Menüleiste mit Datei, Terminal und Hilfe ein.

Beide Seitenbereiche lassen sich über die Schaltflächen der Titelleiste ausblenden und durch Ziehen am Rand in der Breite anpassen.

2. Der Baum: Projekte, Sammlungen, Gruppen, Sitzungen

• Ein Projekt ist ein Verzeichnis auf dem Datenträger und die Wurzel eines Teilbaums. Sie legen es mit „Projekt erstellen“ (erstellt einen neuen Ordner), „Projekt importieren“ (öffnet einen vorhandenen Ordner, ⌘O) oder „Von Git klonen“ an.
• Eine Sammlung ist ein Container auf oberster Ebene ohne eigenen Ordner, gedacht für Sitzungen, die zu keinem bestimmten Projekt gehören. Sie legen sie mit der Schaltfläche „Neue Sammlung“ unten in der Seitenleiste an.
• Eine Gruppe ist ein Ordnungsknoten und lässt sich beliebig tief verschachteln.
• Eine Sitzung ist die eigentliche Arbeitseinheit: ein Agent, eine Browserseite oder ein Terminal. Ihr Arbeitsverzeichnis ist standardmäßig die Projektwurzel und lässt sich im Formular „Bearbeiten“ der Sitzung ändern.

Wenn Sie den Mauszeiger über eine Zeile bewegen, erscheint eine Schaltfläche ＋ („Neue Sitzung“ bei Projekten und Gruppen, „Neue Untersitzung“ bei Sitzungen) sowie bei Projekten und Gruppen eine Schaltfläche für eine neue Gruppe.

Die meisten Aktionen finden Sie in den Kontextmenüs:

Die Menüs von Projekten und Gruppen beginnen mit den Einträgen zum Erstellen:

• „Neue Browser-Seite“ (Desktop-App) und „Neues Terminal“; Letzteres öffnet ein temporäres Terminal in diesem Verzeichnis (§5).
• Drei direkte Einträge „Neue …-Sitzung“ für zuletzt verwendete Agenten sowie „Weitere Agent-Sitzung“ mit allen Agenten, gespeicherten Vorlagen, „Neue Agentensitzung“ (der durchsuchbaren Auswahl) und „Neu mit Startargumenten…“.
• „Neue Worktree-Sitzung…“ und „Neue Planungs-/Ausführungssitzung…“; siehe Untersitzungen und Git-Zusammenarbeit und Planung und Ausführung.
• „Sitzungen importieren…“ (nur bei Projekten) und „Sitzung fortsetzen…“; siehe KI-Agentensitzungen §4.

Das Projektmenü bietet anschließend „Neue Gruppe“, „Markierung“, „Experimentell“ (Codegraph und Codeprüfung), „Projektinfo“ (bzw. „Sammlungsinfo“), „Umbenennen“ und „Projekt entfernen“ (bzw. „Sammlung löschen“). Das Gruppenmenü bietet das Untermenü „Git“, „Neue Untergruppe“, „Zu Worktree verschieben…“, „Markierung“, „Umbenennen“, „Gruppe archivieren“ und „Gruppe löschen“.

Sitzungsmenüs zeigen die Einträge, die zu Typ und Zustand der Sitzung passen:

• „Öffnen“, „In neuem Tab öffnen“, „In rechter Teilung öffnen“, „In unterer Teilung öffnen“, „Im aktiven Bereich öffnen“ (§4).
• „Neue Untersitzung“, „Sitzung forken“, „Sitzung exportieren…“, „Für die Sitzungswissensdatenbank aufbereiten“ und das Untermenü „Git“.
• „Markierung“, „Sitzungsinfo“ (bei gedrückter Taste Option/Alt mit dem vollständigen Startbefehl), „Bearbeiten“, „Umbenennen“, „Verschieben nach…“.
• „Prozess beenden“ (solange die Sitzung läuft), „Sitzung archivieren“, „Sitzung löschen“.

Weitere Aktionen im Baum:

• Verschieben: Ziehen Sie Knoten mit der Maus oder verwenden Sie „Verschieben nach…“. Eine Sitzung lässt sich unter eine andere Sitzung verschieben und wird so zu deren Untersitzung.
• Umbenennen: „Umbenennen“ bearbeitet den Namen direkt im Baum. Eine Sitzung, die Sie nicht benennen, erhält ihren Namen aus Ihrer ersten Nachricht.
• Markierungen: „Markierung“ versieht ein Projekt, eine Gruppe oder eine Sitzung mit einem Emoji: 🔥 Dringend, ⭐ Wichtig, 🐛 Fehler, ✅ Erledigt, 🚧 In Arbeit, 📌 Angeheftet, 💡 Idee, ⚠️ Achtung. Wenn Sie die aktuelle Markierung erneut wählen, wird sie entfernt.
• Mehrfachauswahl: ⌘/Ctrl-Klick wählt einzelne Sitzungen aus oder ab, Shift-Klick wählt einen Bereich. Das Kontextmenü bietet dann „Ausgewählte Sitzungen öffnen“, „Ausgewählte Sitzungen nebeneinander anordnen“ (zwei bis vier Sitzungen), „Auswahl verschieben…“, „Ausgewählte Sitzungen archivieren“ und „N ausgewählte Einträge löschen“. Wenn Sie eine Auswahl ziehen, wird sie vollständig verschoben.
• Der Auf- und Zuklappzustand bleibt über Neustarts hinweg erhalten.

3. Tabs

Einstellungen ▸ Verhalten ▸ „Tabs“ legt fest, wie Sitzungen geöffnet werden:

• Einzeln (Standard): Ein Klick auf eine Agentensitzung im Baum öffnet sie im aktuellen Sitzungs-Tab, so wie ein Link im Browser. Der verlassene Tab wechselt mit all seinen Bereichen in den Hintergrund, und seine Prozesse laufen weiter. Terminalsitzungen öffnen sich in eigenen Tabs.
• Mehrere: Jede Sitzung öffnet sich in einem eigenen Tab.

„In neuem Tab öffnen“ öffnet immer einen neuen Tab. In beiden Modi hält der Wechsel zu einem anderen Tab nichts an; das Schließen eines Tabs (⌘W oder ×) beendet seine Prozesse. Bei Agentensitzungen ist das unbedenklich: Das Gespräch bleibt erhalten, und beim erneuten Öffnen des Knotens wird es fortgesetzt.

Hintergrund-Tabs erscheinen in der Statusleiste als „Hintergrund N/M“; ein Klick darauf holt einen Tab zurück oder beendet ihn. Im Modus Einzeln begrenzt „Background limit“ (Standard 32) ihre Anzahl. Wird das Limit überschritten, endet automatisch der älteste inaktive Hintergrund-Tab. Arbeiten alle Hintergrund-Tabs oder warten sie auf Sie, fragt VelaTerm, welcher Tab beendet werden soll.

Details zur Tab-Leiste:

• ⌘1–9 (unter Windows und Linux Ctrl+1–9) wechselt zum Tab an der jeweiligen Position. Ein Mittelklick schließt einen Tab.
• Das ＋ hinter den Tabs öffnet ein temporäres Terminal. Die Schaltflächen rechts öffnen ein neues Terminal, ein neues Dokument, einen integrierten Browser-Tab (Desktop-App) und das Spielecenter.
• Das Kontextmenü eines Tabs enthält „Tab schließen“, „Andere Tabs schließen“, „Tabs rechts schließen“, „Alle Tabs schließen“, „In den Hintergrund verschieben“ (die Prozesse des Tabs laufen weiter) sowie dieselben Sitzungseinträge wie im Baum.

Dokument- und Browser-Tabs werden in Dokumente und Browser-Tabs beschrieben.

4. Geteilte Bereiche

Ein Tab kann mehrere Bereiche enthalten:

• ⌘D teilt nach rechts, ⌘⇧D nach unten (unter Windows und Linux Ctrl+Alt+D und Ctrl+Alt+E); die Kopfzeile des Bereichs bietet dieselben Schaltflächen. Der neue Bereich ist ein temporäres Terminal, das im Arbeitsverzeichnis des aktuellen Bereichs startet.
• Um eine vorhandene Sitzung im aktuellen Tab anzuzeigen, wählen Sie in ihrem Menü „In rechter Teilung öffnen“, „In unterer Teilung öffnen“ oder „Im aktiven Bereich öffnen“, oder ziehen Sie die Sitzung aus der Seitenleiste in den mittleren Bereich.
• „Ausgewählte Sitzungen nebeneinander anordnen“ ordnet zwei bis vier ausgewählte Sitzungen in einem Tab an.
• Sitzungen, die in einem anderen Bereich des aktuellen Tabs angezeigt werden, sind in der Seitenleiste hervorgehoben.

Die Trennlinien lassen sich verschieben. Das Weiterlaufen im Hintergrund gilt für den ganzen Tab; wenn Sie einen Tab verlassen und später zurückkehren, bleibt sein Layout erhalten. ⌘W schließt den aktuellen Bereich; das Schließen des letzten Bereichs schließt den Tab.

5. Temporäre Terminals

„Neues Terminal“, ⌘T und das ＋ in der Tab-Leiste öffnen ein temporäres Terminal. Es existiert nur als Tab: Es wird nie zu einem Knoten im Baum und beim Schließen verworfen. Der Tab ist mit „temp“ gekennzeichnet. Verwenden Sie temporäre Terminals für schnelle Befehle; länger laufende Arbeit gehört in Agentensitzungen. Das Menü eines temporären Terminals ist kurz: „Öffnen“, „In neuem Tab öffnen“, die Einträge zum Teilen, „Umbenennen“, „Sitzungsinfo“ und „Entwurf schließen“.

6. Statuspunkte und Filter

Der Punkt neben jeder Agentensitzung zeigt ihren Zustand: Grün, während sie arbeitet; Gelb, wenn sie Sie braucht; Magenta, nachdem sie geantwortet und Sie die Antwort gesehen haben. Die vollständige Legende finden Sie in KI-Agentensitzungen §3.

Die Statusleiste zeigt, wie viele Sitzungen „Aktiv“, „Ausstehend“ (warten auf Sie) und „Gesehen“ sind; ein Zähler ohne Sitzungen wird ausgeblendet. Ein Klick auf einen Zähler zeigt in der Seitenleiste nur diese Sitzungen an; ein erneuter Klick hebt den Filter auf.

Die Seitenleiste hat eigene Werkzeuge:

• Das Suchfeld („Sitzungen / Gruppen suchen…“) filtert den Baum nach Namen.
• Die Filterschaltfläche („Nach Status filtern“) wählt einen oder mehrere Zustände und unabhängig davon eine Markierung.
• Ein Statusfilter behält die Sitzungen, die beim Setzen des Filters zutrafen, damit die Liste während der Arbeit nicht springt. Mit „Dynamische Ergänzung des Statusfilters“ (Einstellungen ▸ Verhalten, standardmäßig aktiviert) kommen Sitzungen hinzu, die neu zutreffen. „Statusfilter aktualisieren“ unten in der Seitenleiste prüft alle Sitzungen erneut; „Status aktualisieren“ im Menü einer Sitzung prüft nur diese Sitzung.
• „Baumansicht nach unten teilen“ unten in der Seitenleiste fügt eine zweite Ansicht des Baums mit eigener Suche und eigenen Filtern hinzu, zum Beispiel eine Ansicht für Sitzungen, die auf Sie warten, und eine für den gesamten Baum. Jede zusätzliche Ansicht lässt sich schließen.

7. Rechtes Panel

• Dateien: der Dateibaum des Arbeitsverzeichnisses der Sitzung. Ein Doppelklick auf eine Datei öffnet sie in einem Dokument-Tab.
• Info: Sitzungsdetails, Kontonutzung, der aktuelle Durchlauf und der Ressourcenverbrauch; siehe KI-Agentensitzungen §8.
• Git: Branch, bereitgestellte und nicht bereitgestellte Änderungen, nicht verfolgte Dateien, Committen und der Commit-Verlauf.
• Wissensdatenbank: die Sitzungswissensdatenbank, archivierte Sitzungen und Ihre lokalen Wissensbasen; siehe Lokale Wissensbasen und Sitzungswissensdatenbank.

8. Archivieren: wegräumen statt löschen

Abgeschlossene Arbeit müssen Sie nicht löschen. Klicken Sie mit der rechten Maustaste auf eine Sitzung → „Sitzung archivieren“, um sie auszublenden: Die Sitzung und ihre Untersitzungen verschwinden aus dem Baum und ihre Prozesse werden beendet, aber alle Daten bleiben erhalten. „Gruppe archivieren“ archiviert alle Sitzungen einer Gruppe, „Ausgewählte Sitzungen archivieren“ eine Auswahl.

Archivierte Sitzungen befinden sich in der Wissensdatenbank. Sie öffnen sie mit der Schaltfläche „Archivierte Sitzungen“ im Kopfbereich der Seitenleiste. Archivierte Sitzungen sind nach Projekten gruppiert, und das Suchfeld („Archivierte Inhalte durchsuchen…“) durchsucht ihren Inhalt. Für jede archivierte Sitzung gilt:

• Das Gespräch lässt sich lesen. Agentensitzungen zeigen ihre Nachrichten; ist kein Gespräch verfügbar, wird die Terminalaufzeichnung angezeigt, sofern eine vorhanden ist. Ein zweiter Tab listet die Wissenseinträge auf, die aus der Sitzung erzeugt wurden.
• „Als normale Sitzung wiederherstellen“ bringt sie an ihren Platz im Baum zurück, mit unveränderter Gesprächs-ID; beim Öffnen wird daher das ursprüngliche Gespräch fortgesetzt.
• „Für die Sitzungswissensdatenbank aufbereiten“ extrahiert wiederverwendbares Wissen daraus.
• „Vollständigen Kontext als Markdown exportieren“ (Claude und Codex) schreibt das gesamte Gespräch in eine Datei.
• „Endgültig löschen (samt Aufzeichnung)“ ist die einzige Aktion, die die Daten entfernt.

9. Globale Suche (⌘⇧F)

„Alle Sitzungen durchsuchen“ (⌘⇧F, unter Windows und Linux Ctrl+Alt+G) durchsucht den Inhalt aller Sitzungen: Agentengespräche und aufgezeichnete Terminalausgaben, nicht nur Namen.

• Mehrere Wörter lassen sich in beliebiger Reihenfolge kombinieren; auch Wortteile sowie chinesischer, japanischer oder koreanischer Text werden gefunden. Die Ergebnisse sind nach Relevanz sortiert.
• Links stehen die Ergebnisse nach Sitzungen gruppiert; die Vorschau rechts hebt den aktuellen Treffer hervor. Mit ↑/↓ und Enter springen Sie sitzungsübergreifend von Treffer zu Treffer.
• „Sitzung öffnen“ öffnet die Sitzung im Arbeitsbereich.
• Archivierte Sitzungen sind ausgeschlossen, sofern Sie nicht „Archivierte einbeziehen“ ankreuzen.

Terminalausgaben sind nur durchsuchbar, wenn die Sitzungsaufzeichnung aktiviert ist (Einstellungen ▸ Erweitert ▸ „Sitzungsprotokolle aufzeichnen“, standardmäßig deaktiviert). Agentengespräche sind immer durchsuchbar.

10. Sicher löschen

Das Löschen einer Sitzung entfernt sie endgültig, zusammen mit ihrer Aufzeichnung. Wenn Sie eine Gruppe oder ein Projekt löschen, das archivierte Sitzungen enthält, bleiben diese Archive erhalten; stellen Sie eine davon wieder her, werden auch ihr Projekt und ihre Gruppe wiederhergestellt. Im Zweifel archivieren Sie zuerst: Archivierte Inhalte lassen sich jederzeit wiederherstellen.

11. Beenden und Wiederherstellen des Arbeitsbereichs

Beim Beenden fragt VelaTerm „VelaTerm beenden?“ und stoppt laufende Terminal- und Agentensitzungen. Ist „Arbeitsbereich speichern“ angekreuzt, öffnet der nächste Start dieselben Tabs und Teilungen. Wiederhergestellte Sitzungen starten nicht von selbst: Jeder Bereich zeigt „Aus dem gespeicherten Arbeitsbereich wiederhergestellt. Es läuft noch kein Prozess.“ mit der Schaltfläche „Starten“. Das Kontrollkästchen merkt sich Ihre letzte Wahl.