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.

✳️ Features

FEATURE	DESCRIPTION
Dedicated View	Dedicated Portyard Activity Bar panel for instant access to open ports
Active Port Scan	Automatically scans active listening ports with their process names & PIDs (`#<pid>`)
Smart Polling	Visibility-aware background scanning that automatically pauses when panel is hidden
Tech Brand Recognition	Detects 15+ stacks (React, Vue, Vite, Node, Bun, Django, FastAPI, Postgres, Redis, etc.) with theme colors & Codicons
Persistent SSH Tunnels	Generates instant, public forwarding URLs (`localhost.run`) with keepalives that survive hot-reloads
System Port Filter	Toggle system and ephemeral ports on/off using the eye filter icon
Process Control	One-click process termination with safety confirmation to free up socket ports
One-Click Actions	Copy public URLs, open endpoints in browser, or unshare tunnels with single-click inline buttons

✳️ Architecture

#	COMPONENT	DESCRIPTION	STACK
1️⃣	Extension Host	Lifecycle management, visibility-aware polling loop, command handling	*TypeScript*
2️⃣	Ports Provider	Sidebar TreeDataProvider, process item rendering, Markdown tooltips	*TypeScript*
3️⃣	Port Discovery	Cross-platform socket scanner (`netstat`, `lsof`), process cache mapping, process killer	*TypeScript*
4️⃣	Tunnel Manager	Resilient OpenSSH reverse forwarding runner with chunk buffering & keepalives	*TypeScript*
5️⃣	Brand Classifier	Tech stack categorization mapping to VS Code Codicons & chart theme colors	*TypeScript*

Made with 🔌 by Saptarshi Roy