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
  
• 🎮 Job Management: Cancel selected jobs

🛠️ 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

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