Summary : Monitor and map active development ports in real-time inside Visual Studio Code.
Overview
PortSync is a VS Code extension that helps developers keep track of active ports while working on local web servers, APIs, containers, and other development services. It provides a dedicated sidebar view showing open ports and lets you quickly identify which services are running.
Features
Sidebar view for active ports, updated in real time
Easy access to running service ports without leaving VS Code
Command palette integration for quick activation
Designed for local development workflows and debugging sessions
Compatible with Windows, Mac and Linux
How to Use
Open VS Code inside your project workspace.
Install PortSync from the VS Code Extension Marketplace or load it locally in development mode.
Open the Port Sync - Monitor your Ports view from the activity bar.
Use the command palette and run Port Sync - Monitor Real Time Working Ports.
Installation
From VS Code
Open the Extensions view (Ctrl+Shift+X).
Search for PortSync.
Install and reload VS Code by pressing :
Ctrl+Shift+P - Reload Window
Local development
Clone the repository.
Run npm install.
Change the tsconfig.json and package.json as required
Build the extension:
npm run compile
Press F5 to start a new Extension Development Host instance.
Extension Commands
portsync.getActivePorts — Monitor Real Time Working Ports
Development
Build
npm run compile
Watch
npm run watch
Test
npm test
Repository Structure
src/extension.ts - main extension activation and command registration
src/views/sideBar.ts - sidebar view logic
src/test/extension.test.ts - extension tests
src/assets - All Logos and Sidebar icon images
package.json - extension metadata and commands
tsconfig.json - TypeScript configuration
Contributing
Contributions are welcome ! If you find a bug or want to suggest a feature:
Open an issue.
Submit a pull request.
Please follow the repository's coding style ,folder naming conventions and make sure tests pass before submitting changes.
License
PortSync is licensed under the MIT License. See the LICENSE file for details.
CHANGELOG
Project versions and changes included in each version can be viewed in the CHANGELOG.md file.
