Dokumentation
Projekte & Repos
Wie Cavvy deine Repos ordnet.
Projekte und Repos
Ein Repo ist ein git-Repository, auf diesem Mac oder auf einem Server. Seine Tasks laufen in eigenen Worktrees, der Hauptordner des Repos bleibt also, wie du ihn verlassen hast.
Ein Projekt ist eine Menge von Repos, die du zusammenstellst, etwa App, API und Webseite eines Kunden, oder nur das eine Repo eines kleinen Werkzeugs. Die Repos dürfen auf verschiedenen Rechnern liegen, und ein Projekt darf leer sein. Ein Repo kann in mehreren Projekten stecken; ein Task merkt sich sein Projekt und erscheint nur dort.
Der Projekt-Umschalter
Der Umschalter oben in der Seitenleiste zeigt ein Projekt oder Alle Projekte. Du wechselst mit ⌃1 bis ⌃9 zu den ersten neun Projekten; ⌃0 zeigt Alle Projekte. Ein Punkt am Umschalter sagt, dass in einem anderen Projekt etwas wartet; in seinem Menü steht bei Projekten mit wartender Arbeit in Klammern, wie viel.
Unter dem Umschalter zeigt die Seitenleiste nur das gezeigte Projekt: Alle Tasks und, wenn es mehr als ein Repo hat, je Repo eine Zeile, die nur dessen Tasks zeigt. Ein Repo auf einem Server sagt auf build, und auf build · nicht erreichbar in Rot, wenn der Server nicht erreichbar ist. Tasks eines nicht erreichbaren Servers stehen unter Probleme.
Im Menü des Umschalters liegt der Rest: Neues Projekt… und für das gezeigte Projekt Repo hinzufügen…, Projekteinstellungen…, Umbenennen…, Verschieben nach oben oder unten, ein Trenner und Projekt löschen…. Trenner werden zu Abschnitten des Menüs. Reihenfolge sortiert die Projekte Nach Name oder Manuell. Ziehst du eine Sitzung außerhalb eines Tasks auf den Umschalter, fragt Cavvy, in welches Projekt sie gehört; auf ein Repo gezogen, kommt sie in das gezeigte Projekt.
Repos hinzufügen
Neues Projekt… (⇧⌘N) beginnt mit einem ersten Repo oder mit Noch kein Repo. Repo hinzufügen… holt weitere dazu. Beide bieten Vorhandener Ordner, Klonen von einer Adresse oder Leer anfangen, auf diesem Mac oder auf einem Server.
Wählst du einen Ordner voller Repos, listet Cavvy sie auf; die angehakten kommen einzeln ins Projekt. Repos, die später im Ordner auftauchen, kommen nicht von selbst dazu.
Die eine Ausnahme ist ein Agent: In einem Task darf er jedes Repo holen, das er braucht. Ein Repo, das noch nicht im Projekt war, kommt sofort hinein, mit neu markiert, mit Mitteilung und einem Eintrag im Verlauf. Nichts kommt unbemerkt dazu.
Projekt-Info und die Repo-Seite
Projekt-Info (⌘I) hat drei Reiter: Übersicht mit den Repos des Projekts, Verlauf (die letzten sieben Tage) und Einstellungen. Die Einstellungen sagen, wie Tasks laufen: Branch-Präfix, Standardagent, Erst planen und Basis vorher von origin pullen. Unter Tasks abschließen steht, wie sie enden: Merge oder Merge Request, Push und Aufräumen.
Ein Klick auf ein Repo in der Projekt-Info, oder ⌘I, während die Liste ein Repo zeigt, öffnet seine eigene Seite: Einrichtung, Fertig heißt, die Zweite Meinung, Hauptzweig und letzte Commits, Sitzungen im Hauptordner und gelöschte Tasks. Das gehört zum Repo und gilt deshalb in jedem Projekt, in dem es steckt.
Alle Projekte und „Seit deinem letzten Blick“
Alle Projekte zeigt alle Tasks in einer Liste. Ist kein Task ausgewählt, zeigt die rechte Spalte Seit deinem letzten Blick: was in jedem Projekt passiert ist, während du weg warst. Siehe Leitstand.
Server
Server stehen unter Einstellungen → Server. In der Seitenleiste erscheinen sie nur bei ihren Repos, mit ihrem Zustand. Siehe Server.