VS Code Remote Launcher

Batch open VS Code Remote - SSH workspaces on Windows and macOS, with Windows-first window arrangement.

English | Chinese | Download | Star History

---

Overview

VS Code Remote Launcher is a desktop app for people who repeatedly work with many SSH targets, many remote folders, and many VS Code Remote windows.

It is designed for a practical workflow:

• import MobaXterm sessions
• import SSH config hosts
• manage remote project paths
• keep favorites and defaults close at hand
• queue multiple projects for launch
• arrange opened VS Code windows into a grid

Highlights

• MobaXterm .mxtsessions import
• SSH config import
• nested connection groups
• remote directory browsing
• favorite and default projects
• launch queue with ordering controls
• launch feedback log
• Windows VS Code window arrangement

Preview

Main window

Arranged VS Code windows

Download

• Release: v0.2.0 - Windows and macOS Release

Requirements

• Windows or macOS
• Node.js 18 or newer
• VS Code installed
• Remote - SSH extension installed in VS Code
• SSH access already working from the current machine

Typical workflow

1. Start the launcher.
2. Import connections from MobaXterm or SSH config.
3. Select a connection from the left group tree.
4. Add remote project paths manually or by browsing remote directories.
5. Mark common projects as favorites or defaults.
6. Set a layout such as 3 x 1 or 2 x 2.
7. Queue projects in Launch queue.
8. Launch them and let the app arrange the opened VS Code windows.

Run from source

cd electron-app
npm install
npm run dev

This will:

• start the Vite renderer dev server
• compile the Electron main process
• launch the Electron desktop app in development mode

Build

cd electron-app
npm run build

Package a macOS build

cd electron-app
npm install
npm run dist:mac

Generated files:

• electron-app/release/*.dmg
• electron-app/release/*.zip

Package a portable Windows executable

cd electron-app
npm run dist:portable

Generated file:

• electron-app/release/VS Code Remote Launcher-0.2.0-x64.exe
• electron-app/release/VS Code Remote Launcher-0.2.0-x64.exe

Build a Windows installer

cd electron-app
npm run dist:win

Multi-platform release

• Build macOS locally on a Mac with npm run dist:mac
• Build Windows locally on Windows with npm run dist:win or npm run dist:portable
• Push a tag such as v0.2.0 to trigger GitHub Actions release packaging
• The macOS runner uploads .dmg and .zip assets
• The Windows runner uploads installer and portable .exe assets

Project structure

VSCodeRemoteLauncher/
- electron-app/                  # Main Electron application
- docs/                          # README preview images
- LICENSE
- README.md
- README.zh-CN.md
- README.en.md

Documentation

• Chinese: README.zh-CN.md
• English: README.en.md
• Electron app notes: electron-app/README.md

Notes

• local user data is intentionally ignored in Git
• remote project launching works on Windows and macOS
• VS Code window arrangement is still Windows-only
• Windows installers should be built on Windows runners for reliable releases

Contributors

Thanks to everyone who improves the project.

Star History

License

MIT