Lokale CI

Die Schleife push–warten–rotes Kreuz–fixen–push verschwendet zehn Minuten pro Runde. Mit act laufen dieselben Workflows in Docker-Containern auf deinem Rechner, und Gitcito steuert sie: Workflow auswählen, Ausführen drücken, dasselbe Log verfolgen, das die CI ausgeben würde — bevor irgendetwas deinen Rechner verlässt.

Eine Integration, keine mitgelieferte Runtime

Gitcito liefert act und Docker ganz bewusst nicht mit — eine App, die eine Container-Runtime mitschleppt, ist das Gegenteil eines Git-Clients. Es ist eine Opt-in-Integration: aktiviere sie unter Einstellungen → Integrationen (oder direkt im Dialog), und Gitcito erkennt, was installiert ist, und führt dich durch den Rest — brew install act, ein laufender Docker-Daemon, fertig. Nichts läuft, bevor alle drei Bedingungen erfüllt sind: aktiviert, act installiert, Docker erreichbar.

Was es tut

• Listet jeden Workflow unter .github/workflows auf, nach seinem name:.
• Ausführen startet den Workflow mit act gegen deinen Arbeitsbaum — ungecommittete Änderungen eingeschlossen, und genau das ist der Punkt: testen vor dem Commit, nicht nach dem Push.
• Die Ausgabe streamt live in den Dialog; Stoppen beendet den Lauf. Exit 0 zeigt Bestanden, alles andere Fehlgeschlagen mit dem Code.

Urteile pro Commit im Graphen

Ein abgeschlossener Lauf heftet sein Ergebnis an den Commit, den er getestet hat: ein kleiner Kolben markiert die Zeile im Graphen grün oder rot, sodass du auf einen Blick siehst, welche Commits die CI lokal schon überstanden haben. Das Urteil wird als Git-Note unter refs/notes/gitcito-ci gespeichert — lokal auf deinem Rechner, standardmäßig nie gepusht.

Ehrlichkeitsregel: Das Urteil wird nur angeheftet, wenn dein Arbeitsbaum sauber war. Ein Lauf über ungecommittete Änderungen hat etwas getestet, das kein Commit enthält — er zeigt sein Ergebnis also im Dialog, markiert aber nichts.

Einen Commit oder Bereich testen — ohne deinen Branch zu verlassen

Der Bereich Einen Commit oder Bereich testen im Dialog führt einen Workflow gegen Commits aus, auf denen du gerade nicht stehst. Jeder Commit wird detached in einen Wegwerf-Worktree unter dem temporären Systemverzeichnis ausgecheckt, act läuft dort, und der Worktree wird entfernt, wie auch immer der Lauf endet — dein Arbeitsbaum und dein Branch bewegen sich nie. Weil dieser Checkout konstruktionsbedingt makellos ist, wird das Urteil immer an den getesteten Commit geheftet. Ein Rechtsklick auf einen Commit im Graphen bietet direkt Lokale CI auf diesem Commit ausführen an.

Die Kosten werden genannt, bevor irgendetwas läuft, statt hinterher entdeckt zu werden: Tippe eine Revision oder einen Bereich ein (main..HEAD, HEAD~5.., eine sha), drücke Vorschau, und Gitcito zeigt, wie viele Commits die Angabe trifft und welche neuesten N — das explizite Budget, gedeckelt bei 50 — tatsächlich laufen würden. Ein Durchlauf führt sie nacheinander aus (act plus Docker ist schwer genug, dass parallele Läufe um die Maschine kämpfen würden), streamt das Log jedes Laufs, markiert jeden Commit live als bestanden/fehlgeschlagen, und Stoppen bricht zwischen den Commits ab und beendet dabei den laufenden. Rechne mit echten Minuten pro Commit.

Eine weitere Grenze, die man kennen sollte: Der Wegwerf-Worktree enthält die Dateien des Commits, aber nicht die Submodul-Checkouts deines Repositorys — ein Workflow, der von initialisierten Submodulen abhängt, verhält sich wie auf einem frischen Klon ohne sie.

Grenzen

• act ist eine sehr gute Imitation der GitHub-Runner, keine perfekte: Actions, die von GitHub gehostete Dienste, Secrets oder exotische Runner-Images brauchen, können sich anders verhalten. Ein lokales Grün ist ein starkes Indiz, keine Garantie.
• Ein Lauf pro Repository zur gleichen Zeit; ein weiterer Start bricht den ersten ab.
• Nur Läufe auf Workflow-Ebene — einzelne Jobs, Matrizen oder Events auszuwählen ist act-Territorium; führe es im Integrierten Terminal aus, wenn du Flags brauchst.
• Der erste Lauf lädt die Runner-Images herunter — rechne damit, dass er einmal langsam ist.

Siehe auch: Hosting & Pull Requests · Integriertes Terminal