Prerequisites
Use Node.js >=22.19 and <27. npm is included. Have an existing local project directory, OpenAI Secure MCP Tunnel access, and permission to create or use a custom MCP app in the target ChatGPT workspace.
Setup guide / current CLI flow
Install the CLI, start one approved root, and connect ChatGPT through the documented tunnel flow. The full canonical steps remain in the repository docs.
Last updated:
Use Node.js >=22.19 and <27. npm is included. Have an existing local project directory, OpenAI Secure MCP Tunnel access, and permission to create or use a custom MCP app in the target ChatGPT workspace.
Quote the complete path and keep its backslashes: reporelay quickstart "C:\Projects\my-app". A drive root or the whole user folder is too broad for the approved repository.
The short path
Keep the RepoRelay terminal open. Use the advanced links below for the detailed canonical flow.
Install the public CLI globally, then confirm the command is available.
npm install -g reporelay-mcp@latest reporelay --version
Use one existing project directory. The normal quickstart starts the authenticated loopback bridge and enables the fixed handoff writers.
reporelay quickstart "C:\Projects\my-app"
Use --no-handoff-writes for the four-tool inspection-only surface.
Run the audit, complete tunnel setup, then keep the tunnel running while the ChatGPT MCP app scans the seven-tool surface.
reporelay audit "C:\Projects\my-app" reporelay tunnel setup reporelay tunnel doctor reporelay tunnel run
Test a sensitive path such as .env; it should be blocked.
Advanced
These links preserve the canonical depth without making the first install feel like a ten-step checklist.
After first setup
Start RepoRelay for the repository, run the tunnel, and select the existing ChatGPT app. Switch repositories by restarting quickstart for the new path.
reporelay tunnel doctor checks the connection again. reporelay doctor prints sanitized configuration and security status. A custom quickstart port is carried into tunnel setup automatically, or can be supplied explicitly with --port.
Canonical source
This page is a concise guide. For the full tunnel flow, configuration notes, Windows operations, and handoff protocol, use the source documentation on GitHub.