Metadata-Version: 2.4
Name: portcheck-tool
Version: 0.13.0
Summary: See what's using a port and free it safely: which process, who started it, stop it. Fixes "port already in use".
Author: Royston D
License-Expression: MIT
License-File: LICENSE
Project-URL: Homepage, https://roystondwork-dev.github.io/portcheck/
Project-URL: Source, https://github.com/roystondwork-dev/portcheck
Project-URL: Issues, https://github.com/roystondwork-dev/portcheck/issues
Keywords: port,eaddrinuse,port-in-use,address-already-in-use,kill-port,lsof,netstat,localhost,django,flask,cli
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: Microsoft :: Windows
Classifier: Topic :: System :: Networking
Classifier: Topic :: Software Development
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# portcheck

See what's using a port and free it safely: which process, who started it, stop it.
Fixes "port already in use" (`EADDRINUSE`, `Address already in use`).

```sh
pipx install portcheck-tool # or: pip install portcheck-tool / uv tool install portcheck-tool

portcheck 3000              # who holds port 3000? (exit 1 if in use)
portcheck kill 3000         # stop it, after confirming; never system processes
portcheck free              # a free port
portcheck                   # interactive view of every listening port
```

```text
PORT  PROTO  STATUS  PID    PROCESS  USER
3000  tcp    in-use  41852  node     alice
```

Works on macOS, Linux and Windows (x64 and arm64). This package installs the native
`portcheck` binary; there's no Python code and nothing is downloaded at runtime.

Also available for VS Code, JetBrains IDEs, Edge and Firefox, and through Homebrew,
Scoop and npm (`npx portcheck-cli 3000`).

- Documentation: https://roystondwork-dev.github.io/portcheck/
- Source (MIT): https://github.com/roystondwork-dev/portcheck
