PortShield (posh)

🚀 Why PortShield?

• 🎯 Zero Friction: Free any port in seconds with posh free <port>.
• 🧠 Intelligent Context: Automatically categorizes ports (Dev, Reserved, System) so you know exactly what you're killing.
• 🔖 Smart Labels: Tag ports with project names to keep your workspace organized.
• 🛡️ Safety First: Built-in security lock prevents accidental termination of critical Windows services.
• 💻 Terminal-Native: Designed for developers who live in the command line.

📦 Installation

Quick Install

Run instantly without installation:

npx portshield

Global Installation

Install globally via NPM:

npm install -g portshield

📋 Key Features

Interactive Dashboard

The primary way to use PortShield. Just type posh and use a premium interactive menu to scan, list, and free ports using arrow keys.

Port Reservations

Persistent labeling system. Reserve a port for a specific project, and PortShield will remember it every time you scan.

System Safety

PortShield knows which processes are critical for Windows (like Explorer or Lsass). It will explicitly block any attempt to kill them, keeping your system stable.

📚 Documentation

• Quickstart Guide - Get up and running in 2 minutes.
• Commands Reference - Detailed view of all features.
• Troubleshooting - Common issues and solutions.

🤝 Contributing

We welcome contributions! PortShield is fully open source (Apache 2.0).

• Report bugs and suggest features.
• Submit code improvements via Pull Requests.

See our Contributing Guide for more details.

📄 Legal

• License: Apache License 2.0
• Terms of Service: Terms & Privacy
• Security: Security Policy