Portyard

A VS Code Extension that discovers active local ports and manages running processes directly from a dedicated Activity Bar panel. Running natively on your machine, it discovers open ports and displays their Port Number, PID, Protocol, Process Name, and Technology Brand - all without leaving your editor.

🔗 VS Code Marketplace | 🔗 Open VSX Registry | 🆔 saptarshiroy39.portyard

🎯 Features

FEATURE	DESCRIPTION
Dedicated View	Click the Portyard icon in the Activity Bar to open the active ports panel
Active Port Scan	Automatically scans active listening ports with their process names & PIDs
System Filter	Toggle system and ephemeral ports on/off using the eye filter icon
Process Control	Stop process running on a port with confirmation to free up socket port
SSH Forwarding	Instantly generate safe, public forwarding tunnels via localhost.run

🏗️ Architecture

#	COMPONENT	DESCRIPTION	STACK
1️⃣	Extension Host	Command registrations, SSH tunnel manager, state, context setup	*TypeScript*
2️⃣	Ports Provider	Sidebar tree view data rendering, brand matching, tooltips	*TypeScript*
3️⃣	Port Discovery	Platform-specific shell tools (`netstat`, `lsof`) runner	*TypeScript*

📁 Project Structure

Portyard/
├── .vscode/
│   ├── launch.json         # Extension debug configuration
│   └── tasks.json          # Development compilation tasks
├── .vscodeignore           # Files excluded from published package
├── images/
│   ├── logo.png            # Extension logo/branding
│   └── icon.svg            # Activity Bar icon (sidebar)
├── src/
│   ├── brandUtils.ts       # Visual theme color utilities for technology brands
│   ├── extension.ts        # Main extension entry point & command registration
│   ├── portDiscovery.ts    # Cross-platform port scanning & process mapper
│   └── portTreeProvider.ts # Sidebar ports list Tree View provider
├── eslint.config.js        # ESLint environment configuration
├── LICENSE                 # MIT License details
├── package.json            # Extension manifest
├── tsconfig.json           # TypeScript configuration
└── README.md

Made with 🔌 by Saptarshi Roy