NAME

viewjobs - Interactive TUI for viewing and managing SLURM jobs

VERSION

version 0.21.0

SYNOPSIS

viewjobs

DESCRIPTION

An interactive terminal user interface (TUI) for viewing and managing SLURM jobs, similar to VisiData or less. Provides keyboard navigation, sorting, column management, job selection, and deletion capabilities.

FEATURES

• Interactive table view with keyboard navigation

• Multi-job selection with space bar

• Column sorting (ascending/descending)

• Dynamic column width adjustment

• Column hiding/unhiding

• Job deletion with confirmation

• Real-time job list refresh

KEYBOARD SHORTCUTS

Navigation

• Arrow keys (↑↓←→) or Vim keys (hjkl) - Move cursor

• Page Up/Down - Scroll by page

• Home/End or g/G - Jump to top/bottom

Selection and Actions

• Space - Toggle job selection

• [ - Sort column ascending

• ] - Sort column descending

• + or = - Increase column width

• - - Decrease column width

• @ - Hide current column

• Ctrl+H - Unhide all columns

• d or Ctrl+D - Delete selected jobs (with confirmation)

• r or Ctrl+R - Refresh job list

• Ctrl+L - Redraw screen

• q or Ctrl+C - Quit

EXAMPLES

Example 1: Basic usage

viewjobs

Launch the interactive viewer and navigate with arrow keys.

Example 2: Select and delete jobs

1. Use arrow keys to navigate to a job
2. Press Space to select it
3. Select additional jobs if needed
4. Press 'd' to delete
5. Confirm with 'y'

Example 3: Sort and customize view

1. Use left/right arrows to select a column
2. Press '[' to sort ascending or ']' for descending
3. Press '+' or '-' to adjust column width
4. Press '@' to hide unwanted columns

NOTES

• Requires a terminal with ANSI color support

• Terminal resize requires restarting the application

• Array jobs show individual job elements

SEE ALSO

lsjobs

AUTHOR

Andrea Telatin <proch@cpan.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2023-2025 by Andrea Telatin.

This is free software, licensed under:

The MIT (X11) License