Dokumentation Doku-Version: dev (Vorabstand: Gitoodo ist noch nicht veröffentlicht)

Für Nutzer · Alltag

Board

Auf dieser Seite
  1. In Arbeit
  2. Issues
  3. Pull Requests
  4. Release
  5. Worker
  6. Agenten
  7. Steuerung
Bildschirmfoto der App: Board

Das Board zeigt jedes offene Issue mit Status, Score und dem Agenten, der daran arbeitet. Suche und Filter grenzen es auf Repositories, Zustände oder Labels ein.

  • Neues Issue legt ein Issue an, auf Wunsch gleich als bereit.
  • Agent-Sitzung zeigt die laufende Sitzung eines Agenten im Terminal.
  • Im Chat besprechen übergibt ein Issue an den Chat.

Das Board ist in Unterseiten geteilt. Im Orchestrator-Modus sind das In Arbeit, Issues, Release, Agenten und Steuerung, im direkten Modus In Arbeit, Issues und Pull Requests. Gitoodo merkt sich die zuletzt genutzte Unterseite und öffnet sie wieder. Ein Klick auf ein Issue öffnet überall auf dem Board seine Details: Repository, Zustand, Labels, Priorität, wovon es abhängt, Meilenstein, wer daran arbeitet und, wenn es zum nächsten Release gehört, warum.

In Arbeit#

Was läuft, was als Nächstes kommt und was hängt

Im Orchestrator-Modus beantwortet diese Seite auf einen Blick, ob alles läuft. Die Zeile ganz oben sagt, ob der Orchestrator läuft, angehalten oder nicht erreichbar ist; ein Klick darauf öffnet Steuerung. Darunter stehen Laufende Worker (mit Terminal, um einem laufenden Worker live zuzusehen; ein Hinweis darunter nennt, wie viele Liegen geblieben sind), die Pull Requests, die Bereit zum Mergen sind, die bereiten Issues Als Nächstes in der Reihenfolge, in der der Dispatcher sie nimmt (vorgezogene zuerst, dann nach Score), und was Hängt fest: Issues, die einen Menschen, eine Freigabe oder eine Klärung brauchen, sowie blockierte, hängende oder zurückgestellte. Ein Klick auf einen dieser Zustände oder auf Alle zeigt genau diese Issues unter Issues.

Im direkten Modus zeigt die Seite stattdessen, was dich braucht: wie viele Fragen in Fragen an mich warten, die Zähler Frage offen, Blockiert, CI rot und Veraltet (ein Klick filtert die Liste unter Issues), den Durchsatz der letzten Zeit und einen Link zu den offenen Pull Requests.

Issues#

Issues und Pull Requests nach Zustand

Issues listet alle Issues und Pull Requests deiner eingeschalteten Repositories. Im Orchestrator-Modus sind sie nach Repository gruppiert: Board durchsuchen findet Einträge per Text, Filter grenzen die Liste nach Repository, Zustand oder Label ein, und Filter zurücksetzen zeigt wieder alles. Im großen Fenster stehen Liste und Details des gewählten Eintrags nebeneinander.

Im Orchestrator-Modus trägt jede Zeile die Aktionen, die zu ihrem Zustand passen: Terminal bei einem laufenden Worker; Parken, Neu starten oder Stoppen, um einen Worker zu steuern (Stoppen und Neustarten fragen vorher nach); Vorziehen, um ein bereites Issue an den Anfang der Warteschlange zu ziehen; und Merge steuern, um den Pull Request eines Issues im Review anzuhalten oder Einspruch einzulegen. Im direkten Modus wechselt Gruppieren nach zwischen Status, Repo, Konto, Zahlen (eine Tabelle mit Zählern; ein Klick auf eine Zahl öffnet die gefilterte Liste) und Braucht dich.

Pull Requests#

Offene Pull Requests mit Prüfungen und Merge-Stand

