Dokumentation
Erste Schritte
Vom Download zum ersten Task in wenigen Minuten.
Cavvy installieren
Lade Cavvy für macOS 26 Tahoe oder neuer. Es läuft auf Macs mit Apple Silicon und Intel und ist signiert und notarisiert. Cavvy startet seinen Hintergrunddienst in deiner Anmeldesitzung; dort laufen die Sitzungen, nicht im Fenster.
Das Fenster
Cavvy hat drei Spalten:
- Die Seitenleiste links: oben der Projekt-Umschalter, darunter Alle Tasks und die Repos des Projekts, unten die Nutzung. Ein Repo auf einem Server sagt, wo es läuft.
- Tasks in der Mitte, geordnet danach, was sie von dir brauchen: zuerst Braucht dich und Probleme, dann Bereit zum Prüfen, Automatische Prüfung, Arbeitet, Ruht, Geparkt und Heute gemergt. Siehe Leitstand.
- Der Task rechts: sein Terminal, seine Änderungen und sein Verlauf.
Agenten einrichten
Einstellungen → Agenten zeigt, welche Agenten jeder Rechner hat: Claude Code, Codex, opencode und Gemini CLI. Installieren…, Aktualisieren… und Anmelden… starten den offiziellen Installer, das Update oder die Anmeldung in einer neuen Sitzung, damit du siehst, was passiert. Jeder Agent nutzt seinen eigenen Login; ein Konto bei Cavvy brauchst du nicht.
Ein Projekt anlegen
Ein Projekt ist eine Menge von Repos, die du zusammenstellst. In Neues Projekt… (⇧⌘N) wählst du unter Woher: Vorhandener Ordner, Klonen von einer Adresse, Leer anfangen oder Noch kein Repo. Dazu kommen der Server, auf dem das Repo liegt, ein Name und bei einem vorhandenen Ordner ein Icon. Repo hinzufügen… im Projekt-Umschalter holt weitere dazu.
Liegen deine Repos nebeneinander in einem Ordner, wähl diesen Ordner: Cavvy listet sie auf, und die angehakten kommen ins Projekt. Siehe Projekte & Repos.
Cavvy sagen, wie jedes Repo funktioniert
Ein Klick auf ein Repo in der Projekt-Info (⌘I) öffnet seine Seite. Ihre Einstellungen enthalten, was Cavvy wissen muss; jeder Abschnitt bietet unter Gefunden: an, was er im Repository entdeckt hat.
- Einrichtung: Befehle, die einen neuen Worktree vorbereiten, bevor der Agent startet, etwa
pnpm install --frozen-lockfile. Siehe Tasks. - Fertig heißt: Befehle, die die Arbeit prüfen, wenn ein Agent fertig ist, etwa
make test. Siehe Fertig heißt. - Review: ob eine Zweite Meinung jede Änderung liest, und welcher Agent sie gibt.
Den ersten Task geben
Neuer Task… (⌘N): Projekt und Repos wählen, aufschreiben, was passieren soll, Agent wählen und Starten. Cavvy legt einen Branch und einen Worktree an, führt die Einrichtung aus und startet dort den Agenten. Der Task erscheint unter Arbeitet, und wenn der Agent dich braucht, unter Braucht dich.
Der Worktree ist ein normaler Ordner: Öffne ihn in deinem Editor, wann immer du willst. Einen eigenen Editor bringt Cavvy nicht mit.
Weiter
- Tasks: was passiert, wenn ein Task startet.
- Leitstand: wie du siehst, welcher Agent dich braucht.
- Abschließen: wie die Arbeit in deinen Hauptzweig kommt.