Verwendung des Terminals

Dieses Kapitel beschreibt das Terminal selbst: Ein- und Ausgabe, die Suche im Terminal, Kopieren und Einfügen, das Einfügen von Bildern, Befehlsvorschläge, die integrierten v-Befehle, mit vrun gestartete Hintergrundbefehle, die Shell-Auswahl unter Windows, die Sitzungsaufzeichnung, Renderer-Einstellungen und Tastenkürzel.

1. Grundlagen

Eine Terminalsitzung führt eine echte Shell aus. Unter macOS und Linux ist das die Standard-Shell des Systems ($SHELL); unter Windows ist es standardmäßig cmd, was sich ändern lässt (siehe §7). Das Arbeitsverzeichnis ist standardmäßig die Projektwurzel. Im Bearbeitungsformular der Sitzung können Sie „Arbeitsverzeichnis (leer = Projektwurzel)“ ändern und einen „Startbefehl (optional)“ festlegen, der bei jedem Start der Sitzung ausgeführt wird (zum Beispiel pnpm dev).

Wenn mehrere Agenten gleichzeitig viel Ausgabe erzeugen, gibt VelaTerm Ihren Eingaben und dem sichtbaren Tab Vorrang und drosselt die Ausgabe von Hintergrund-Tabs. Dieses Verhalten steuert Einstellungen ▸ Erweitert ▸ „Vordergrund-Ausgabe priorisieren“ (standardmäßig aktiviert). Sollte ein Vollbildprogramm nach einem Tabwechsel einmal verzerrt aussehen, klicken Sie in der Kopfzeile des Bereichs auf die Schaltfläche „Neu zeichnen“. Einstellungen ▸ Erweitert ▸ „Beim Tabwechsel neu zeichnen“ erledigt das automatisch, sobald ein Tab sichtbar wird.

2. Suche im Terminal (⌘F)

⌘F öffnet eine Suchleiste („Im Terminal suchen“) für den Scrollback-Puffer des aktuellen Terminals, mit Schaltflächen für den vorherigen und den nächsten Treffer:

Um sitzungsübergreifend und im Verlauf zu suchen, verwenden Sie die globale Suche (⌘⇧F), die in Oberfläche und Sitzungsverwaltung beschrieben ist.

3. Kopieren und Einfügen

• Markieren Sie Text mit der Maus und verwenden Sie dann ⌘C / ⌘V oder das Kontextmenü („Kopieren“, „Einfügen“, „Alles auswählen“, „Leeren“, „Suchen…“).
• In Programmen, die die Maus selbst verarbeiten (vim, htop, die meisten Agentenoberflächen), halten Sie beim Ziehen unter macOS Option bzw. unter Windows und Linux Shift gedrückt, um eine normale Textauswahl zu erzwingen.
• Agentenoberflächen wie Claude Code und Codex können Text selbst kopieren. Haben sie das gerade getan und ist im Terminal nichts markiert, zeigt das Kontextmenü „N Zeichen autom. kopiert · ⌘V“.

4. Bilder einfügen

Durch Einfügen oder Hineinziehen eines Bildes in ein Terminal übergeben Sie einem Kommandozeilen-Agenten ein Bild. Einstellungen ▸ Terminal ▸ „Bild einfügen“ bietet zwei Möglichkeiten:

• Dateipfad einfügen (Standard): Das Bild wird als temporäre Datei gespeichert und sein Pfad an der Eingabeaufforderung eingefügt; jeder Agent, der Dateien lesen kann, kann es öffnen. Codex erhält es als image_path: ….
• Nativ einfügen: Claude Code oder Codex liest das Bild aus der Systemzwischenablage und zeigt einen eigenen Bildplatzhalter an. Diese Option steht nur in der lokalen Desktop-App zur Verfügung; Remote-Sitzungen fügen immer einen Dateipfad ein, damit der Agent das Bild auf seinem eigenen Rechner lesen kann.

Einstellungen ▸ Verhalten ▸ „Eingefügte Bilder automatisch bereinigen“ entfernt diese temporären Dateien beim Beenden der App und löscht beim Start Überbleibsel, die älter als 24 Stunden sind. „Jetzt bereinigen“ entfernt sie sofort. In Dokumente eingefügte Bilder sind davon nie betroffen.

5. Befehlsvorschläge

In normalen Terminalsitzungen unter macOS und Linux kann VelaTerm eine Vorschlagsliste anzeigen, die auf den Vervollständigungsdefinitionen Ihrer Shell beruht. Einstellungen ▸ Terminal ▸ „Befehlsvorschläge“ bietet „Automatisch“ (Standard), „Mit Tab“ oder „Aus“. Wählen Sie mit den Pfeiltasten einen Vorschlag aus und übernehmen Sie ihn mit Tab; Enter führt den Befehl immer so aus, wie er eingegeben wurde. Kann die Auswahl nicht weiter wandern, gehen ↑ und ↓ an die Shell zurück, sodass ↑ beim ersten Vorschlag den vorherigen Befehl aufruft. Unter Windows ist die Liste nicht verfügbar. Alle Einzelheiten beschreibt das Kapitel Befehlsvorschläge.

6. Integrierte Befehle

Jede Sitzung, die VelaTerm startet, hat eine Reihe kurzer Befehle im PATH. Sie erfordern keine Installation und funktionieren in normalen Terminals ebenso wie in Agentensitzungen:

Führen Sie einen Befehl mit --help aus, um seine Optionen zu sehen; Sitzungsbefehle beschreibt jeden Befehl ausführlich. Die meisten dieser Befehle gibt es auch als Skills in Claude Code (/vopen) und Codex ($vopen); für vrun und vflow gibt es keinen Skill, und vask gibt es nur als Skill. Die Skills installieren Sie unter Einstellungen ▸ Allgemein über den Eintrag „Vela Skills“.