Nur im direkten Modus: alle offenen Pull Requests deiner Repositories, nach Repository gruppiert. Jeder zeigt, ob seine Checks grün sind, fehlgeschlagen (mit dem Namen des ersten fehlgeschlagenen Checks), noch laufen oder fehlen, ob er sich mergen lässt oder einen Konflikt hat und welche Issues er schließt. Pull Requests, die einen Blick brauchen, sind hervorgehoben, und In Arbeit zählt sie. Ein Klick öffnet den Pull Request auf der Forge.

Release#

Wie weit das nächste Release je Repository ist

Die Release-Planung nutzt die Meilensteine der Forge. Ins nächste Release kommt ein Issue mit dem Label release:next, als Abhängigkeit eines Release-Issues oder mit priority:p0.

Release-Stand je Repository zeigt, wie weit das nächste Release jedes Repositorys ist und was darin noch offen ist. Zusammenfassung kopieren kopiert den Release-Plan als Text; mit Link zu Gitoodo anhängen endet er mit einem Link zu Gitoodo.

Worker#

Alle laufenden Worker live, hier und auf Worker-Rechnern

Jede Kachel zeigt das Terminal eines Workers verkleinert und live. Groß geöffnet bleibt es zunächst nur zum Ansehen; erst „Eingreifen“ schickt deine Tasten, Einfügen und Strg-C an den Worker, nach einer Rückfrage. Was angezeigt wird, durchläuft dieselbe Schwärzung wie die Protokolle, bekannte Tokens erscheinen nie.

Agenten#

Wer woran arbeitet und was auf der Forge geschrieben wurde

„Liegen geblieben“ sind Issues, deren Reservierung abgelaufen ist oder die als hängend markiert wurden, ohne dass noch ein Worker dafür läuft; sie zählen nicht als Arbeit, und mit „ready“ statt „stalled“ kommen sie zurück in die Warteschlange.

Jeder Schreibzugriff auf die Forge, neueste zuerst

Laufende Worker listet jedes Issue, an dem gerade wirklich gearbeitet wird: zuerst die Worker, die dieser Orchestrator startet (auf diesem Gerät oder auf einem Worker-Rechner, dessen Name dabeisteht), dann Issues, die ein anderer Orchestrator mit einer noch gültigen Reservierung hält. Eine Reservierung gilt, solange sie nicht abgelaufen ist und das Issue noch in Arbeit oder im Review steht. Ist sie abgelaufen oder wurde das Issue als hängend markiert, zählt es nicht mehr als Arbeit, sondern steht eingeklappt unter Liegen geblieben; mit „ready“ statt „stalled“ kommt es zurück in die Warteschlange. Die Kachel Worker der Übersicht zählt dieselben Worker und nennt, wie viele hier, auf einem Worker-Rechner oder auf anderen Rechnern laufen. Die Aktionen sind dieselben wie unter Issues: Terminal öffnet das Live-Terminal (macOS und Linux), Trennen verlässt es, der Worker läuft weiter; Parken beendet den Worker und hält das Issue, bis ein Mensch entscheidet, Neu starten startet ihn im selben Worktree neu, Stoppen beendet ihn endgültig und gibt das Issue an einen Menschen.

Aktivität ist das Protokoll jedes Schreibzugriffs des Orchestrators auf die Forge, neueste zuerst: welches Issue oder welcher Pull Request, was geschrieben wurde und warum, markiert als Erfolgreich oder Fehlgeschlagen. Ein Klick auf den Eintrag öffnet ihn auf der Forge; Nach Repository filtern grenzt das Protokoll auf ein Repository ein.

Steuerung#

Automatik anhalten, Merges zurückhalten, Repos pausieren

Orchestrator an/aus hält alles an: keine neue Arbeit, kein Zusammenführen. Laufende Agenten geben ihre Issues zurück in die Warteschlange.

Halte einen Pull Request an oder lege ein Veto ein, bevor der Orchestrator ihn zusammenführt. Eine auf der Forge bereits eingeschaltete automatische Zusammenführung lässt sich von hier nicht zurücknehmen.

Unter Repositories pausierst du einzelne Repositories statt des ganzen Orchestrators: Dort starten keine neuen Worker, laufende arbeiten zu Ende. Fortsetzen lässt das Repository wieder Arbeit annehmen.

Doku-Version: dev