slurmer

A TUI application for monitoring and managing SLURM jobs.

It provides an intuitive, interactive interface to view, filter, sort, and manage SLURM jobs, making SLURM job management more efficient and user-friendly.

✨ Features

• 🔄 Real-time Job Monitoring: View and refresh SLURM job statuses in real-time
• 🔍 Advanced Filtering: Filter jobs by user, state, partition, QoS, job name, and more in real-time(regex supported)
• 📊 Customizable Columns: Flexibly configure which job information columns to display and in what order
• 📝 Job Details View: Examine job scripts and job logs <br>
• 🎮 Job Management: Cancel selected jobs

<!-- | 🔄 **Real-time Job Monitoring** | 🔍 **Advanced Filtering** | 📊 **Customizable Columns** | |----------------------------------|---------------------------|------------------------------| | **View and refresh SLURM job statuses in real-time**<br> | **Filter jobs by user, state, partition, QoS, job name, and more in real-time (regex supported)**<br> | **Flexibly configure which job information columns to display and in what order**<br> | | 📝 **Job Details View** | 🎮 **Job Management** | | |----------------------------------|---------------------------|------------------------------| | **Examine job scripts and job logs**<br><br> | **Cancel selected jobs directly from the UI**<br> | | -->

🛠️ Installation

cargo install slurmer

or install from the latest source code:

cargo install --git https://github.com/wjwei-handsome/Slurmer.git

📖 Usage

Just run slurmer.

⌨️ Keyboard Shortcuts

• <kbd>↓/↑</kbd>: Move up and down in the job list
• <kbd>Shift + ↓/↑</kbd>: Move job in the log-view/script-view
• <kbd>f</kbd>: Open filter menu
• <kbd>c</kbd>: Open column selection menu
• <kbd>v</kbd>: View job logs
• <kbd>Enter</kbd>: View job script
• <kbd>Space</kbd>: Select job
• <kbd>a</kbd>: Select all jobs
• <kbd>r</kbd>: Refresh job list
• <kbd>x</kbd>: Cancel selected jobs
• <kbd>Esc</kbd>: Quit application

More detailed keybindings can be found each popup menu.

🔗 Dependencies

• slurm utilities (e.g., squeue, scancel) is required.
• bat is optional for viewing job scripts.

⚙️ Configuration

slurmer automatically detects available SLURM partitions and QoS in your system and uses the currently logged-in username as the default filter.

👥 Contributing

Contributions are welcome! Feel free to submit issues or pull requests.

📜 License

Copyright (c) wjwei-handsome weiwenjie@westlake.edu.cn

This project is licensed under the MIT license (LICENSE or http://opensource.org/licenses/MIT)