RepoRelay

Was RepoRelay macht

RepoRelay ist eine lokale MCP-Brücke der ersten Partei, die ChatGPT eingeschränkten Zugriff auf genau ein genehmigtes Repository auf Ihrem Computer gewährt – und nicht mehr.

ChatGPT überprüft Ihren Code durch RepoRelay und kann eine strukturierte Aufgabe für einen separaten lokalen Codierungsagenten (wie Codex oder Claude) über feste Übergabedateien hinterlassen. RepoRelay ist die Sicherheitsgrenze zwischen ChatGPT und Ihrer Maschine.

ChatGPT reviews/plans
        ↓
RepoRelay
        ↓
Repository reads/searches
+
fixed .ai-handoff writers
        ↓
Codex / another local coding agent implements

Related MCP server: codex-web-bridge

Wie das Sicherheitsmodell funktioniert

MCP (Model Context Protocol) ist der Standard, der es ChatGPT ermöglicht, Tools aufzurufen. ChatGPT ist der MCP-Client. RepoRelay ist der lokale MCP-Server und die Sicherheitsgrenze: Es entscheidet, worauf ChatGPT zugreifen darf, und legt genau ein genehmigtes Repository gleichzeitig offen. tunnel-client ist lediglich die sichere Netzwerkverbindung, die den ChatGPT-Datenverkehr zu Ihrem Computer transportiert.

Was ChatGPT durch RepoRelay tun kann (das normale 7-Tool-Setup):

✓ inspect files          open_workspace, list_files, read_file
✓ search the repository  search_files
✓ write to three predetermined handoff targets
                         write_next_task, write_review, update_handoff_state

Was ChatGPT nicht tun kann:

✗ run shell commands
✗ run PowerShell
✗ run Git
✗ launch processes
✗ arbitrarily edit source files
✗ delete files
✗ choose arbitrary write targets
✗ access outside the approved repository

Dies ist eines der stärksten Unterscheidungsmerkmale von RepoRelay: ChatGPT kann Ihren Code lesen und dagegen planen, erhält aber keine Ausführungsfähigkeit und kann nur in einige wenige feste Übergabedateien schreiben, die Sie kontrollieren.

Vor der Installation

Sie benötigen:

• Node.js >=22.19 und <27 (npm ist enthalten). Überprüfen Sie mit node --version.

• Ein vorhandenes lokales Projekt oder Repository, das ChatGPT überprüfen soll. Es muss ein echter Ordner auf Ihrem Computer sein – kein Laufwerksstamm und nicht Ihr gesamter Benutzerordner.

• OpenAI Secure MCP Tunnel-Zugriff. RepoRelay erreicht ChatGPT über den sicheren MCP-Tunnel von OpenAI. Siehe die aktuelle OpenAI Secure MCP Tunnel-Anleitung für Verfügbarkeit, Berechtigungen und Plandetails.

• Berechtigung zum Erstellen/Verwenden einer benutzerdefinierten MCP-App im Ziel-ChatGPT-Arbeitsbereich (ChatGPT-Entwicklermodus).

Sie müssen nichts anderes herunterladen. RepoRelay installiert den offiziellen OpenAI tunnel-client automatisch während reporelay tunnel setup.

Machen Sie sich noch keine Sorgen um das Übergabeprotokoll. Der Schnellstart richtet funktionierende Übergabedateien für Sie ein und erklärt sie beim Fortschritt.

Schnelleinrichtung

Windows-Pfade. Setzen Sie den vollständigen Pfad immer in Anführungszeichen und behalten Sie die Backslashes bei:

reporelay quickstart "C:\Users\you\Projects\my-app"

C:\Users\you\Projects\my-app ist korrekt. C:Users\you\Projects\my-app ist nicht – die Backslashes sind wichtig.

1. RepoRelay installieren

npm install -g reporelay-mcp@latest

Überprüfen Sie die Installation:

reporelay --version

Falls reporelay nicht erkannt wird, siehe Fehlerbehebung.

2. RepoRelay auf einem Repository starten

reporelay quickstart "C:\Projects\my-app"

Ersetzen Sie den Pfad durch das Repository, das Sie freigeben möchten. Lassen Sie dieses PowerShell-Fenster geöffnet.

Sie sollten Folgendes sehen:

Ready.
Local MCP: http://127.0.0.1:7676/mcp

