roctop v0.2.0
roctop v0.2.0
v0.2.0 adds live history graphs, interactive process controls, safer process actions, and a refreshed synthetic demo.
Highlights
- Added live history graphs for average CPU, memory, GPU utilization, and GPU memory usage.
- Added interactive process navigation with
j/k, arrow keys,PgUp/PgDn, and persistent selection across refreshes. - Added process sorting by GPU, GPU memory, GPU memory percent, CPU, memory, PID, user, time, and command.
- Added a high-contrast sort menu with selected-column direction indicators.
- Added process kill confirmation with selectable
Cancel,SIGTERM, andSIGKILLoptions.
UI Improvements
- Process commands now wrap instead of truncating, making long training/server commands readable.
- Header layout now separates system info from keyboard shortcuts.
- Graph layout was refined so upper/lower graphs align cleanly with the time axis.
- GPU graph order now shows average GPU above average GPU memory.
- GPU utilization headers were renamed from
MEM/UTLto%Memory-Usageand%Utilization. - Selection and menu highlights were adjusted for better contrast.
Robustness
- Improved handling for malformed
amd-smi processJSON entries. - Live mode handles graceful
Ctrl-Cshutdown. - Process cursor stays visible after resize, sorting, long command wrapping, and table cropping.
Docs & Demo
- Refreshed
docs/demo.svgusing synthetic data only. - Demo now shows 8 GPUs with realistic GUIDs, dummy process names, varied GPU states, and random-walk graphs.
- Added repository contributor guidance in
AGENTS.md. - Added a bundled Codex skill for regenerating the roctop demo SVG safely.
Upgrade
git fetch --tags
git checkout v0.2.0
.venv/bin/python -m pip install -e .