psinfo 1.1.4

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
psinfo nginx -w            # watch nginx processes
psinfo nginx -w 5 -s mem   # watch nginx, sort by memory, 5s interval
psinfo nginx -t            # group by process tree

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

---

Output

Metrics are colour-coded: green (< 10%), orange (≥ 10%), red (≥ 50%). Tree view groups processes by parent/child with ∑ totals for subtrees.

---

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.