Port Finder

Overview

Port Finder (pf) is a Rust CLI + TUI that helps you identify what is using a port and reclaim it quickly.

• Repository: github.com/ItamiForge/port-finder
• Source of truth: standalone port-finder repository

Install

From GitHub

cargo install --git https://github.com/ItamiForge/port-finder.git

From local clone

cargo install --path .

Verify

pf --version

Quick usage

pf
pf list
pf find 3000
pf kill 3000
pf check 8080
pf scan 3000-4000

Commands

• pf: launch interactive TUI
• pf list [--all]: list active ports (--all includes non-listen states)
• pf find <port>: show process details for one port
• pf kill <port> [--force]: terminate process on a port
• pf check <port>: check availability
• pf scan <start-end>: scan range like 3000-4000

TUI controls

• q / Esc: quit
• r: refresh
• ↑ / ↓ or j / k: move selection
• PgUp / PgDn: page navigation
• Home / End: jump first/last row
• Enter: inspect selected process
• K: kill selected process
• Space: toggle row selection
• x: clear selected rows
• B: batch kill selected rows
• a: toggle all/listening view
• g: toggle grouped view
• s: cycle sort mode
• d: toggle sort direction
• /: start filter mode (type, Enter apply, Esc clear)
• c: copy selected local address

Notes

• Cross-platform support: macOS, Linux, and Windows
• Use --force on kill to skip confirmation prompts