Skip to main content

Keyboard Shortcuts

Comprehensive guide to all keyboard shortcuts in s9s.

Global Shortcuts

These shortcuts work from any view:

KeyActionDescription
?
Show helpDisplay help modal with shortcuts
q
QuitExit s9s application
:
Command modeEnter command mode (vim-style)
Tab
Next viewCycle through views
Shift+Tab
Previous viewCycle backwards through views
Ctrl+r
Force refreshRefresh current view data
R
Manual refreshRefresh view (most views)
Ctrl+F
Global searchSearch across all cluster resources
Ctrl+C
CancelCancel current operation or close modal
ESC
Exit/CloseExit filter mode, close modal, cancel operation

Navigation Shortcuts

KeyActionDescription
J
Jobs viewJump to Jobs view
N
Nodes viewJump to Nodes view
P
Partitions viewJump to Partitions view

Dashboard View

KeyActionDescription
J
Jobs viewSwitch to Jobs view
N
Nodes viewSwitch to Nodes view
P
Partitions viewSwitch to Partitions view
A
Advanced analyticsOpen analytics modal
H
Health checkOpen health check modal
R
Refresh dashboardManual refresh all panels

Analytics Modal (from Dashboard)

KeyActionDescription
R
Refresh analyticsUpdate analytics data
ESC
Close modalReturn to dashboard

Health Check Modal (from Dashboard)

KeyActionDescription
R
Refresh healthUpdate health check
ESC
Close modalReturn to dashboard

Jobs View

Job Operations

KeyActionDescription
Enter
View detailsShow detailed job information
s/S
Submit jobOpen job submission wizard
F2
Job templatesOpen job templates/submission form
c/C
Cancel jobCancel selected job
H
Hold jobPlace job on hold
r
Release jobRelease held job
q/Q
Requeue jobRequeue completed/failed job
o/O
View outputView job output/logs
d/D
View dependenciesShow job dependency graph

Batch Operations

KeyActionDescription
b/B
Batch operationsOpen batch operations menu
v/V
Multi-select modeToggle multi-select mode
Space
Toggle selectionSelect/deselect current row (in multi-select)
Ctrl+A
Select allSelect all jobs (in multi-select)

Filtering & Search

KeyActionDescription
/
Simple filterActivate filter input
F3
Advanced filterOpen advanced filter bar
Ctrl+F
Global searchSearch all cluster resources
a/A
Filter all statesShow all job states
p/P
Filter pendingShow pending jobs only
u/U
Filter by userFilter jobs by username
ESC
Exit filterClear filter and exit filter mode

Data Management

KeyActionDescription
R
Manual refreshRefresh jobs data
m/M
Toggle auto-refreshEnable/disable auto-refresh (30s)
F1
Action menuShow context-sensitive actions
1-9
Sort by columnSort by column number

Nodes View

Node Operations

KeyActionDescription
Enter
View detailsShow node details and metrics
d/D
Drain nodeDrain selected node
r
Resume nodeResume drained node
s/S
SSH to nodeOpen SSH options menu

Filtering & Search

KeyActionDescription
/
Simple filterActivate filter input
F3
Advanced filterOpen advanced filter bar
Ctrl+F
Global searchSearch all cluster resources
p/P
Partition filterFilter by partition
a/A
Toggle all statesToggle "all states" filter
i/I
Toggle idleToggle idle state filter
m/M
Toggle mixedToggle mixed state filter
ESC
Exit filterClear filter and exit filter mode

Grouping

KeyActionDescription
g/G
Group byOpen grouping dialog (none/partition/state/features)
Space
Toggle expansionExpand/collapse group (when grouped)

Data Management

KeyActionDescription
R
Manual refreshRefresh nodes data
1-9
Sort by columnSort by column number

Partitions View

Partition Operations

KeyActionDescription
Enter
View detailsShow partition details
J
View jobsSwitch to Jobs view filtered by partition
N
View nodesSwitch to Nodes view filtered by partition
A
AnalyticsOpen partition analytics dashboard
W
Wait time analyticsShow wait time analytics

Filtering & Search

KeyActionDescription
/
Simple filterActivate filter input
F3
Advanced filterOpen advanced filter bar
Ctrl+F
Global searchSearch all cluster resources
ESC
Exit filterClear filter and exit filter mode

Data Management

KeyActionDescription
R
Manual refreshRefresh partitions data
1-9
Sort by columnSort by column number

Users View

User Operations

KeyActionDescription
Enter
View detailsShow user details and limits

Filtering & Search

KeyActionDescription
/
Simple filterActivate filter input
F3
Advanced filterOpen advanced filter bar
Ctrl+F
Global searchSearch all cluster resources
a/A
Toggle admin filterShow admins/operators only or all users
ESC
Exit filterClear filter and exit filter mode

Data Management

KeyActionDescription
R
Manual refreshRefresh users data
1-9
Sort by columnSort by column number

Accounts View

Account Operations

KeyActionDescription
Enter
View detailsShow account details and hierarchy
H
Hierarchy treeDisplay full account hierarchy tree

Filtering & Search

KeyActionDescription
/
Simple filterActivate filter input
F3
Advanced filterOpen advanced filter bar
Ctrl+F
Global searchSearch all cluster resources
ESC
Exit filterClear filter and exit filter mode

