portcheck-cli 0.1.0

Check what's using a port and optionally kill it

portcheck

Check what's using a port and optionally kill it.

Simple, fast, with JSON output for automation.

Installation

pip install portcheck-cli

Usage

Check a specific port

# See what's on port 8080
portcheck check 8080

# Kill whatever's using port 8080
portcheck check 8080 --kill

# Force kill without confirmation
portcheck check 8080 --kill -f -y

# Check UDP port
portcheck check 53 --udp

# Get JSON output
portcheck check 8080 --json

Scan a range of ports

# Scan ports 8000-9000
portcheck scan 8000 9000

# Get JSON output
portcheck scan 3000 3100 --json

List all listening ports

portcheck list

# JSON output
portcheck list --json

Kill a process by PID

portcheck kill 12345
portcheck kill 12345 -f -y  # Force, no confirm

JSON Output

All commands support --json for machine-readable output:

[
  {
    "port": 8080,
    "protocol": "TCP",
    "status": "LISTEN",
    "pid": 12345,
    "local_address": "127.0.0.1:8080",
    "name": "python",
    "cmdline": "python -m http.server 8080",
    "user": "ape"
  }
]

For AI Agents

See SKILL.md for agent-optimized documentation.

License

MIT