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
Smart Polling	Visibility-aware background scanning automatically pauses when panel is hidden
Tech Brand Icons	Category-based Codicons (database, server, globe, package) for tech stack
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
One-Click Actions	Copy URLs, open in browser, or unshare tunnels with single-click inline buttons

---

🏗️ 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