Data Management

KeyActionDescription
R
Manual refreshRefresh accounts data
1-9
Sort by columnSort by column number

QoS View

QoS Operations

KeyActionDescription
Enter
View detailsShow QoS policy details and limits

Filtering & Search

KeyActionDescription
/
Simple filterActivate filter input
F3
Advanced filterOpen advanced filter bar
Ctrl+F
Global searchSearch all cluster resources
ESC
Exit filterClear filter and exit filter mode

Data Management

KeyActionDescription
R
Manual refreshRefresh QoS data
1-9
Sort by columnSort by column number

Reservations View

Reservation Operations

KeyActionDescription
Enter
View detailsShow reservation details and usage

Filtering & Search

KeyActionDescription
/
Simple filterActivate filter input
F3
Advanced filterOpen advanced filter bar
Ctrl+F
Global searchSearch all cluster resources
a/A
Toggle activeShow active reservations only (TODO)
f/F
Toggle futureShow future reservations only (TODO)
ESC
Exit filterClear filter and exit filter mode

Data Management

KeyActionDescription
R
Manual refreshRefresh reservations data
1-9
Sort by columnSort by column number

Health View

Alert Operations

KeyActionDescription
Enter
View alertShow alert details and recommendations
a/A
AcknowledgeAcknowledge first unacknowledged alert
r
ResolveResolve first active alert
c/C
Clear resolvedRemove resolved alerts >24h old

Health Information

KeyActionDescription
H
Health checksShow detailed health check report
s/S
StatisticsShow health statistics dashboard

Data Management

KeyActionDescription
R
Manual refreshRefresh health data
ESC
Close modalClose detail modals

Advanced Filter Syntax

When using

F3
for advanced filtering, use these expression patterns:

Field Matching

field:value          - Contains match
field=value          - Exact match
field:>value         - Greater than (numeric)
field:<value         - Less than (numeric)
field:>=value        - Greater or equal (numeric)
field:<=value        - Less or equal (numeric)

Examples

Jobs:

state:RUNNING partition:gpu
user:alice priority:>500
nodes:>=8 state:PENDING

Nodes:

state:IDLE partition:gpu
features:nvlink cpus:>64
memory:>256GB

Partitions:

state:UP nodes:>100
efficiency:>80 qos:high

Users:

admin:Administrator
account:research qos:high
maxjobs:>50

Accounts:

organization:research
parent:root qos:high
maxcpus:>1000

QoS:

priority:>1000
preempt:Suspend
maxjobs:>100

Reservations:

state:ACTIVE nodes:>16
users:alice accounts:ml-team

Special Filter Syntax

Partition Filtering (Simple Filter)

In simple filter mode (

/
), use special syntax:

p:gpu               - Filter by partition "gpu"
partition:cpu       - Filter by partition "cpu"

Works in Jobs and Nodes views.

Tips & Tricks

Quick Navigation

  • Press
    Tab
    repeatedly to cycle through all views
  • Use
    J
    ,
    N
    ,
    P
    for direct jumps to common views
  • Ctrl+F
    for global search finds resources across all views

Efficient Filtering

  • Use
    /
    for quick keyword search
  • Use
    F3
    when you need complex multi-field filtering
  • Press
    ESC
    to quickly clear filters
  • Special syntax like
    p:gpu
    saves time

Batch Operations (Jobs)

  1. Press
    v/V
    to enter multi-select mode
  2. Use
    Space
    to select specific jobs
  3. Use
    Ctrl+A
    to select all
  4. Press
    b/B
    for batch operations menu

Grouping (Nodes)

  1. Press
    g/G
    to group by partition/state/features
  2. Use
    Space
    to expand/collapse groups
  3. Makes large node lists easier to navigate

Refresh Strategies

  • Most views auto-refresh every 10-30 seconds
  • Use
    R
    for immediate manual refresh
  • Jobs view:
    m/M
    toggles auto-refresh on/off

Help When Stuck

  • Press
    ?
    for context-sensitive help
  • Press
    F1
    for action menu (shows available operations)
  • Press
    ESC
    to cancel most operations

Customizing Shortcuts

See Configuration Guide for information on customizing keyboard shortcuts.

Accessibility

s9s keyboard shortcuts are designed for:

  • Keyboard-only navigation
  • Screen reader compatibility
  • No mouse required for any operation
  • Consistent patterns across views

Vim-Style Commands

Press

:
to enter vim-style command mode with tab completion support:

Command Completion

:q<Tab>            - Shows: q, qos, quit
:req<Tab>          - Completes to: requeue
:dr<Tab>           - Completes to: drain

Argument Completion

:cancel <Tab>      - Shows available job IDs
:drain <Tab>       - Shows available node names
:requeue <Tab>     - Shows available job IDs

Common Commands

:quit              - Exit application
:refresh           - Refresh current view
:help              - Show help
:cancel JOBID      - Cancel specific job (with autocomplete)
:drain NODE        - Drain specific node (with autocomplete)

How it works: Completions are context-aware and use data from the currently loaded views, so you'll see real job IDs and node names from your cluster.

See Commands Reference for full command list.