Mekong Tunnel — VS Code Extension
Expose your local dev server to the internet with one click, directly from VS Code. Powered by the Mekong Tunnel CLI.
Requirements
The mekong binary must be installed separately on your machine. The extension will auto-detect it from your PATH or common install locations.
Download the latest binary from the v1.4.9 release page.
Install mekong binary
macOS (Apple Silicon / arm64)
curl -L https://github.com/MuyleangIng/MekongTunnel/releases/latest/download/mekong-darwin-arm64 \
-o /usr/local/bin/mekong && chmod +x /usr/local/bin/mekong
macOS (Intel / amd64)
curl -L https://github.com/MuyleangIng/MekongTunnel/releases/latest/download/mekong-darwin-amd64 \
-o /usr/local/bin/mekong && chmod +x /usr/local/bin/mekong
Linux (amd64)
curl -L https://github.com/MuyleangIng/MekongTunnel/releases/latest/download/mekong-linux-amd64 \
-o /usr/local/bin/mekong && chmod +x /usr/local/bin/mekong
Status Bar
The extension adds a persistent item to the VS Code status bar (bottom-left):
| State |
Display |
Action on Click |
| Idle |
$(radio-tower) mekong |
Start tunnel |
| Starting |
$(sync~spin) mekong: starting... |
(disabled) |
| Running |
$(radio-tower) https://abc.mekongtunnel.dev |
Copy URL |
| Error |
$(error) mekong: error |
Restart tunnel |
When a tunnel URL is detected, a notification pops up with Copy URL and Open in Browser actions.
Commands
Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for:
| Command |
Description |
Mekong: Start Tunnel |
Start a tunnel on the detected or configured port |
Mekong: Stop Tunnel |
Stop the currently running tunnel |
Mekong: Copy Public URL |
Copy the active tunnel URL to clipboard |
Mekong: Open Public URL in Browser |
Open the active tunnel URL in your browser |
Settings
| Setting |
Default |
Description |
mekong.port |
null |
Local port to tunnel (auto-detected from package.json if not set) |
mekong.autoStart |
false |
Automatically start tunnel when workspace opens |
mekong.expire |
"" |
Tunnel expiry duration (e.g. 2h, 1d, 1w) |
mekong.binaryPath |
"" |
Custom path to the mekong binary (leave empty for auto-detect) |
mekong.showQr |
false |
Show QR code in the output panel |
Auto port detection
If mekong.port is not set, the extension reads your workspace package.json and maps known frameworks to their default ports:
| Framework |
Port |
| Next.js, Nuxt, React, Remix, Express, Fastify, Hono |
3000 |
| Vite, SvelteKit, Svelte |
5173 |
| Angular |
4200 |
| Astro |
4321 |
| Gatsby |
8000 |
If no framework is detected, you will be prompted to enter a port manually.
Output Panel
All tunnel output is streamed to the Mekong Tunnel output channel. Open it via View > Output and select Mekong Tunnel from the dropdown.
