Einführung

Diese Anleitung führt Sie von der Installation bis zum ersten Terminal und zur ersten Sitzung mit einem KI-Agenten. Das genügt für den Einstieg; jede Funktion wird in den übrigen Kapiteln ausführlich beschrieben (siehe Überblick über das Handbuch).

1. Was ist VelaTerm?

VelaTerm ist ein Terminalmanager für die Arbeit mit KI-Coding-Agenten. Er ordnet Terminal- und Agentensitzungen in einem Baum aus Projekt → Gruppe → Sitzung an und führt Coding-Agenten wie Claude Code und Codex als eigene Sitzungen aus: Sie sehen jederzeit, ob ein Agent arbeitet, auf Ihre Eingabe wartet oder fertig ist, und beim erneuten Öffnen einer Sitzung wird ihr Gespräch fortgesetzt. Agenten laufen entweder in ihrer eigenen Terminaloberfläche oder in einer Gesprächsansicht mit Nachrichten, Tool-Karten und Schaltflächen für Berechtigungsanfragen. Über den Fernzugriff per Browser und die SSH-Fernentwicklung setzen Sie Ihre Sitzungen auch auf anderen Geräten fort.

2. Installation

Laden Sie das Paket für Ihre Plattform von der Download-Seite herunter:

VelaTerm sucht automatisch nach Updates; der Eintrag „Check for Updates…“ im App-Menü startet die Suche sofort.

3. Erster Start: ein Projekt hinzufügen

Beim ersten Start ist die Seitenleiste leer und bietet drei Möglichkeiten, ein Projekt hinzuzufügen:

• „Projekt erstellen“ legt einen neuen Ordner an und fügt ihn hinzu.
• „Projekt öffnen“ (⌘O, unter Windows und Linux Ctrl+Alt+O) fügt einen vorhandenen Ordner hinzu.
• „Von Git klonen“ klont ein Repository und fügt es hinzu.

Dieselben Aktionen stehen als Schaltflächen im Kopfbereich der Seitenleiste bereit. Innerhalb eines Projekts legen Sie beliebig tief verschachtelte Gruppen an (zum Beispiel frontend, backend, testing) und darin Sitzungen:

4. Das erste Terminal öffnen

Jede dieser Möglichkeiten öffnet ein temporäres Terminal:

1. Drücken Sie ⌘T (unter Windows und Linux Ctrl+Alt+T).
2. Bewegen Sie den Mauszeiger in der Seitenleiste über ein Projekt, eine Gruppe oder eine Sitzung, klicken Sie auf die Schaltfläche ＋ und wählen Sie „Neues Terminal“. Das Terminal startet im Verzeichnis dieses Knotens. Die Kontextmenüs von Projekten und Gruppen enthalten denselben Eintrag.
3. Wenn der mittlere Bereich leer ist, klicken Sie auf „Terminal erstellen“.

Temporäre Terminals existieren nur als Tabs: Sie werden nie zu Knoten im Baum und beim Schließen verworfen. Deshalb eignen sie sich für schnelle Befehle.

5. Die erste KI-Agentensitzung öffnen

Klicken Sie mit der rechten Maustaste auf ein Projekt oder eine Gruppe und wählen Sie „Neue Claude-Sitzung“. Die erste Menüebene bietet Claude, Codex und OpenCode an; „Weitere Agent-Sitzung“ listet alle vierzehn unterstützten Agenten auf. Alternativ öffnet ⌘N (unter Windows, Linux und in normalen Browsern Ctrl+Alt+N) eine durchsuchbare Liste der Agenten.

VelaTerm startet den Agenten im Projektverzeichnis. Sitzungen mit Claude, Codex, OpenCode, Pi und OMP öffnen sich in der Gesprächsansicht: Geben Sie Ihre Nachricht in das Feld unten ein und drücken Sie Enter. Die übrigen Agenten öffnen sich in der Terminalansicht, die die eigene Terminaloberfläche des Agenten zeigt. Mit der Umschaltfläche in der Kopfzeile des Bereichs wechselt eine Sitzung zwischen den beiden Ansichten; siehe Gesprächsansicht.

Von da an stehen Ihnen drei Dinge zur Verfügung:

• Statuspunkte: Der Punkt neben der Sitzung in der Seitenleiste zeigt den Zustand des Agenten. Grün bedeutet, dass er arbeitet; Gelb, dass er Sie braucht (eine Frage oder eine Berechtigungsanfrage); Magenta, dass er geantwortet hat und Sie die Antwort gesehen haben.
• Systembenachrichtigungen: Wenn der Agent anhält und auf Sie wartet, erhalten Sie eine Benachrichtigung. Sehen Sie sich die Sitzung bereits an, erscheint keine Benachrichtigung.
• Automatisches Fortsetzen: Schließen Sie den Tab oder beenden Sie die App – beim nächsten Öffnen der Sitzung wird das Gespräch dort fortgesetzt, wo es aufgehört hat. Für ein neues Gespräch legen Sie eine neue Sitzung an.

Ist die CLI des Agenten noch nicht installiert, zeigt die Sitzung eine Installationskarte mit dem empfohlenen Installationsbefehl für Ihr System und der Schaltfläche „Jetzt installieren“.

6. Ein kurzer Rundgang

• Linke Seitenleiste: der Projektbaum mit Suchfeld und Statusfilter. Schaltflächen im Kopfbereich: Projekt erstellen, Projekt importieren, Von Git klonen, Alle Sitzungen durchsuchen und Archivierte Sitzungen.
• Mittlerer Bereich: die Tab-Leiste und die geöffneten Sitzungen. Standardmäßig öffnet ein Klick auf eine Agentensitzung im Baum diese im aktuellen Tab, und der vorherige Tab läuft im Hintergrund weiter. Das Schließen eines Tabs beendet seine Prozesse. Tabs lassen sich in Bereiche teilen (⌘D nach rechts, ⌘⇧D nach unten).
• Rechtes Panel: folgt der aktuellen Sitzung und hat vier Tabs: Dateien, Info (Sitzungsdetails, Kontonutzung, Kontext und Ressourcenverbrauch), Git (Branch, Änderungen und Commits) und Wissensdatenbank.
• Statusleiste: Anzahl der Sitzungen, aktueller Sitzungstyp, Git-Branch, Berechtigungsmodus, Benachrichtigungsschalter sowie die Zähler Aktiv, Ausstehend und Gesehen. Ein Klick auf einen Zähler zeigt in der Seitenleiste nur diese Sitzungen an.
• Titelleiste, rechte Seite: Designumschalter, Fernzugriff, Mit Remote-Server verbinden, Teilen, Einstellungen, Konto, Feedback sowie die Schaltflächen zum Ein- und Ausblenden der Seitenleiste und des Infopanels.

7. Wie geht es weiter?

• Baum, Tabs, geteilte Bereiche, Archivieren und globale Suche: Oberfläche und Sitzungsverwaltung.
• Fähigkeiten der Agenten, Fortsetzen, Forken und Berechtigungen: KI-Agentensitzungen.
• Arbeiten in der Gesprächsansicht: Gesprächsansicht.
• Agenten Untersitzungen in separaten Worktrees starten lassen: Untersitzungen und Git-Zusammenarbeit.
• Terminalfunktionen (Suche, Einfügen von Bildern, Befehlsvorschläge): Verwendung des Terminals.
• VelaTerm auf dem Smartphone oder einem anderen Computer verwenden: Fernentwicklung und -verwaltung.