LarsenCundric

LarsenCundric / port-whisperer

Public

A beautiful CLI tool to see what's running on your ports

153
8
100% credibility
Found Apr 03, 2026 at 153 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
JavaScript
AI Summary

Port Whisperer is a user-friendly tool that scans and displays processes using network ports on your computer, identifies development frameworks and containers, and helps manage or clean them up.

How It Works

1
😩 Port Blocked

You're excited to test your app but discover port 3000 is already taken by some mystery process.

2
🔍 Find the Tool

A friend mentions Port Whisperer, a simple helper that shows exactly what's using your computer's ports.

3
📥 Add It Easily

You quickly bring the tool onto your computer so it's ready to use anytime.

4
📊 View the Magic Table

With one command, a beautiful colored table appears listing all active ports, what apps own them, how long they've run, and if they're healthy.

5
Pick Your Action
🔎
Check One Port

Dive deeper into a specific port to see its location, family tree, and option to stop it.

🧹
Clean Up

Spot stuck or lonely processes and safely end them after a quick yes/no.

👀
Watch Live

Keep an eye on ports in real-time as things start or stop.

📋
List All Tasks

See running development tasks with their resource use and smart labels.

🎉 Smooth Sailing

Your ports are clear, processes managed, and you dive back into creating without interruptions.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 153 to 153 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is port-whisperer?

port-whisperer is a JavaScript CLI tool that scans your machine to reveal what's running on open ports, delivering color-coded tables of dev servers, Docker containers, and databases while hiding system noise like Spotify or Raycast. Run `ports` for a quick overview with framework detection (Next.js, PostgreSQL, Redis), uptime, and status icons; drill into `ports 3000` for process trees, git branches, and kill prompts. It solves endless "what's hogging port 3000?" hunts with commands like `ports ps` for dev processes, `ports clean` for orphans, and `ports watch` for real-time changes—all via npx, no install needed.

Why is it gaining traction?

Its beautiful tables and framework smarts make lsof feel prehistoric, instantly spotting Vite previews or LocalStack ports without manual parsing. Devs hook on the polished output, Docker collapsing, and interactive cleanup that targets only node/python runtimes. The beautiful GitHub repo and readme stand out as a template for CLI projects, pulling 153 stars fast.

Who should use this?

macOS fullstack devs juggling Node apps, Docker stacks, and local DBs who debug port clashes daily. Frontend teams on Next.js or Vite needing uptime glances without Activity Monitor dives. Local devops folks running Rails, FastAPI, or Postgres containers tired of `lsof` spam.

Verdict

Solid npx-try for macOS port chaos—beautiful CLI with top docs, but 153 stars and 1.0% credibility score mean it's early and untested at scale. Skip if on Linux (planned) or needing Windows; otherwise, install globally for daily wins.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.