CLI

Der Befehl cavvy spricht mit demselben Hintergrunddienst wie das Fenster. Du startest damit Sitzungen, gibst ihnen Text, wartest auf sie und siehst dir an, was sie geändert haben. Auch Agenten in einem Task nutzen ihn, um andere Repos zu finden und zu holen.

$ cavvy send 3f9c2a1e "Add token refresh and run the tests"
$ cavvy wait 3f9c2a1e
idle
$ cavvy diff --stat 3f9c2a1e
  +24    -6  src/auth/middleware.ts
  +11    -2  src/auth/session.ts
  +38    -0  test/auth.test.ts

Installieren

Einstellungen → Befehlszeile → Symlink installieren legt cavvy nach ~/.local/bin, mit einem Verweis in die App. Steht der Ordner noch nicht im PATH deiner Shell, zeigt dieselbe Seite die Zeile, die du ergänzen musst. Auf einem Server installiert Cavvy den Befehl neben seinem Hintergrunddienst in ~/.local/bin.

In einer Cavvy-Sitzung brauchst du nichts davon: Der Hintergrunddienst legt sein eigenes cavvy in den PATH der Sitzung.

Eine Sitzung starten

$ cavvy new --worktree feature/x -- claude

Alles nach -- ist der Befehl; ohne ihn startet die Sitzung deine Login-Shell. --worktree <branch> gibt der Sitzung einen eigenen Worktree auf diesem Branch, --base legt fest, wo ein neuer Branch beginnt (sonst beim aktuellen Branch), --name und --cwd setzen Name und Ordner. Der Befehl gibt die ID der Sitzung aus.

Auflisten, senden, warten

$ cavvy ls

Listet jede Sitzung mit ID, Zustand (starting, working, BLOCKED, idle, exited), Name, Ordner und Branch. Die übrigen Befehle nehmen eine ID aus dieser Liste.

$ cavvy send <id> "Run the tests and fix what fails"

Tippt den Text in die Sitzung und drückt Enter; --no-enter lässt Enter weg. cavvy screen <id> gibt aus, was die Sitzung gerade zeigt.

$ cavvy wait <id>

Wartet, bis die Sitzung dich braucht oder fertig ist (blocked,idle). --until nimmt andere Zustände (working, blocked, idle, exited, durch Kommas getrennt), --timeout eine Zahl von Sekunden. Ausgegeben wird der erreichte Zustand.

Änderungen ansehen

$ cavvy diff --stat <id>

Zeigt, was sich im Ordner der Sitzung seit dem Basis-Branch ihres Worktrees geändert hat, außerhalb eines Tasks die nicht committeten Änderungen. Ohne --stat kommen die vollständigen Patches.

Für Agenten

Ein Agent in einem Cavvy-Task sagt mit diesen Befehlen, wann er fertig ist, und arbeitet über mehrere Repos. Cavvy nennt sie ihm in den Aufgabenregeln; sie funktionieren nur in einer Cavvy-Sitzung.

$ cavvy done

Sagt, dass die verlangte Arbeit fertig ist. Erst dann zeigt Cavvy den Task am Ende des Durchgangs als bereit zum Prüfen; ein Agent, der ohne den Befehl anhält, wartet unter Braucht dich. Siehe Leitstand.

$ cavvy repos

Listet die Repos des Projekts, zu dem der Task gehört, auf diesem Rechner, eines pro Zeile. Das eigene Repo des Tasks ist mit (this task) markiert. cavvy projects geht weiter als anderer Name.

$ cavvy task add shop-api

Legt einen Worktree dieses Repos auf dem Branch des Tasks an, ausgehend von dessen Hauptbranch (nach einem Fetch von origin, falls es eines gibt), und gibt seinen Pfad aus. Dort arbeitet und committet der Agent. Damit reicht der Task über mehrere Repos: Der neue Teil erscheint sofort in deiner Liste, ungelesen und mit Mitteilung, und die Einrichtung des Repos läuft neben dem Agenten.

$ cavvy task add ~/Developer/billing
cavvy task add --clone [email protected]:shop/billing.git

Mit einem Pfad holt der Agent ein anderes Repo desselben Rechners; --clone klont erst eines, neben das erste Repo des Projekts (in einem Projekt ohne Repo nach ~/Developer). So oder so kommt das Repo sofort ins Projekt, mit neu markiert und mit Mitteilung. task add geht nur aus einem Task oder dem Ordner eines Tasks heraus; einen Namen, den das Projekt nicht kennt, lehnt Cavvy ab und nennt seine Repos.

Hat ein Teil schon eine eigene Sitzung, übergibt der Agent ihr die Arbeit mit cavvy send <id> "…" und wartet mit cavvy wait <id>, statt den Teil selbst zu ändern.

Agenten auf einem Rechner

$ cavvy agents

Zeigt, welche Coding-Agenten der Rechner hat, in welcher Version, ob sie angemeldet sind und ob es ein Update gibt. --install <agent>, --update <agent> und --login <agent> starten den offiziellen Installer, das Update oder die Anmeldung in einer neuen Sitzung und geben ihre ID aus. Mit --host meldet sich Codex per Gerätecode an. Einstellungen → Agenten kann dasselbe im Fenster.

Weitere Befehle

ls, repos, status, doctor und agents nehmen --json für Skripte.

Auf einem Server

--host (kurz -H) führt jeden Befehl auf einem Server aus, mit dem Host-Alias aus deiner SSH-Konfiguration:

$ cavvy --host build ls

Siehe Server.