Forwarded URL Resolver

Resolve workspace-local URLs, such as http://localhost:3000, into the browser-reachable forwarded URL for the current VS Code window.

This is useful in Remote SSH, Dev Containers, Codespaces, and multi-window setups where the same remote port can map to different client URLs depending on the active VS Code window.

Features

• Resolves a raw URL such as http://localhost:3000 into a client-reachable URL for the current VS Code window.
• Provides the #forwardedUrl language model tool for Copilot agent mode.
• Adds the Forwarded URL Resolver: Resolve URL command, which copies the resolved URL to the clipboard and can open it in the browser.
• Runs as a workspace extension so it lives on the same side as the workspace in remote scenarios.

Usage

This extension has no extension-specific configuration. It acts purely as a resolver for URLs that you provide.

Use it with a full http or https URL such as:

• http://localhost:3000
• http://127.0.0.1:8000/health
• https://localhost:8443

Command Palette Usage

Run Forwarded URL Resolver: Resolve URL, enter the raw URL, and the resolved client URL is copied to your clipboard. You can also open it directly from the confirmation message.

Agent Usage

In Copilot agent mode, reference the tool with #forwardedUrl when you want the agent to resolve a known workspace-side URL for the current VS Code window.

Example prompts:

• Resolve http://localhost:3000 #forwardedUrl
• Resolve http://localhost:8000/health #forwardedUrl
• Take this raw localhost URL and resolve the forwarded URL for this window #forwardedUrl

The tool returns both:

• the remote target URL, such as http://localhost:3000/
• the client-reachable URL after VS Code applies remote forwarding

Requirements

• VS Code 1.120.0 or newer.
• Copilot agent mode for #forwardedUrl tool usage.
• A URL that VS Code can resolve through its forwarding support.

The command palette flow works without Copilot.

Limitations

• This extension does not inspect VS Code's forwarded-port list directly.
• It relies entirely on the raw URL you provide and VS Code's forwarding API.
• Only http and https URLs are supported.

Privacy

Forwarded URL Resolver does not scan your forwarded ports, collect telemetry, or send URLs to an external service. It passes the URL you provide to VS Code's built-in forwarding API and returns the resolved result.

How It Works

The extension calls vscode.env.asExternalUri(...) for the URL you provide. VS Code then applies the forwarding rules for the current window and returns the client-reachable URL.

Development

See DEVELOPMENT.md for local development, packaging, installation, and update guidance.