Für Nutzer · Loslegen
Erste Schritte
Auf dieser Seite
Gitoodo ist ein Orchestrator für deine Repos: Du beschreibst, was entstehen soll, Gitoodo macht daraus Issues und lässt Coding-Agenten (Claude Code, Codex oder Gemini CLI) als Worker daran arbeiten, bis die Pull Requests gemergt sind. Der direkte Modus ist die leichtere Variante: Er sammelt nur, was auf dich wartet. Diese Seite führt dich von der Installation bis zum ersten Worker.
Was du brauchst#
- Einen Mac mit Apple Silicon oder Windows 10/11 (x64).
- Ein Konto bei Forgejo, Gitea, GitHub oder GitLab, auch selbst gehostet.
- Für den Orchestrator: eine Agenten-CLI, die du schon nutzt und in der du angemeldet bist (Claude Code, Codex oder Gemini CLI). Worker laufen mit deinem eigenen Abo; Gitoodo braucht keinen API-Schlüssel.
Installieren#
Gitoodo ist noch nicht veröffentlicht. Diese Befehle funktionieren ab dem ersten Release.
macOS (Apple Silicon). Eine Zeile im Terminal lädt das signierte und notarisierte Release, prüft seine SHA-256-Summe, installiert Gitoodo nach /Applications (oder ~/Applications), verlinkt den Befehl gitoodo nach ~/.local/bin und öffnet die App. Erneut ausgeführt aktualisiert sie an Ort und Stelle; sudo ist nicht nötig.
curl -fsSL https://gitoodo.com/install.sh | bashGitoodo vollständig entfernen (App, Befehl, Dienste, Einstellungen, Caches, Logs, gespeicherte Tokens, Agenten-Skill und Datenschutz-Freigaben):
curl -fsSL https://gitoodo.com/uninstall.sh | bashVon Gitoodo geklonte Repos löscht es nur nach Rückfrage, deine eigenen Checkouts nie; --dry-run zeigt nur, was es entfernen würde.
Windows 10/11 (x64). Eine Zeile in PowerShell liest das Release, prüft die SHA-256-Summe des Setups und seinen Herausgeber (die Code-Signatur), installiert Gitoodo nur für deinen Benutzer nach %LOCALAPPDATA%\Gitoodo, legt den Befehl gitoodo in deinen PATH und öffnet die App. Erneut ausgeführt aktualisiert sie an Ort und Stelle; Administratorrechte sind nicht nötig.
irm https://gitoodo.com/install.ps1 | iexSolange der Windows-Installer eines Release noch nicht signiert ist, bricht der Befehl vor der Installation ab und sagt das; lade dann das Setup (.exe) im Download-Bereich herunter. Windows SmartScreen warnt dabei vor einem unbekannten Herausgeber: Weitere Informationen und dann Trotzdem ausführen wählen.
Gitoodo vollständig entfernen (App, Befehl, Hintergrundaufgabe, Einstellungen, Caches, Logs, gespeicherte Tokens in der Anmeldeinformationsverwaltung, Autostart und Agenten-Skill):
irm https://gitoodo.com/uninstall.ps1 | iexWie unter macOS löscht es von Gitoodo geklonte Repos nur nach Rückfrage und deine eigenen Checkouts nie. Optionen stehen hinter dem Skript, zum Beispiel & ([scriptblock]::Create((irm https://gitoodo.com/uninstall.ps1))) -DryRun. Du kannst das Setup (.exe) auch von der Releases-Seite des Projekts laden und ausführen; prüfe den Herausgeber, bevor du eine Systemabfrage bestätigst.
Aus dem Quellcode. Mit Rust, Node.js und den Voraussetzungen von Tauri 2 bauen npm ci und npm run tauri build die Installer für das aktuelle System; siehe Building (Englisch).
Die Einführung#
Beim ersten Start führt Gitoodo dich durch eine kurze Einführung. Jeden Schritt kannst du überspringen und die ganze Einführung später unter Hilfe & Feedback → Erste Schritte wiederholen.
- Sprache. Gitoodo folgt der Systemsprache; unter Einstellungen → Allgemein änderst du sie.
- Wie soll Gitoodo arbeiten? Wähle Orchestrator (empfohlen) oder Direkt. Wechseln kannst du jederzeit unter Einstellungen → Betriebsart.
- Forge verbinden. Gib die Serveradresse und ein Token ein. Der Token-Assistent fragt, was Gitoodo mit deinen Repositories tun soll (vorausgewählt nach der eben gewählten Betriebsart), öffnet die Token-Seite deiner Forge und nennt in einem Block jedes Recht, das das Token dafür braucht, mit seinem Grund und der Rolle, die dein Konto braucht. Bestätige, dass du diese Rechte gesetzt hast, füge das Token ein und klicke Prüfen. Das Token landet im Schlüsselspeicher des Systems (macOS-Schlüsselbund, Windows-Anmeldeinformationsverwaltung), nie in einer Datei oder einem Log.
- Repos. Schalte die Repos ein, die Gitoodo lesen soll. Ausgeschaltete fragt es gar nicht erst ab.
- Orchestrator einrichten (nur im Orchestrator-Modus). Gitoodo richtet jedes eben gewählte Repo gleich ein: Labels, Einschalten und lokale Kopie, dazu Hintergrunddienst, Skill und Dispatcher.
- Benachrichtigungen. Erlaube Benachrichtigungen, damit Gitoodo dir Bescheid gibt, wenn eine Entscheidung wartet, auch bei geschlossenem Fenster.
- Start und Tastenkürzel. Lege fest, ob Gitoodo bei der Anmeldung startet und mit welchem Tastenkürzel du es aus jeder App öffnest.
- Nutzungsstatistik. Der letzte Schritt zeigt die anonyme Nutzungsstatistik mit dem, was sie sendet; dort kannst du sie ausschalten. Vor dem Ende der Einführung wird nichts gesendet.
Danach sitzt Gitoodo als Haken in der macOS-Menüleiste oder im Infobereich von Windows. Wird der Haken rot, wartet etwas auf dich.
Zuerst der Orchestrator-Modus#
Hast du den Orchestrator gewählt, endet die Einführung im Einrichtungsassistenten. Er prüft jeden Teil der Einrichtung sofort und erledigt, was fehlt:
- den Hintergrunddienst (
gitoodo service install: launchd, eine systemd-Benutzereinheit oder eine geplante Aufgabe), - die Status-Labels in jedem Repo,
- das Einschalten des Repos für die Orchestrierung und eine lokale Arbeitskopie,
- die Agenten-Anweisungen und den optionalen Skill
gitoodo-questions, - den Dispatcher, der die Worker startet, und eine Prüfung, ob deine Agenten-CLI installiert und angemeldet ist.
Den Assistenten öffnest du jederzeit wieder unter Einstellungen → Betriebsart mit Einrichtung starten; jeder Schritt geht auch von Hand, siehe Orchestrator setup (Englisch).
Ab dann läuft die Arbeit so:
- Bring Issues ins Repository, auf einem von zwei Wegen: Beschreibe deinen Plan im Tab Chat, dann schlägt der Orchestrator Repos und Issues vor und legt sie erst nach deinem Klick an; oder schreib Issues selbst, auf der Forge oder mit Neues Issue auf dem Board. Gitoodo behandelt beide gleich.
- Der Dispatcher startet für jedes bereite Issue einen Worker, jeden in eigenem Worktree und Branch. Das Board zeigt, was gerade läuft, und lässt dich in jeden Worker hineinschauen.
- Braucht ein Worker eine Entscheidung, fragt er in seinem Issue. Die Frage erscheint unter Fragen an mich als Antwortkarte mit vorausgewählter Empfehlung.
- Fertige Pull Requests werden in dem Stil gemergt, den dein Repo erlaubt; siehe Merge und Release.
Die Store-Version für den Mac App Store hat keinen Orchestrator: Ihre Sandbox erlaubt keine Hintergrunddienste und keine Worker. Der Orchestrator kommt mit der Version zum direkten Download.
Der direkte Modus#
Der direkte Modus braucht nur ein Konto. Gitoodo fragt deine Forges aus der App ab und zeigt über Repos und Konten hinweg, was auf dich wartet: Fragen in Issues, zugewiesene Issues, Review-Anfragen und Status-Labels, mit Zähler im Menüleisten-Symbol und Benachrichtigungen. Er startet keine Worker und lässt Labels in Ruhe. Beide Modi lesen dieselben Issues; du kannst direkt anfangen und später unter Einstellungen → Betriebsart zum Orchestrator wechseln.
Wie es weitergeht#
- Alltag: die vier Tabs und wie ein Tag mit Gitoodo aussieht.
- Fragen: wie Agenten fragen und wie du antwortest.
- Einstellungen: jede Einstellung an einem Ort.
- Fehlerbehebung und Häufige Fragen, wenn etwas nicht klappt.