roctop v0.3.0

roctop v0.3.0

This release focuses on making the live process table feel much more like a real interactive terminal tool: process trees, popups, faster collection/rendering, and smoother cursor behavior.

Highlights

• Added Process Tree mode with t

  • Shows GPU processes with their ancestor chain.
  • Keeps parent-child structure while sorting siblings recursively.
  • Supports parent jump with p.
  • Supports sibling navigation with h/Left and l/Right.

• Added popup UI

  • ? opens a centered help popup with the full keybinding table.
  • i opens a selected-process info popup with GPU usage, host usage, tree context, command line, and /proc/<pid> details.
  • Help and info popups now support h/j/k/l as well as arrow keys.

• Improved live interaction behavior

  • Cursor movement now stays within the visible process window before scrolling.
  • Selection is more stable across refreshes, duplicate PIDs, tree/flat toggles, sorting, filtering, and wrapped commands.
  • Header hints and README controls were updated for the new workflows.

• Improved collection/render performance

  • rocm-smi and amd-smi process collection now run in parallel.
  • The collector runs independently from rendering, reducing UI stalls.
  • Key handling and rendering latency were improved for large process lists.

• Improved metrics and graphs

  • Fixed the initial Avg %CPU: N/A startup sample by priming CPU history before live render.
  • Improved graph cadence and timeline rendering.
  • Expanded GPU utilization bars and displayed utilization decimals.

• Improved process data

  • Added PPID support and process ancestor collection from ps.
  • Added process filtering and search controls.
  • Added standardized AMD GPU model display.

• Updated demo and docs

  • Refreshed docs/demo.svg with synthetic tree-mode data.
  • Updated README for v0.3.0, popup controls, --version, and current live controls.

Verification

• Full test suite passes: 131 tests
• roctop --version now reports roctop 0.3.0

Compatibility

No intentional breaking changes. Existing flat process view, --once, and --json workflows remain supported.