Repolode
productdevbook

productdevbook/port-killer

A menu bar app for macOS and Windows that lists listening ports, kills processes, and manages Kubernetes port forwards and Cloudflare Tunnels.

Stars
5,123
Forks
212
Open issues
15
Last commit
5 days ago

What is it?

PortKiller is a cross-platform port management utility for developers. It auto-discovers listening TCP ports and shows the process behind each one, so you can find out what is occupying a port without running lsof or netstat by hand. Processes can be terminated with one click, using either a graceful stop or a force kill.

Beyond port monitoring, the app manages kubectl port-forward sessions with automatic reconnection, connection logs, and connect/disconnect notifications. It also shows the status of active Cloudflare Tunnel connections. Ports can be favorited or watched for notifications, and are grouped into categories such as Web Server, Database, Development, and System.

The macOS version runs as a menu bar app and requires macOS 15 or later, installable via Homebrew or a DMG. A Windows version runs as a system tray app and is distributed as a zip archive.

Key features

  • 01Auto-discovers all listening TCP ports with search and filtering by port or process name.
  • 02One-click process termination with graceful stop or force kill.
  • 03Manages kubectl port-forward sessions with auto-reconnect and logs.
  • 04Shows status of active Cloudflare Tunnel connections.
  • 05Favorites and watched ports with notifications.
  • 06Runs as a menu bar app on macOS and a system tray app on Windows.

Use cases

  • Freeing a port held by a stale dev server without digging through terminal sessions.
  • Keeping Kubernetes port forwards to local databases or services alive across reconnects.
  • Checking which Cloudflare Tunnel connections are currently active from the desktop.

Quick start

  1. 1

    Install via Homebrew (macOS)

    brew install --cask productdevbook/tap/portkiller
  2. 2

    Or download the .dmg from GitHub Releases (macOS) or the .zip (Windows), then extract it

Things to know

  • Supports only macOS and Windows; no Linux version is mentioned.
  • Development setup is described only in CONTRIBUTING.md, not in the README.

Topics

FAQ

What is port-killer?
A menu bar app for macOS and Windows that lists listening ports, kills processes, and manages Kubernetes port forwards and Cloudflare Tunnels. PortKiller is a cross-platform port management utility for developers. It auto-discovers listening TCP ports and shows the process behind each one, so you can find out what is occupying a port without running lsof or netstat by hand. Processes can be terminated with one click, using either a graceful stop or a force kill.
Is port-killer free to use? What license does it have?
port-killer is open source under the MIT license. Check the license terms before using it in commercial products.
Is port-killer still maintained?
Actively maintained. The last commit to port-killer was on Oct 15, 2026.
What can I use port-killer for?
Freeing a port held by a stale dev server without digging through terminal sessions. Keeping Kubernetes port forwards to local databases or services alive across reconnects. Checking which Cloudflare Tunnel connections are currently active from the desktop.
How do I install port-killer?
Install via Homebrew (macOS): brew install --cask productdevbook/tap/portkiller Or download the .dmg from GitHub Releases (macOS) or the .zip (Windows), then extract it
Where can I get port-killer?
The source code and installation instructions are on GitHub: https://github.com/productdevbook/port-killer

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects