psinfo 1.1.1

Rich terminal process viewer

psinfo

A rich terminal process viewer. Search, filter, and watch running processes with colour-coded output.

psinfo is for when you have a specific question — "what's on port 8080", "how much memory is Chrome using across all its helpers", "is nginx running and what's it doing" — and want a clean answer without launching a full process manager or constructing a ps aux | grep | awk pipeline.

---

Install

pip install psinfo

Or install as an isolated CLI tool with pipx:

pipx install psinfo

---

Quick Start

psinfo nginx               # search by process name
psinfo -u jdoe             # all processes owned by a user
psinfo -p 8080             # process listening on a port
psinfo -P 1234             # single process by PID

Flags

Flag	Short	Description
name		Search by process name or command
-u, --user USERNAME	-u	Filter by username
-p, --port PORT	-p	Find process listening on port
-P, --pid PID	-P	Show process by PID
-w, --watch [N]	-w	Live refresh every N seconds (default: 2)
-s, --sort cpu|mem	-s	Sort order (default: cpu)
-t, --tree	-t	Group results by process tree hierarchy
-T, --top N	-T	Show only the top N results
-e, --expand	-e	Expand command line arguments to full width

Examples

psinfo nginx               # search by process name
psinfo -u jdoe             # all processes owned by a user
psinfo -p 8080             # find process on port 8080
psinfo -P 1234             # show specific PID
psinfo nginx -w            # watch nginx processes
psinfo nginx -w 5 -s mem   # watch nginx, sort by memory, 5s interval
psinfo nginx -t -w         # nginx with tree view

---

Output

Card View (default)

Each matching process is shown as a panel. The highest-CPU process gets a green border. Metrics are colour-coded: green (< 10%), orange (≥ 10%), red (≥ 50%).

Tree View (-t)

Results are grouped by parent/child relationships. Parent nodes show their own CPU plus a ∑ total across the whole subtree.

---

Requirements

• Python 3.9+

---

Platform Support

Platform	Status	Notes
macOS	✓	--port requires sudo
Linux	✓
Windows	✓	Shows handles instead of file descriptors

---

License

MIT — see LICENSE.