vopen wählt die Ansicht nach Dateityp:

vopen README.md          # Markdown → Markdown editor
vopen src/main.rs        # source code → code editor with syntax highlighting
vopen diagram.png        # image → image viewer
vopen https://crates.io  # web address → browser tab (desktop app only)

Relative Pfade werden relativ zum aktuellen Verzeichnis aufgelöst, und mehrere Dateien lassen sich auf einmal öffnen. Dokument-Tabs werden in Dokumente und Browser-Tabs beschrieben, vspawn in Untersitzungen und Git-Zusammenarbeit und vkb in Codegraph und Wissensdatenbank sowie Lokale Wissensbasen.

6.1 Hintergrundbefehle (vrun)

vrun <label> <command...> startet einen Befehl, wartet auf sein Ende und gibt dann den Exit-Code, die verstrichene Zeit und das Ende seines Protokolls aus. Ein Agent, der einen langen Build oder Test mit vrun startet, erfährt das Ergebnis daher, sobald es vorliegt. Das Schließen der Sitzung hält den Befehl nicht an. vrun --status <label> meldet den Stand eines zuvor gestarteten Befehls, und -t <seconds> legt fest, wie lange gewartet wird (standardmäßig 1800 Sekunden); läuft die Wartezeit ab, beendet sich vrun mit Code 124 und lässt den Befehl weiterlaufen.

Solange solche Befehle laufen, erscheint über dem Terminal eine Zeile „Hintergrundbefehle“. Jeder Eintrag zeigt seine Bezeichnung und „Läuft seit …“, eine Schaltfläche „Protokoll“, die die Ausgabe des Befehls öffnet, und eine Schaltfläche „Stoppen“; klicken Sie auf „Stoppen bestätigen“, um den Befehl zu beenden. Die Zeile verschwindet, sobald nichts mehr läuft.

7. Shell-Auswahl (nur Windows)

Unter Windows können Terminalsitzungen jede erkannte Shell verwenden: PowerShell, pwsh, cmd, Git Bash und jede installierte WSL-Distribution. Sie wählen die Shell im Untermenü „Neues Terminal“, über „Shell (leer = Systemstandard)“ im Bearbeitungsformular der Sitzung oder über das Kontextmenü „Shell“. Eine laufende Sitzung startet sofort mit der neuen Shell neu. Einstellungen ▸ Terminal ▸ „Standard-Shell“ legt die Shell für neue Terminals fest, für die keine Shell ausdrücklich gewählt wurde.

WSL-Einträge erscheinen als WSL: <distribution> nur, wenn WSL eine installierte Distribution meldet. Wählen Sie einen davon, startet diese Distribution, und das Windows-Projektverzeichnis der Sitzung wird darin eingebunden. WSL steht nur für normale Terminalsitzungen zur Verfügung; Agentensitzungen verwenden weiterhin die Shell des Windows-Hosts. Die integrierten v-Befehle sind in WSL-Terminals nicht verfügbar.

Zur mitgelieferten Git Bash: Das Installationsprogramm full enthält die vollständige Git Bash (mit git, ssh und perl). Das Installationsprogramm min enthält einen Kernumfang; wenn Sie einen fehlenden Befehl ausführen, bietet es an, die vollständige Version herunterzuladen, die auch über den Kontextmenüeintrag „Vollständige Git Bash herunterladen“ erhältlich ist. Agentensitzungen sind davon nicht betroffen; sie verwenden PowerShell.

macOS und Linux haben keine Shell-Auswahl; Sitzungen verwenden die Standard-Shell des Systems.

8. Sitzungsaufzeichnung

Einstellungen ▸ Erweitert ▸ „Sitzungsprotokolle aufzeichnen“ ist standardmäßig deaktiviert. Ist die Option aktiviert, speichert VelaTerm die Terminalausgabe von Agentensitzungen, die in der Terminalansicht laufen, in einer lokalen Protokolldatei, bis zu 50 MB pro Sitzung. Normale Terminalsitzungen werden nie aufgezeichnet.

Mit einer Aufzeichnung können Sie eine archivierte Sitzung so wiedergeben, wie sie auf dem Bildschirm aussah, und ihr Bildschirmtext wird durchsuchbar. VelaTerm verwendet eine Aufzeichnung nur, wenn sich die eigene Gesprächsaufzeichnung des Agenten nicht lesen lässt; andernfalls dient die Gesprächsaufzeichnung zum Anzeigen und Durchsuchen. Aufzeichnungsdateien werden zusammen mit ihrer Sitzung gelöscht.

9. Renderer

Einstellungen ▸ Erweitert ▸ „Terminal-Renderer“ bietet DOM (Standard) und WebGL. In der Desktop-App wird DOM empfohlen. Frühere Versionen boten außerdem einen Canvas-Renderer; diese Option gibt es nicht mehr, und eine gespeicherte Canvas-Einstellung verwendet jetzt DOM.

10. Gängige Tastenkürzel

Die Tabelle zeigt die Standardbelegung der macOS-Desktop-App. Die Apps für Windows und Linux verwenden für die meisten Aktionen Ctrl+Alt statt ⌘ (Unten teilen ist Ctrl+Alt+E, Alle Sitzungen durchsuchen ist Ctrl+Alt+G, und Speichern bleibt Ctrl+S). Browser-Clients verwenden Standardbelegungen mit Ctrl, die nicht mit den Tastenkürzeln des Browsers kollidieren. Einstellungen ▸ Tastenkürzel zeigt die genaue Belegung auf Ihrem System; dort lässt sich jede Aktion außer dem Tabwechsel und der Schriftgröße ändern.