Port Flow
High-performance DevOps dashboard for VS Code — monitor ports, processes, Docker containers, and system resources in real-time.
Features
- Real-Time Port Monitoring — See all active TCP ports with PID, process name, protocol, CPU %, and memory consumption
- Process Control — Kill processes directly from the dashboard with a single click
- Docker Integration — Detect Docker containers, view metadata, restart/stop/view logs
- Live Resource Graphs — CPU and memory line charts with 5-minute rolling window
- Smart Search & Filter — Filter by port number, process name, Docker-only, or workspace-only
- Workspace Awareness — Identify which processes belong to your current VS Code workspace
- Port History — Track port activity history across sessions with kill logs
- Keyboard-Driven — Full keyboard shortcut support for all actions
Requirements
- VS Code 1.85+
- Node.js 18+ (for development)
- Docker (optional, for container features)
Keyboard Shortcuts
| Shortcut |
Action |
Ctrl+Alt+R / Cmd+Option+R |
Refresh ports |
Ctrl+Shift+K / Cmd+Shift+K |
Kill selected process |
Ctrl+Alt+A / Cmd+Option+A |
Toggle auto-refresh |
Ctrl+F / Cmd+F |
Search ports |
Ctrl+Alt+O / Cmd+Option+O |
Open port in browser |
| Platform |
Architecture |
Status |
| macOS |
x64 |
✅ |
| macOS |
arm64 (Apple Silicon) |
✅ |
| Linux |
x64 |
✅ |
| Windows |
x64 |
✅ |
Development
# Install dependencies
npm install
# Build native addon
npx prebuildify --napi --strip
# Build extension
npm run build
# Launch Extension Development Host
# Press F5 in VS Code
Configuration
Port Flow works out of the box with zero configuration. Auto-refresh runs at 3-second intervals by default.
Troubleshooting
| Issue |
Solution |
| Native scanner unavailable |
Rebuild the native addon: npx prebuildify --napi --strip |
| Docker features not showing |
Ensure Docker Engine is running and the Docker socket is accessible |
| High CPU usage |
Toggle auto-refresh off (Ctrl+Alt+A) when not needed |
| Ports not appearing |
Some ports require elevated permissions to scan — try running VS Code as admin |
Architecture
- Extension Host: TypeScript — manages lifecycle, commands, and state
- Webview UI: React 18 + TailwindCSS — renders the dashboard in the sidebar
- Native Addon: C++17 via N-API — platform-specific port scanning and process metrics
- Charts: Recharts — SVG-based CPU and memory line charts
License
Copyright © 2026 Karthik Dasari. All Rights Reserved.
This extension is proprietary software. All rights reserved.
| |
