Back to Projects
Developer ToolReleased

simpleports

A small CLI for checking and killing processes bound to local ports.

Pythonpsutil

Overview

Faster to type than lsof flags. A cross-platform CLI tool that lists all ports in use, shows what process is using a specific port, and can kill it with a single command. Works on macOS, Linux, and Windows with automatic platform detection. Uses psutil for process management with lsof/netstat fallback.

The Problem

Checking and killing processes on ports means remembering lsof flags or netstat syntax, which gets tedious during development.

The Solution

A simple CLI wrapper: `ports 3000` shows what's there, `ports 3000 kill` ends it. Cross-platform with automatic detection.

The Result

Single-command port management that works across macOS, Linux, and Windows.

Key Features

  • Simple syntax: ports, ports 3000, ports 3000 kill
  • Cross-platform: macOS, Linux, Windows
  • Automatic platform detection with appropriate system calls

My Role

Solo Developer

Status

Released

Tech Stack

Pythonpsutil