chasenchen211/git-to-github-mirror

Was macht git-to-github-mirror?

Ein Codex-Skill für Einweg-GitHub-Mirrors: Halten Sie Projektkontext für ChatGPT-Analysen und Codex-Ausführungen verfügbar.

Übersicht

Dieser Skill ermöglicht es Ihnen, einen unidirektionalen Spiegel (Mirror) eines lokalen Git-Repositorys auf GitHub zu erstellen. Der Spiegel wird nur in eine Richtung synchronisiert: vom Original-Repository zum GitHub-Ziel. Dadurch bleibt der Kontext Ihres Projekts für ChatGPT-Analysen und Codex-Ausführungen zugänglich, ohne dass Sie manuell pushen müssen.

Funktionsweise

1. Konfiguration: Der Skill verwendet die Umgebungsvariable GITHUB_TOKEN für die Authentifizierung bei GitHub. Sie müssen ein Token mit den entsprechenden Berechtigungen (z.B. repo) bereitstellen.
2. Synchronisation: Der Skill führt eine vollständige Synchronisation aller Branches, Tags und Commits durch. Er löscht keine entfernten Branches, die im Original nicht mehr existieren (der Spiegel ist unidirektional).
3. Automatisierung: Der Skill kann entweder manuell ausgeführt oder in CI/CD-Pipelines integriert werden, um regelmäßige Spiegelungen zu gewährleisten.

Voraussetzungen

• Ein Git-Repository, das gespiegelt werden soll.
• Ein GitHub-Konto und ein Ziel-Repository (kann leer sein oder initialisiert).
• Ein persönliches Zugriffstoken (PAT) mit repo-Berechtigungen, gesetzt als GITHUB_TOKEN.

Verwendung

1. Stellen Sie sicher, dass GITHUB_TOKEN in Ihrer Umgebung gesetzt ist.
2. Führen Sie den Skill mit Codex aus: codex run chasenchen211/git-to-github-mirror
3. Der Skill wird automatisch alle Änderungen von Ihrem lokalen Repository auf das konfigurierte GitHub-Ziel pushen.

Konfiguration

Der Skill kann über folgende Parameter konfiguriert werden:

• source-repo: Pfad zum Quell-Repository (Standard: aktuelles Verzeichnis).
• target-repo: GitHub-Repository im Format owner/repo (erforderlich).
• branch: Optional, nur einen bestimmten Branch spiegeln.

Beispiel

# Setzen Sie das GitHub-Token
export GITHUB_TOKEN=ghp_abc123...

# Führen Sie den Skill aus
codex run chasenchen211/git-to-github-mirror --target-repo="mein-benutzername/mein-projekt"

Hinweise

• Der Spiegel ist unidirektional. Änderungen im GitHub-Repository werden nicht zurück in das Original-Repository übernommen.
• Stellen Sie sicher, dass das Ziel-Repository existiert, bevor Sie den Skill ausführen.
• Der Skill erfordert Netzwerkzugriff auf GitHub.

Lizenz

MIT