Made with Textual: PortPilot, a TUI for local ports and processes

[cyber-emreclskn]

Hi Textual community! I maintain PortPilot, a Python terminal tool for the "what is using port 3000?" part of local development.

The interactive interface is built with Textual, alongside a CLI using Rich, Click, and psutil. It lets you inspect listening ports, filter the list, view process details, and manage the processes behind those ports.

The TUI supports keyboard navigation and filtering by port, process name, PID, or command line. For workflows that do not need the full-screen interface, the CLI provides port inspection, watch mode, and JSON output.

Try the TUI with uv:

uvx portpilot

Or install it and inspect a development port:

uv tool install portpilot
pp list -p 3000
pp info 3000

I'd particularly welcome feedback from other Textual users on:

• The keyboard flow between filtering and selecting a process.
• Readability and information density in narrower terminals.
• Which process details are most useful while debugging a local development server.

Source, installation, and platform notes · PyPI · Feedback and usage discussion

Thanks to the Textual community for the framework that makes this interface possible.