Der normale Schnellstart aktiviert die 7-Tool-Übergabeoberfläche (4 Untersuchungstools + 3 feste Übergabe-Autoren). RepoRelay erstellt nun einen kleinen .ai-handoff-Arbeitsbereich und eine AGENTS.md-Notiz, damit ChatGPT strukturierte Aufgaben und Überprüfungen für einen separaten lokalen Codierungsagenten hinterlassen kann:

.ai-handoff/NEXT_TASK.md
.ai-handoff/REVIEW.md
.ai-handoff/RESULT.md
.ai-handoff/STATE.json
AGENTS.md

Warum erstellt RepoRelay diese? ChatGPT kann weiterhin keine Befehle ausführen, Git verwenden oder Ihr Repository willkürlich bearbeiten. Diese Dateien sind lediglich ein Ort, an dem ChatGPT eine Aufgabe hinterlassen kann, und ein separater lokaler Codierungsagent (der auf Ihrer eigenen Maschine mit Ihrer eigenen Erlaubnis läuft) kann sein Ergebnis hinterlassen. Mehr dazu unten in ChatGPT ↔ Codierungsagent-Übergabe.

Um RepoRelay später zu beenden, drücken Sie Strg+C in diesem Fenster. Es gibt kein reporelay quickstart --stop.

3. Überprüfen Sie es

Unmittelbar nach dem Schnellstart verifizieren Sie die tatsächliche Sicherheitsgrenze von RepoRelay:

reporelay audit "C:\Projects\my-app"

Sie sollten Folgendes sehen:

RESULT: PASS

Der Audit startet einen eigenen temporären Loopback-Listener und übt die echte authentifizierte MCP-Oberfläche, die Eindämmungsprüfungen und die Übergabeeinschränkungen aus. Er ändert Ihr Repository nicht. Dieses validiert RepoRelay, bevor ChatGPT verbunden wird.

4. RepoRelay-Tunnel-Setup ausführen

Führen Sie in einem zweiten PowerShell-Fenster Folgendes aus:

reporelay tunnel setup

Dies startet den RepoRelay-Setup-Assistenten. Er erledigt alles für Sie:

✓ installs a RepoRelay-supported OpenAI tunnel-client
✓ verifies it (pinned version + official SHA-256)
✓ opens OpenAI tunnel setup
✓ asks for your tunnel ID
✓ opens OpenAI runtime-key setup
✓ securely stores the pasted key
✓ creates the tunnel profile
✓ tests the complete connection

Sie geben genau zwei Dinge an, beide in der OpenAI-Plattform:

1. Ihre Secure MCP Tunnel-ID – der Assistent öffnet https://platform.openai.com/settings/organization/tunnels in Ihrem Browser. Erstellen oder wählen Sie einen Tunnel, verknüpfen Sie ihn mit Ihrem ChatGPT-Arbeitsbereich und fügen Sie seine tunnel_id wieder im Terminal ein.

2. Einen Runtime-API-Schlüssel – der Assistent öffnet https://platform.openai.com/settings/organization/api-keys. Erstellen Sie einen geheimen Schlüssel für das Projekt, das Sie mit dem Tunnel verwenden, und fügen Sie ihn im Terminal ein. Die Eingabe ist verborgen: Es erscheint nichts, während Sie einfügen. Dieser Schlüssel authentifiziert tunnel-client bei OpenAI; es ist nicht das RepoRelay-Bridge-Secret.

Das Erstellen oder Bearbeiten eines Tunnels erfordert die Tunnel lesen + verwalten-Berechtigung; das Ausführen von tunnel-client oder das Auswählen des Tunnels erfordert Tunnel lesen + verwenden. Dies sind Berechtigungen auf Organisationsebene, die von Ihrem Organisationsbesitzer oder RBAC-Administrator gewährt werden. Befolgen Sie die aktuelle OpenAI Secure MCP Tunnel-Anleitung für die genauen UI- und Berechtigungsdetails.

Wenn der Assistent fertig ist, sollten Sie Folgendes sehen:

Testing connection...
✓ OpenAI runtime credential
✓ RepoRelay reachable
✓ Bridge authentication

Setup complete.

Next:
  reporelay tunnel run

Diese Prüfungen sind echt: Das Setup validiert den Runtime-API-Schlüssel gegen die OpenAI-Steuerungsebene (dieselbe Nur-Lese-Tunnel-Suche, die tunnel-client beim Start durchführt) und verifiziert das Bridge-Secret gegen den tatsächlich laufenden RepoRelay. Ein falscher, abgelaufener oder falsch eingefügter Schlüssel wird hier mit einer klaren Nachricht abgefangen – nicht erst nachdem tunnel run gestartet ist.

