proc list
List processes with filters and sorting.
List all processes, with optional filters. Aliases: l, ps.
proc list # all processes
proc list node # filter by name
proc list --sort cpu --limit 10 # top 10 by CPU
The table shows PID, directory, name, arguments, CPU, memory and status, plus uptime on terminals at least 100 columns wide. --verbose and --json always include uptime.
Options
| Flag | Short | Description |
|---|---|---|
--in [<dir>] |
-i |
Filter by directory |
--path <path> |
-p |
Filter by executable path |
--min-cpu <n> |
Minimum CPU % | |
--min-mem <n> |
Minimum memory (MB) | |
--status <s> |
Filter by status: running, sleeping, stopped, zombie | |
--min-uptime <s> |
Minimum uptime in seconds | |
--parent <pid> |
Only children of this parent PID | |
--sort <key> |
-s |
Sort by: cpu, mem, pid, name (default: cpu) |
--limit <n> |
-n |
Limit results |
--json |
-j |
Output as JSON |
--verbose |
-v |
Show command line, cwd, parent PID, uptime |
Examples
# top 10 processes by CPU
proc list --sort cpu --limit 10
# node and python processes
proc list node,python
# high-memory processes in current project
proc list --in . --min-mem 100
# running processes sorted by memory
proc list --status running --sort mem
See also
by and in for targeted filtering, watch for real-time monitoring.