A real-time TUI for monitoring SLURM jobs -- see status, stdout, and stderr in one place.
- Real-time status monitoring (QUEUED -> RUNNING -> COMPLETED/FAILED)
- Live stdout/stderr tailing
- Multi-job support with easy switching
- Auto-discover jobs from
sacct - Single binary, no runtime dependencies
cargo install --path .
# or
cargo build --release && cp target/release/slurm-monitor ~/.local/bin/# Monitor all your jobs (auto-discovers from sacct)
slurm-monitor watch
# Monitor specific jobs
slurm-monitor watch 12345 12346
# Submit and monitor
slurm-monitor submit my_job.sh| Key | Action |
|---|---|
| Tab | Switch stdout/stderr focus |
| Up/Down | Scroll focused panel |
| PgUp/PgDn | Scroll by page |
| Home/End | Jump to top/bottom |
| n/p | Next/previous job |
| d | Remove job from view |
| q | Exit scroll mode / quit |
| Ctrl+C | Quit |
| Command | Description |
|---|---|
submit <script> |
Submit a batch script and start monitoring |
watch [job_ids...] |
Monitor jobs (all visible jobs if none specified) |
list |
List all tracked jobs with status |
stop <job_id> |
Stop monitoring a job (does not cancel it) |
Run slurm-monitor <command> --help for detailed options.
Job output files not found -- Ensure the job has started (files are created at launch), you have read permissions, and output files are in the expected location. The tool checks sacct paths, then falls back to slurm-<job_id>.out in the current directory.
Status shows UNKNOWN -- The job ID may not exist, SLURM commands may not be in PATH, or there may be permission issues.
UI not displaying correctly -- Ensure your terminal supports colors and Unicode. If using tmux/screen, check terminal settings.
MIT