HomeDocs

REPOSITORY-GROUNDED GUIDES

Use RepoTunnel with confidence

Set up RepoTunnel, understand its permission boundaries and find the next step when something goes wrong.

Install and open RepoTunnel

Choose the platform package, launch the application and approve a workspace.

Start setup 02 / CONNECT

Make your first MCP connection

Configure an authenticated endpoint and verify it from your AI client.

Connect ChatGPT 03 / EXPLORE

Find your way around the app

Understand every sidebar screen, local chat, recovery tools and the optional companion.

Take the app tour

Getting Started

What is RepoTunnelUnderstand the local-first gateway model and what RepoTunnel is designed to control.A guide to the RepoTunnel appWalk through every RepoTunnel sidebar screen, learn where each workflow lives and find practical guides for projects, teams, recovery and the extension.Installation overviewChoose the correct RepoTunnel package for Linux, Windows or macOS and verify the downloaded release.Add your first projectApprove a local project without exposing unrelated folders.Home and local model chatLearn the Home screen: choose a local model, include project context, opt into safe edits and check gateway and remote connection status.Connect ChatGPTConnect ChatGPT to RepoTunnel's authenticated MCP endpoint and verify the connection with a real tool call.

Installation

Install on LinuxUse the official Debian, RPM or AppImage release package for x86_64 Linux.Install on WindowsInstall RepoTunnel x64 with the official NSIS .exe or MSI package.Install on macOSChoose the Apple Silicon or Intel DMG and understand the current updater safety gate.

Connections

Connection optionsChoose between ngrok, Cloudflare Tunnel, Direct HTTPS or the optional OpenAI Secure MCP Tunnel.Connect with ngrokCreate an ngrok account, find your authtoken, connect RepoTunnel’s built-in provider, and verify HTTPS, OAuth and a real workspace call.Connect with Cloudflare TunnelInstall cloudflared, create a named Cloudflare Tunnel, route a hostname to RepoTunnel’s local origin, and verify the managed connection.Direct HTTPS setup for ChatGPTSet up RepoTunnel Direct HTTPS for ChatGPT local projects on Linux, with routing, hostname and TLS checks, screenshots, provider links and troubleshooting.Optional Secure MCP TunnelUnderstand RepoTunnel’s optional OpenAI Secure MCP Tunnel transport, local setup requirements, key handling and readiness checks.

Projects

Workspace access and AI modesUnderstand the difference between filesystem access and mutation approval policy.Large repositoriesUse RepoTunnel's paged and resumable read tools for very large projects.Project Memory and live continuitySave a project’s goals, decisions and preferences while using live continuity to recover current work without replaying an entire chat.

Files & Editing

Safe editing and historyUse stale-change protection, version history and conservative undo behavior.History and saved versionsUse History to review pending AI edits, inspect activity, search saved versions and restore an earlier accessible project state safely.Create and restore checkpointsSave a project checkpoint before a large change, compare it with current files, and understand restoration and retention boundaries.

Commands

Verification commands vs live terminalChoose the correct execution surface for testing or real project processes.Checks and project readinessUnderstand the Checks screen, Ready/Limited/Blocked results, and the next step for a project before AI edits, verification or Git work.

Git & GitHub

Git workflowInspect, stage and commit through RepoTunnel's fixed Git capability surface.

Browser

Managed browserRun browser verification inside RepoTunnel's managed Chromium-family runtime.Semantic browser actionsUse short-lived accessibility references and mutation receipts instead of stale element assumptions.

Desktop & AI Workspace

AI WorkspaceRun supported GUI apps in RepoTunnel's isolated virtual desktop.

Phone

Phone AccessConnect a selected Android device with explicit capability controls.Phone privacy and sensitive appsUnderstand the non-bypass behavior around payment-sensitive Android applications.

Team Mode

Team Mode workflowCoordinate two AI engineers with enforced ownership and review boundaries.

Continuity

Continuity / Resume v2Resume from current Git, activity and process state instead of stale saved notes.ChatGPT continuation extensionInstall the optional Chromium continuation extension, save exact ChatGPT chats, understand its status and privacy, and troubleshoot safe delivery.

Video

Video IntelligenceAnalyze supported media with bounded background jobs.Video ProductionMaintain durable Video Projects with script, scenes, narration, subtitles, rendering and QA.

Security

Security modelUnderstand RepoTunnel's layered local security boundaries.Secrets and protected pathsUnderstand the files and outputs RepoTunnel intentionally protects.

Reference

Platform statusKnow which RepoTunnel behaviors are packaged versus natively validated.MCP capability referenceUnderstand the shape of RepoTunnel's capability-oriented MCP surface without relying on a hard-coded tool count.Settings, updates and HelpFind runtime diagnostics, signed update controls, startup and history-retention settings, plus built-in guidance and keyboard shortcuts.

Troubleshooting

Connection troubleshootingDiagnose a RepoTunnel connection without weakening the local security boundary.Terminal troubleshootingUnderstand why RepoTunnel may intentionally refuse AI command execution.