Wenn Ihr RepoRelay auf einem benutzerdefinierten Port läuft (z. B. --port 7677), hat der Schnellstart den Live-Endpunkt bereits aufgezeichnet und das Setup folgt ihm automatisch – keine zusätzlichen Flags erforderlich.

Nützliche Optionen:

• reporelay tunnel setup --no-open – Browser nicht starten (headless, SSH oder CI); die URLs werden dennoch ausgegeben.

• reporelay tunnel setup --replace-tunnel – zur Eingabe einer neuen Tunnel-ID auffordern.

• reporelay tunnel setup --replace-runtime-key – zur Eingabe eines neuen Runtime-API-Schlüssels auffordern.

• reporelay tunnel setup --tunnel-client-path "C:\custom\tunnel-client.exe" – erweiterte Überschreibung für ungewöhnliche Umgebungen; RepoRelay überprüft oder verwaltet keine benutzerdefinierte Binärdatei.

Ein erneutes Ausführen von reporelay tunnel setup verwendet Ihren vorhandenen verifizierten Client, die Tunnel-ID und den gespeicherten Schlüssel erneut und testet die Verbindung, ohne erneut nach etwas zu fragen.

5. Den Tunnel ausführen

reporelay tunnel run

Lassen Sie dieses Fenster zusammen mit dem RepoRelay-Schnellstartfenster geöffnet. Stoppen Sie es mit Strg+C, wenn Sie fertig sind.

Wenn die Verbindung jemals nicht mehr funktioniert, bleibt reporelay tunnel doctor als eigenständiger Fehlerbehebungsbefehl verfügbar (erwarten Sie Ready., wenn alles in Ordnung ist; fügen Sie --verbose für eine redigierte Diagnose hinzu).

6. Die ChatGPT-App erstellen

In ChatGPT folgen Sie dem aktuellen OpenAI-Ablauf (siehe die ChatGPT-Entwicklermodus und MCP-Apps-Anleitung):

ChatGPT
→ Apps / developer features
→ create custom MCP app
→ connection: Tunnel
→ choose RepoRelay's tunnel
→ authentication: No authentication
→ Scan Tools
→ verify 7 tools
→ create/use the app
→ start a new chat

Befolgen Sie diese Reihenfolge:

1. Erstellen Sie die benutzerdefinierte MCP-App.

2. Wählen Sie die Tunnel-Verbindung.

3. Wählen Sie den RepoRelay/OpenAI Secure MCP Tunnel.

4. Wenn ChatGPT nach Authentifizierung fragt, wählen Sie Keine Authentifizierung.

5. Speichern oder erstellen Sie die App.

6. Führen Sie Tools scannen aus.

7. Überprüfen Sie, ob die erwarteten RepoRelay-Tools angezeigt werden.

8. Starten Sie einen neuen Chat und wählen Sie die RepoRelay-App aus.

Authentifizierung: Keine Authentifizierung. RepoRelay authentifiziert die lokale Brücke bereits über das geschützte X-RepoRelay-Bridge-Secret, das vom Tunnel verwendet wird. Konfigurieren Sie keine OAuth- oder andere ChatGPT-seitige Authentifizierungsmethode.

Fügen Sie niemals 127.0.0.1, localhost, das RepoRelay-Bridge-Secret oder einen OpenAI-Runtime-API-Schlüssel in ChatGPT ein. Die Tunnelverbindung erledigt die gesamte Netzwerkkommunikation.

7. Die 7 RepoRelay-Tools scannen und überprüfen

Führen Sie im ChatGPT-App-Ablauf Tools scannen aus und bestätigen Sie, dass RepoRelay genau diese sieben Tools freigibt:

open_workspace
list_files
read_file
search_files
write_next_task
write_review
update_handoff_state

Das ist die erwartete normale Oberfläche. Wenn Tools scannen Shell, Git, Prozessausführung, generische Dateibearbeitung, Löschen, Patchen oder eine andere unerwartete Fähigkeit anzeigt, stoppen Sie und untersuchen Sie den Sachverhalt, bevor Sie die App verwenden – führen Sie reporelay audit "C:\Projects\my-app" --json aus und bestätigen Sie die Tool-Liste.

8. Testen Sie es

Starten Sie einen neuen Chat, wählen Sie die RepoRelay-App aus und versuchen Sie:

Open the approved repository and list its top-level files.

Testen Sie dann die Grenze:

Try to read .env.

Die zweite Anfrage sollte blockiert werden.

