This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
Forge CLI
forge ist eine Kommandozeilenanwendung zur Arbeit mit Forgejo. Über die CLI lassen sich Repositories, Issues, Pull Requests, Releases, Wikis, Projekte, Actions und weitere Forgejo-Ressourcen aus dem Terminal verwalten.
Schnellstart
forge --help
forge --repo frank/forgecli <command>
forge issue --help
forge wiki --help
Ein Repository wird mit --repo beziehungsweise -R im Format [HOST/]OWNER/REPO angegeben. Ein anderes Forgejo-Ziel kann mit --host gewählt werden.
Dokumentation nach Themengebiet
Einstieg und Konten
- Hilfe und Version – Hilfeebenen und Versionsanzeige
- Update – CLI aus Releases aktualisieren (
forge update) - Authentifizierung – Anmeldung, Tokens, Hosts und Git-Credentials
- Konfiguration – Standard-Host und lokale Einstellungen
- Shell-Vervollständigung – Bash-, Fish-, PowerShell- und Zsh-Unterstützung
Repositories und Git
- Repositories – Erstellen, Anzeigen, Bearbeiten (Beschreibung/Themen), Klonen, Forks, Archivieren und Dateien lesen
- Git-Arbeitsablauf –
pull,pushund Remotes - Browser – Repository im Browser öffnen
- Branch-Schutzregeln – Regeln anzeigen
Zusammenarbeit
- Issues – Issues erstellen, kommentieren, Abhängigkeiten setzen, schließen und wieder öffnen
- Pull Requests – Pull Requests erstellen, kommentieren, mergen und verwalten
- Labels und Organisationen – Labels und Organisationen
- Projekte – Forgejo-Projekte auflisten und anzeigen
Releases und Automatisierung
- Releases – Releases und Assets
- Actions – Workflows und Actions-Runs
- Agent Watcher – Issues an Coding-Agent-CLIs übergeben (
watch/run); inkl. Unattended Server-Daemon (systemd, Credentials,--all-repos) - Agent Skill – Eingebetteten forge-Skill lokal oder global installieren (
forge agent skill)
Suche und Schnittstellen
- Suche und Status – Issues, Repositories und Arbeitsstatus durchsuchen
- API – direkte authentifizierte Forgejo-API-Anfragen
Schlüssel und Dokumentation
- SSH- und GPG-Schlüssel – Schlüssel auflisten, hinzufügen und löschen
- Wiki – Wiki-Seiten erstellen, lesen, suchen, ändern und löschen
- Forge CLI – ausführliche Einführung in Syntax und Wiki-Befehle
Verfügbare Hauptbereiche
agent api auth browse completion config gpg-key issue label org pr project
pull push release repo ruleset run search ssh-key status update wiki workflow
Jeder Bereich besitzt eigene Unterbefehle und Hilfe:
forge <bereich> --help
forge <bereich> <befehl> --help
Ausgabe für Skripte
Viele Befehle unterstützen strukturierte Ausgabe:
forge issue list --repo frank/forgecli --json
forge issue list --repo frank/forgecli --json number,title --jq '.[] | [.number, .title] | @tsv'
forge repo view frank/forgecli --template '{{.full_name}}\n'
--json: JSON mit allen oder ausgewählten Feldern--jq: JSON mit einem jq-Ausdruck filtern--template: JSON mit einem Go-Template formatieren
Pflege dieser Dokumentation
Bei neuen oder geänderten Befehlen, Flags oder Ausgabeformaten muss die passende Unterseite aktualisiert werden. Neue Funktionen erhalten eine thematisch passende Unterseite und werden hier verlinkt. Siehe auch AGENTS.md im Repository.