fuckport is a small command-line tool for stopping processes by PID, process name, or listening port.

• Kill by PID: fuckport 1234
• Kill by process name: fuckport chrome
• Kill by port: fuckport :3000
• Kill processes using files or directories under a directory tree: fuckport --directory ./project
• Kill multiple targets in one run
• Interactive picker when no target is provided
• Graceful shutdown first, with automatic fallback to force kill

cargo install fuckport

For local development:

cargo install --path .

Or build locally:

cargo build --release

fuckport [OPTIONS] [TARGET]...

Targets:

• 1234 treats the value as a PID
• :8080 treats the value as a port
• Any other value is matched against process name and command line

Options:

• -f, --force: force kill immediately
• -c, --case-sensitive: enable case-sensitive name matching
• -d, --directory <DIR>: kill processes holding files or directories under DIR
• -i, --interactive: open the interactive selector
• -s, --silent: suppress success output
• -v, --verbose: show more detail in interactive mode
• --force-after-timeout <N>: wait time before escalating to force kill
• --wait-for-exit <N>: maximum wait before reporting failure

Kill a process by PID:

fuckport 1337

Kill a process by name:

fuckport safari

Kill whatever is listening on a port:

fuckport :8080

Kill processes holding files or directories under a project tree:

fuckport --directory ./project

Kill multiple targets in one command:

fuckport 1337 safari :8080 --directory ./project

Run without arguments to open the interactive interface:

fuckport

To kill a port, prefix it with a colon, for example :8080.

The interactive interface can be closed with Esc without killing anything.

Process name matching is case-insensitive by default. Queries containing uppercase letters use smart-case matching.

Library-style examples:

cargo run --example parse_targets
cargo run --example list_processes

cargo test

cargo package
cargo publish