Sitzungsbefehle

VelaTerm stellt in jeder Sitzung, die es startet, eine Reihe kurzer Befehle bereit. Damit starten Sie und Ihre Agenten andere Sitzungen, öffnen Dateien, lesen und durchsuchen andere Gespräche, prüfen, welche Sitzungen beschäftigt sind, senden Nachrichten zwischen Sitzungen und warten auf lang laufende Befehle. Dieses Kapitel ist eine Referenz für jeden Befehl und die zugehörigen Agenten-Skills.

1. Wo die Befehle funktionieren

Die Befehle liegen im PATH jeder Sitzung, die VelaTerm startet: in normalen Terminals und in Agentensitzungen, sowohl in der Terminal- als auch in der Gesprächsansicht, einschließlich Sitzungen auf einem Remote-VelaTerm-Server. Sie erfordern keine Installation. Außerhalb einer solchen Sitzung brechen sie mit „not inside a VelaTerm session“ ab.

Führen Sie einen Befehl mit --help aus, um seine Verwendung anzuzeigen.

Mehrere Befehle erwarten einen Sitzungsverweis: eine vollständige Sitzungs-ID, ein ID-Präfix mit mindestens 8 Zeichen, den exakten Sitzungsnamen oder einen eindeutigen Teil des Namens. Setzen Sie Namen mit Leerzeichen in Anführungszeichen. Passt ein Verweis auf mehrere Sitzungen, listet der Befehl die möglichen Treffer auf.

2. Agenten-Skills (Vela Skills)

Einstellungen ▸ Allgemein ▸ „Vela Skills“ installiert passende Skills in Claude Code und Codex; „Reinstall“ aktualisiert sie. Starten Sie danach ein neues Gespräch mit Claude oder Codex, damit der Agent die Skills übernimmt. In Claude Code rufen Sie einen Skill mit /name auf, in Codex mit $name.

Skills mit dem Eintrag „Ihnen“ laufen nur, wenn Sie sie aufrufen; die übrigen kann der Agent auch von sich aus verwenden, wenn Sie eine andere Sitzung oder frühere Arbeit erwähnen. vask gibt es nur als Skill; er führt vrefer <session> --ask "<question>" aus.

3. vspawn und vspawn-tree

vspawn [--worktree] [--cwd <path>] [--yes] [--claude|--codex|--copilot|--kiro] [--model <name>] [--effort <level>] <task description...>

Startet eine neue Sitzung unterhalb der aktuellen und sendet die Aufgabe als deren erste Nachricht. vspawn-tree ist derselbe Befehl mit einem separaten Git-Worktree.

Details: Untersitzungen und Git-Zusammenarbeit und Planung und Ausführung.

4. vopen

vopen <file|url>...

Öffnet jedes Argument im mittleren Bereich. Markdown-Dateien öffnen sich im Markdown-Editor, Bilder in der Bildanzeige und andere Dateien im Code-Editor. Webadressen (http oder https) öffnen sich in einem Browser-Tab, der nur in der Desktop-App verfügbar ist. Relative Pfade werden relativ zum aktuellen Verzeichnis aufgelöst. Siehe Dokumente und Browser-Tabs.

5. vrefer und vask

vrefer <session> [--last N] [--range A:B] [--json]
vrefer <session> --ask "<question>" [--with <agent>] [--timeout N]
vrefer --list [--json]

Gibt das Gespräch einer anderen Sitzung aus. Die andere Sitzung muss nicht laufen, und es wird nichts an sie gesendet.

--ask startet für die Antwort einen separaten Agentenprozess und liefert nur die Antwort zurück, sodass ein langes Gespräch den aktuellen Kontext nicht füllt. Einstellungen ▸ Verhalten ▸ „Kontext für Sitzungsverweise“ legt fest, wie das Gespräch an den antwortenden Agenten übergeben wird: „Vollständiges Protokoll“ (Standard) oder „Zuerst zusammenfassen“; bei Letzterem wird es zunächst mit dem dort gewählten „Agent für Zusammenfassungen“ samt Modell und Denkaufwand verdichtet. Kann keine Antwort erzeugt werden, erklärt vrefer den Grund und gibt stattdessen das Gespräch aus.

Lesbar sind Gespräche von Claude Code, Codex, OpenCode, Pi, OMP, Grok Build und Kiro (nur Textaufzeichnungen). Andere Sitzungstypen sowie Sitzungen, deren Agentengespräch noch nicht aufgezeichnet wurde, lassen sich nicht lesen.

6. vsearch

vsearch <words...> [--session <session>] [--all|--archived] [--limit N] [--json]

Durchsucht die Gespräche aller Sitzungen auf dem verbundenen VelaTerm. Alle Wörter müssen vorkommen, in beliebiger Reihenfolge.

Jedes Ergebnis zeigt den Sitzungsnamen, das ID-Präfix, die Anzahl der Treffer, einige Auszüge mit Nachrichtennummern sowie den vrefer-Befehl, der das gesamte Gespräch liest. Eine Nachrichtennummer lässt sich mit vrefer --range verwenden. Die Ergebnisse stammen nur aus Agentengesprächen; Treffer, die nur in Terminalaufzeichnungen vorkommen, werden nicht zurückgegeben. „no matches“ ist ein normales Ergebnis.

7. vstat

vstat [--wait] [--follow] [--timeout N] [--json]

