Skip to content

TUI Guide

Launch the TUI with:

procclean

TUI Main View

Keybindings
Key Action
Q Quit
R Refresh
K Kill selected (SIGTERM)
Shift+K Force kill (SIGKILL)
O Show orphans
A Show all
G Show groups
W Filter by selected cwd
Shift+W Clear cwd filter
Space Toggle selection
S Select all visible
C Clear selection
1 Sort by memory
2 Sort by CPU
3 Sort by PID
4 Sort by name
5 Sort by cwd
Shift+1 Reverse sort order

Views

All Processes

Shows all user processes sorted by memory usage.

Orphaned

Processes with PPID=1 (parent process died). Tmux processes are excluded from orphan detection.

Orphans View

Process Groups

Similar processes grouped together - useful for finding duplicate instances consuming resources.

Process Groups View

High Memory

Processes using more than 500MB RAM.

High Memory View

Selection

Use Space to toggle selection on processes:

Selected Processes

Workflow

  1. Launch TUI: procclean
  2. Press O to view orphans
  3. Use Space to select processes to kill
  4. Press K to kill (SIGTERM) or Shift+K to force kill (SIGKILL)
  5. Confirm the action in the dialog