Sie sind verbunden – was nun?

Sie haben jetzt ChatGPT, das Ihr Repository durch eine verifizierte Sicherheitsgrenze überprüft. Nützliche Aufforderungen:

Read README.md and explain how this project starts.

Search the repository for "authentication".

Review src/server.ts for error-handling issues and write your findings.

ChatGPT ↔ Codierungsagent-Übergabe

Das normale RepoRelay-Setup ermöglicht es ChatGPT, zu planen und zu überprüfen, während ein separater lokaler Codierungsagent (Codex, Claude oder ein anderer) die Implementierung durchführt. RepoRelay koordiniert sie über einen kleinen .ai-handoff-Arbeitsbereich:

.ai-handoff/
├── NEXT_TASK.md   ChatGPT writes the task here
├── RESULT.md      the local coding agent writes its result here
├── REVIEW.md      ChatGPT writes its review here
└── STATE.json     coordinates the cycle

Konzeptionell:

ChatGPT
  ↓ writes NEXT_TASK.md

Codex / local coding agent
  ↓ implements
  ↓ writes RESULT.md

ChatGPT
  ↓ reviews result
  ↓ writes REVIEW.md

STATE.json koordiniert den Zyklus. RepoRelay selbst führt Codex oder Claude nicht aus – dies sind separate lokale Anwendungen, die Sie selbst starten. Die Übergabedateien sind lediglich ein strukturierter Ort, um Arbeit hin und her zu reichen.

ChatGPT kann nur NEXT_TASK.md, REVIEW.md und STATE.json schreiben. Das implementierungseigene RESULT.md ist für ChatGPT niemals beschreibbar.

Siehe docs/handoff-cycle.md für das detaillierte Protokoll und examples/ für Reviewer- und Implementer-Prompts.

Tägliche Verwendung

Nach der einmaligen Einrichtung müssen Sie den Tunnel oder die ChatGPT-App nicht neu erstellen. Jeden Tag:

1. RepoRelay starten:

   reporelay quickstart "C:\Projects\my-app"

2. Tunnel starten (in einem zweiten Fenster):

   reporelay tunnel run

3. Öffnen Sie ChatGPT, starten Sie einen neuen Chat und wählen Sie die vorhandene RepoRelay-App aus.

Lassen Sie beide Fenster geöffnet, während Sie die App verwenden. Wenn die Verbindung nicht mehr funktioniert, führen Sie erneut reporelay tunnel doctor aus.

Repository wechseln

RepoRelay stellt jeweils ein Repository zur Verfügung.

1. Drücken Sie Strg+C im RepoRelay-Terminal.

2. RepoRelay für das neue Repository starten:

   reporelay quickstart "C:\Projects\another-repo"

3. Lassen Sie tunnel-client laufen. Es verbindet sich automatisch wieder mit dem neu gestarteten RepoRelay (gleicher Port und geschützte bridge-secret-Datei). Wenn Sie einen anderen Port verwendet haben, folgt der verwaltete Tunnel automatisch.

4. Starten Sie eine neue ChatGPT-Konversation und wählen Sie die RepoRelay-App aus.

5. Bitten Sie ChatGPT, das neue Repository zu öffnen.

Scannen Sie die Tools nicht erneut, nur weil sich das genehmigte Repository geändert hat. Scannen Sie nur neu, wenn sich die Tool-Definitionen geändert haben oder ChatGPT Sie dazu auffordert.

Fehlerbehebung

Für alles andere führen Sie reporelay doctor aus. Es gibt den Konfigurations- und Sicherheitsstatus aus, ohne geheime Werte preiszugeben.

Optionaler Nur-Lese-Modus

Die normale RepoRelay-Erfahrung ist die oben genannte 7-Tool-Übergabeoberfläche und sie ist die empfohlene Einrichtung für Anfänger. Wenn Sie ChatGPT speziell nur zum Inspizieren verwenden möchten – keine Übergabedateien, keine Schreibvorgänge – beginnen Sie mit:

reporelay quickstart "C:\Projects\my-app" --no-handoff-writes

In diesem optionalen Modus stellt RepoRelay genau vier Tools bereit:

open_workspace
list_files
read_file
search_files

Der Nur-Lese-Modus erstellt keine .ai-handoff-Datei, erstellt oder ändert kein AGENTS.md und lässt das genehmigte Repository unverändert. Alle Eindämmungs-, Authentifizierungs- und Sicherheitsprüfungen gelten weiterhin. Verwenden Sie das entsprechende Audit-Flag:

