Setup guide / current CLI flow

Install RepoRelay and connect one local repository.

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:

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.

Windows path note

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

Three steps to a bounded review.

Keep the RepoRelay terminal open. Use the advanced links below for the detailed canonical flow.

01

Install RepoRelay

Install the public CLI globally, then confirm the command is available.

npm install -g reporelay-mcp@latest
reporelay --version
02

Start your repository

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.

03

Connect ChatGPT

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.

After first setup

Daily use is smaller.

Start RepoRelay for the repository, run the tunnel, and select the existing ChatGPT app. Switch repositories by restarting quickstart for the new path.

Useful recovery commands

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.

See troubleshooting answers

Canonical source

Setup details belong to the repository.

This page is a concise guide. For the full tunnel flow, configuration notes, Windows operations, and handoff protocol, use the source documentation on GitHub.