discovery

command	aliases	description
on	:	port/process lookup (bidirectional)
for	f	find processes by file path
by	b	filter processes by name
in		filter processes by working directory
list	l, ps	list processes
info	i	show detailed process information
ports	p	list all listening ports
tree	t	show process tree
watch	w, top	real-time process monitoring
stuck	x	find stuck/hung processes

lifecycle

command	aliases	description
kill	k	force kill processes (SIGKILL)
stop	s	graceful stop (SIGTERM, then SIGKILL)
unstick	u	attempt to recover stuck processes

common options

most commands support these flags (check individual command pages for details):

flag	short	description
--json	-j	output as JSON
--verbose	-v	show extra details
--in <dir>	-i	filter by directory
--by <name>	-b	filter by process name
--help	-h	show help

target syntax

targets work the same way everywhere:

proc on :3000          # port
proc on 1234           # PID
proc on node           # name
proc kill :3000,:8080  # multiple (comma-separated)