Forgejo

Das Forgejo-Plug-in spricht die REST-API einer Forgejo- oder Gitea-Instanz an. Damit kannst du:

• Repositories durchsuchen und verwalten – suchen, anlegen, Branch- und Commit-Historie ansehen
• Issues und Kommentare bearbeiten – auflisten, anlegen, ändern, Labels und Meilensteine setzen
• Pull Requests verfolgen – auflisten, anlegen und mergen
• Dateien direkt im Repo ändern – Dateien mit commit auslesen und schreiben
• Benachrichtigungen prüfen – ungelesene Meldungen des angemeldeten Benutzers abrufen

Typische Einsatzfälle: Issue-Triage, automatisierte Änderungen an Dokumentation oder Konfiguration, Release- und PR-Überwachung.

Einrichtung

Erstelle eine Instanz im Plug-in-Manager und trage die Zugangsdaten ein:

Feld	Bedeutung
Base URL	Adresse der Forgejo-Instanz, z. B. https://codeberg.org (Pflicht)
API token	Persönlicher Zugriffstoken des Benutzers (Pflicht)
Verify TLS certificate	Ob das TLS-Zertifikat geprüft werden soll (Standard: ja)

Tools

Verbindung und Übersicht

Tool	Funktion
forgejo_ping	Prüft die Erreichbarkeit der API und meldet die Forgejo-Version.
forgejo_user	Zeigt den angemeldeten Benutzer.
forgejo_notifications_list	Listet die Benachrichtigungen des Benutzers (optional nur ungelesene).
forgejo_orgs_list	Listet die Organisationen des Benutzers.

Repositories

Tool	Funktion
forgejo_repos_search	Sucht Repositories (global oder auf einen Besitzer begrenzt).
forgejo_repo_get	Liefert ein einzelnes Repository.
forgejo_repo_create	Legt ein Repository für den angemeldeten Benutzer an.
forgejo_branches_list	Listet die Branches eines Repositories.
forgejo_commits_list	Listet die Commits eines Repositories (optional auf einen Branch begrenzt).
forgejo_releases_list	Listet die Releases eines Repositories.
forgejo_repo_delete	Löscht ein ganzes Repository (destruktiv).

Issues und Kommentare

Tool	Funktion
forgejo_issues_list	Listet Issues eines Repositories (optional nach Status gefiltert).
forgejo_issue_get	Liefert ein einzelnes Issue.
forgejo_issue_create	Legt ein Issue an.
forgejo_issue_edit	Ändert ein Issue (Titel, Beschreibung, Status, Labels, Zuweisungen, Meilenstein).
forgejo_issue_comments_list	Listet die Kommentare eines Issues.
forgejo_issue_comment_create	Fügt einen Kommentar hinzu.
forgejo_issue_comment_delete	Löscht einen Kommentar (destruktiv).
forgejo_labels_list	Listet die Labels eines Repositories.
forgejo_milestones_list	Listet die Meilensteine eines Repositories.

Pull Requests

Tool	Funktion
forgejo_pulls_list	Listet die Pull Requests eines Repositories.
forgejo_pull_create	Legt einen Pull Request an.
forgejo_pull_merge	Mergt einen Pull Request.

Dateien

Tool	Funktion
forgejo_file_get	Liest eine Datei aus einem Repository (Base64-Inhalt, optional dekodiert).
forgejo_file_write	Erstellt oder aktualisiert eine Datei im Repository (erzeugt einen Commit).

Typische Arbeitsabläufe

Issue-Triage

1. forgejo_notifications_list – worüber wurde ich informiert?
2. forgejo_issues_list eines Repositories – offene Vorgänge sichten.
3. forgejo_issue_get – Details zu einem Issue lesen.
4. forgejo_issue_comment_create – Nachfrage oder Zwischenstand hinterlassen.
5. forgejo_issue_edit – z. B. Label setzen oder Status auf „geschlossen“ ändern.

Datei im Repo pflegen

1. forgejo_file_get – aktuelle Datei lesen (z. B. docs/README.md).
2. Inhalt anpassen und forgejo_file_write mit dem neuen Inhalt und Commit-Nachricht aufrufen.
3. forgejo_commits_list – prüfen, dass der Commit angekommen ist.

Entwicklung verfolgen

1. forgejo_repos_search – passende Repositories finden.
2. forgejo_pulls_list – offene Pull Requests sichten.
3. forgejo_pull_merge – einen geprüften PR mergen.
4. forgejo_releases_list – neue Releases im Blick behalten.

Hinweise für KI-Agenten

• Löschen ist endgültig: forgejo_repo_delete, forgejo_issue_delete und forgejo_issue_comment_delete sind destruktiv und erfordern ein bestätigendes confirm-Argument (z. B. owner/repo, #index, #id) sowie die Instanz-Einstellung, die destruktive Aktionen erlaubt.
• Kontext angeben: Die meisten Tools brauchen die Repository-Kennung im Format owner/repo. Wenn du nur einen Namen hast, vorher forgejo_repos_search aufrufen, um den Besitzer zu ermitteln.
• Keine Secrets in Issues: Weder Tokens noch Passwörter in Issue-Texten, Kommentaren oder Commit-Nachrichten ablegen.
• Nach jeder Schreibaktion prüfen: Nach forgejo_file_write oder forgejo_issue_edit das Ergebnis mit der passenden Lese-Operation gegenzulesen.