Zeigt den Zustand jeder Sitzung: working, asking (wartet auf eine Berechtigung oder eine Antwort), waiting (hat ihren Durchlauf beendet) oder unknown. Der Zustand beschreibt die Aktivität, nicht, ob eine Aufgabe erledigt wurde.

Ein optionales erstes Argument filtert nach einer Orchestrierungs-ID aus älteren VelaTerm-Versionen; Planungs- und Ausführungsworkflows verwenden stattdessen vflow status.

8. vtell

vtell <session> [--steer] [--message-id msg-UUID] [message...]
vtell [planner-session] --report --round N [--message-id msg-UUID] [message...]

Sendet eine Nachricht an eine andere Sitzung. Ohne Nachrichtenargumente wird der Text von der Standardeingabe gelesen. Der Empfänger sieht in seinem Gespräch das Agentensymbol und den Sitzungsnamen des Absenders, auch nach dem erneuten Öffnen.

• Der Empfänger muss eine Sitzung mit Claude Code, Codex, OpenCode, Pi oder OMP in der Gesprächsansicht sein. Archivierte Sitzungen und die sendende Sitzung selbst werden abgelehnt.
• Ein Empfänger im Leerlauf beginnt einen neuen Durchlauf. Bei einem beschäftigten Empfänger wird die Nachricht eingereiht, bis sein Durchlauf endet; --steer fügt sie stattdessen dem laufenden Durchlauf hinzu.
• Eine Nachricht kann bis zu 65.536 Byte Text enthalten.
• Der Befehl gibt eine Empfangsbestätigung aus: sent, queued oder steered. blocked bedeutet, dass der Empfänger auf eine Berechtigung oder eine Antwort wartet. Eine Empfangsbestätigung belegt die Zustellung, nicht aber, dass der Empfänger die Arbeit erledigt hat.
• Der Befehl gibt eine Nachrichten-ID aus. Um eine Zustellung mit ungewissem Ausgang zu wiederholen, führen Sie den Befehl erneut mit --message-id und demselben Text aus; die Nachricht wird nicht doppelt zugestellt.
• --report --round N verwenden Ausführungssitzungen in einem Planungs- und Ausführungsworkflow, um ihr Ergebnis zur Prüfung einzureichen. Die Nachricht geht an die Planungssitzung der jeweiligen Ausführungssitzung. Siehe Planung und Ausführung.

9. vrun

vrun [-t <seconds>] <label> <command> [arguments...]
vrun --status <label>

Startet einen Befehl, wartet auf sein Ende und gibt dann den Exit-Code, die verstrichene Zeit und das Ende seines Protokolls aus. Der Exit-Code des Befehls wird durchgereicht. vrun ist für lange Builds und Tests gedacht: Ein Agent, der sie mit vrun ausführt, erfährt das Ergebnis, sobald es vorliegt.

• -t <seconds> legt fest, wie lange vrun wartet (Standard 1800). Läuft die Zeit ab, beendet sich vrun mit Code 124, und der Befehl läuft weiter.
• --status <label> meldet den Stand eines Befehls, der zuvor mit dieser Bezeichnung gestartet wurde.
• Solange ein Befehl läuft, behält die Sitzung den Status „Arbeitet“. In der Terminalansicht listet eine Zeile „Hintergrundbefehle“ über dem Terminal die laufenden Befehle mit „Protokoll“ und „Stoppen“ auf; siehe Verwendung des Terminals §6.1.

10. vkb

vkb explore <query> | search <query> | node <symbol-id> | callers <id> [depth] | callees <id> [depth]
    | impact <id> [depth] | path <from-id> <to-id> | files [path]
    | memories <query> | memory <entry-id> | notes <query> | note <vault-id> <path> | status

Fragt den Codegraph des aktuellen Checkouts und die Wissensdatenbank des verbundenen VelaTerm ab. Code-Abfragen setzen voraus, dass die Indizierung auf der Seite „Codegraph“ des Projekts aktiviert ist. vkb liest nur; es ändert keine Wissenseinträge. Siehe Codegraph und Wissensdatenbank, Sitzungswissensdatenbank und Lokale Wissensbasen.

11. vflow

vflow status|stop|propose|dispatch|accept|block <workflow-id> [--round N --message-id msg-UUID] < message.txt

Steuert Planungs- und Ausführungsworkflows. Die Planungssitzung verwendet propose, dispatch, accept und block als Teil des Workflows. Sie selbst benötigen meist nur zwei Aktionen:

• vflow status <workflow-id> zeigt den Zustand des Workflows, seine Aufgaben, Sitzungen und die aktuelle Runde.
• vflow stop <workflow-id> beendet weitere Runden und fordert die laufenden Sitzungen zum Anhalten auf.

12. Der Befehl vela

Unter macOS bietet Einstellungen ▸ Allgemein ▸ „Shell-Befehl“ die Schaltfläche „‘vela’-Befehl installieren“. Sie fügt Ihrer Shell den Befehl vela <project-path> hinzu, ähnlich dem Befehl code von VS Code. Wenn Sie ihn in einem beliebigen Terminal ausführen, öffnet VelaTerm das Projekt oder wechselt zu ihm, falls es bereits geöffnet ist. VelaTerm überschreibt keinen vorhandenen vela-Befehl, den es nicht selbst installiert hat.