reporelay audit "C:\Projects\my-app" --no-handoff-writes

Wenn Sie diesen Modus verwenden, erwarten Sie 4 Tools in den Scan-Tools anstelle von 7.

Sicherheit

Die von RepoRelay erzwungene Grenze umfasst:

• Loopback-only-Bindung und Authentifizierung erforderlich;

• genau eine vorhandene kanonische genehmigte Wurzel;

• sensible Pfade blockiert, einschließlich .env, VCS-Metadaten, Anmeldeinformationsspeicher und Private-Key-Formate;

• Traversierung, absolute Pfade außerhalb der Wurzel, Symlink/Junction/Reparse-Escapes und Hardlink-Umgehungen blockiert;

• begrenzte Lesevorgänge, Suchvorgänge, Ergebnisse und Übergabeinhalte;

• kein Shell-, PowerShell-, Git-, Prozess-, generisches Schreib-, Patch-, Lösch-, Artefakt-, Worktree-, Skill-, Subagent- oder Local-Agent-Tool;

• Übergabeschreibvorgänge auf die drei festen, bereits vorhandenen Ziele beschränkt.

RepoRelay ist eine Anwendungsgrenze mit minimalen Berechtigungen, keine Betriebssystem-Sandbox gegen bösartige Software, die bereits als derselbe lokale Benutzer ausgeführt wird. Ein externer Secure MCP Tunnel ist eine separate Sicherheitsgrenze und muss unabhängig gesichert werden. Wählen Sie das genehmigte Repository sorgfältig aus.

Siehe SECURITY.md für das vollständige Sicherheitsmodell und die reporelay audit-Dokumentation.

Erweiterte Konfiguration

Die meisten Benutzer benötigen diese nie. Wenn doch:

• Configuration — REPORELAY_*-Umgebungsvariablen, Bridge-Authentifizierung, Ports, Protokollierung und Übergabemodus.

• ChatGPT Web setup details — die vollständige Tunnel- und App-Referenz.

• Windows operations — Lebenszyklus-Skripte, geplante Aufgaben und verwaltete Windows-Einrichtung.

• .env.example — nur Platzhalterkonfiguration. Legen Sie niemals ein echtes Bridge-Geheimnis oder Tunnel-Anmeldeinformationen hinein.

• Lokale MCP-Clients — Wenn Ihr MCP-Client auf demselben Computer wie RepoRelay läuft, benötigen Sie den Tunnel nicht: Richten Sie ihn auf die lokale MCP-URL, die vom Quickstart ausgegeben wird, und senden Sie den X-RepoRelay-Bridge-Secret-Header, der aus der geschützten Datei geladen wird.

Für Konfigurations- und Sicherheitsstatus ohne Ausgabe geheimer Werte:

reporelay doctor

Anforderungen und Plattformunterstützung

• Node.js >=22.19 <27 (npm ist enthalten);

• Git für die klonbasierte Installation — optional, wenn Sie stattdessen das ZIP herunterladen.

Der Quickstart in dieser README funktioniert unter Windows, macOS und Linux. Windows 10/11 ist die vollständig validierte Lebenszyklus- und Betriebsplattform, einschließlich der PowerShell-Skripte und des tunnelverwalteten Runbooks.

Einschränkungen

• Es wird jeweils ein genehmigtes Repository bereitgestellt.

• RepoRelay ist keine Betriebssystem-Sandbox.

• ChatGPT Web benötigt externe OpenAI Secure MCP Tunnel-Infrastruktur, um eine private lokale Bridge zu erreichen.

• Windows ist die vollständig validierte Lebenszyklusplattform; andere Plattformen haben keine identischen PowerShell-/Tunnel-Operationen.

• Codex, Claude und andere Codierungsagenten sind separate lokale Anwendungen, keine Komponenten von RepoRelay.

Dokumentation

• ChatGPT Web Einrichtung

• Sicherheitsmodell

• Konfiguration

• Windows-Operationen

• Einrichtungshinweise

• Übergabezyklus

• Übergabebeispiele

• Mitwirken

Lizenz und Projektabstammung

RepoRelay wird unter der MIT-Lizenz veröffentlicht. Das Projekt behält die erforderliche Quellenangabe bei und bündelt nicht die SDKs oder Laufzeiten von Codex, Claude oder anderen Implementierern.

Entwicklung

npm ci
npm run typecheck
npm test
npm run verify:release
npm audit --audit-level=low
npm pack --dry-run --json
git diff --check