Keyboard Shortcuts
Comprehensive guide to all keyboard shortcuts in s9s.
Global Shortcuts
These shortcuts work from any view:
| Key | Action | Description |
|---|
| Show help | Display help modal with shortcuts |
| Quit | Exit s9s application |
| Command mode | Enter command mode (vim-style) |
| Next view | Cycle through views |
| Previous view | Cycle backwards through views |
| Force refresh | Refresh current view data |
| Manual refresh | Refresh view (most views) |
| Global search | Search across all cluster resources |
| Cancel | Cancel current operation or close modal |
| Exit/Close | Exit filter mode, close modal, cancel operation |
Navigation Shortcuts
| Key | Action | Description |
|---|
| Jobs view | Jump to Jobs view |
| Nodes view | Jump to Nodes view |
| Partitions view | Jump to Partitions view |
Dashboard View
| Key | Action | Description |
|---|
| Jobs view | Switch to Jobs view |
| Nodes view | Switch to Nodes view |
| Partitions view | Switch to Partitions view |
| Advanced analytics | Open analytics modal |
| Health check | Open health check modal |
| Refresh dashboard | Manual refresh all panels |
Analytics Modal (from Dashboard)
| Key | Action | Description |
|---|
| Refresh analytics | Update analytics data |
| Close modal | Return to dashboard |
Health Check Modal (from Dashboard)
| Key | Action | Description |
|---|
| Refresh health | Update health check |
| Close modal | Return to dashboard |
Jobs View
Job Operations
| Key | Action | Description |
|---|
| View details | Show detailed job information |
| Submit job | Open job submission wizard |
| Job templates | Open job templates/submission form |
| Cancel job | Cancel selected job |
| Hold job | Place job on hold |
| Release job | Release held job |
| Requeue job | Requeue completed/failed job |
| View output | View job output/logs |
| View dependencies | Show job dependency graph |
Batch Operations
| Key | Action | Description |
|---|
| Batch operations | Open batch operations menu |
| Multi-select mode | Toggle multi-select mode |
| Toggle selection | Select/deselect current row (in multi-select) |
| Select all | Select all jobs (in multi-select) |
Filtering & Search
| Key | Action | Description |
|---|
| Simple filter | Activate filter input |
| Advanced filter | Open advanced filter bar |
| Global search | Search all cluster resources |
| Filter all states | Show all job states |
| Filter pending | Show pending jobs only |
| Filter by user | Filter jobs by username |
| Exit filter | Clear filter and exit filter mode |
Data Management
| Key | Action | Description |
|---|
| Manual refresh | Refresh jobs data |
| Toggle auto-refresh | Enable/disable auto-refresh (30s) |
| Action menu | Show context-sensitive actions |
| Sort by column | Sort by column number |
Nodes View
Node Operations
| Key | Action | Description |
|---|
| View details | Show node details and metrics |
| Drain node | Drain selected node |
| Resume node | Resume drained node |
| SSH to node | Open SSH options menu |
Filtering & Search
| Key | Action | Description |
|---|
| Simple filter | Activate filter input |
| Advanced filter | Open advanced filter bar |
| Global search | Search all cluster resources |
| Partition filter | Filter by partition |
| Toggle all states | Toggle "all states" filter |
| Toggle idle | Toggle idle state filter |
| Toggle mixed | Toggle mixed state filter |
| Exit filter | Clear filter and exit filter mode |
Grouping
| Key | Action | Description |
|---|
| Group by | Open grouping dialog (none/partition/state/features) |
| Toggle expansion | Expand/collapse group (when grouped) |
Data Management
| Key | Action | Description |
|---|
| Manual refresh | Refresh nodes data |
| Sort by column | Sort by column number |
Partitions View
Partition Operations
| Key | Action | Description |
|---|
| View details | Show partition details |
| View jobs | Switch to Jobs view filtered by partition |
| View nodes | Switch to Nodes view filtered by partition |
| Analytics | Open partition analytics dashboard |
| Wait time analytics | Show wait time analytics |
Filtering & Search
| Key | Action | Description |
|---|
| Simple filter | Activate filter input |
| Advanced filter | Open advanced filter bar |
| Global search | Search all cluster resources |
| Exit filter | Clear filter and exit filter mode |
Data Management
| Key | Action | Description |
|---|
| Manual refresh | Refresh partitions data |
| Sort by column | Sort by column number |
Users View
User Operations
| Key | Action | Description |
|---|
| View details | Show user details and limits |
Filtering & Search
| Key | Action | Description |
|---|
| Simple filter | Activate filter input |
| Advanced filter | Open advanced filter bar |
| Global search | Search all cluster resources |
| Toggle admin filter | Show admins/operators only or all users |
| Exit filter | Clear filter and exit filter mode |
Data Management
| Key | Action | Description |
|---|
| Manual refresh | Refresh users data |
| Sort by column | Sort by column number |
Accounts View
Account Operations
| Key | Action | Description |
|---|
| View details | Show account details and hierarchy |
| Hierarchy tree | Display full account hierarchy tree |
Filtering & Search
| Key | Action | Description |
|---|
| Simple filter | Activate filter input |
| Advanced filter | Open advanced filter bar |
| Global search | Search all cluster resources |
| Exit filter | Clear filter and exit filter mode |
Data Management
| Key | Action | Description |
|---|
| Manual refresh | Refresh accounts data |
| Sort by column | Sort by column number |
QoS View
QoS Operations
| Key | Action | Description |
|---|
| View details | Show QoS policy details and limits |
Filtering & Search
| Key | Action | Description |
|---|
| Simple filter | Activate filter input |
| Advanced filter | Open advanced filter bar |
| Global search | Search all cluster resources |
| Exit filter | Clear filter and exit filter mode |
Data Management
| Key | Action | Description |
|---|
| Manual refresh | Refresh QoS data |
| Sort by column | Sort by column number |
Reservations View
Reservation Operations
| Key | Action | Description |
|---|
| View details | Show reservation details and usage |
Filtering & Search
| Key | Action | Description |
|---|
| Simple filter | Activate filter input |
| Advanced filter | Open advanced filter bar |
| Global search | Search all cluster resources |
| Toggle active | Show active reservations only (TODO) |
| Toggle future | Show future reservations only (TODO) |
| Exit filter | Clear filter and exit filter mode |
Data Management
| Key | Action | Description |
|---|
| Manual refresh | Refresh reservations data |
| Sort by column | Sort by column number |
Health View
Alert Operations
| Key | Action | Description |
|---|
| View alert | Show alert details and recommendations |
| Acknowledge | Acknowledge first unacknowledged alert |
| Resolve | Resolve first active alert |
| Clear resolved | Remove resolved alerts >24h old |
Health Information
| Key | Action | Description |
|---|
| Health checks | Show detailed health check report |
| Statistics | Show health statistics dashboard |
Data Management
| Key | Action | Description |
|---|
| Manual refresh | Refresh health data |
| Close modal | Close detail modals |
Advanced Filter Syntax
When using
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 repeatedly to cycle through all views
- Use , , for direct jumps to common views
- for global search finds resources across all views
Efficient Filtering
- Use for quick keyword search
- Use when you need complex multi-field filtering
- Press to quickly clear filters
- Special syntax like saves time
Batch Operations (Jobs)
- Press to enter multi-select mode
- Use to select specific jobs
- Use to select all
- Press for batch operations menu
Grouping (Nodes)
- Press to group by partition/state/features
- Use to expand/collapse groups
- Makes large node lists easier to navigate
Refresh Strategies
- Most views auto-refresh every 10-30 seconds
- Use for immediate manual refresh
- Jobs view: toggles auto-refresh on/off
Help When Stuck
- Press for context-sensitive help
- Press for action menu (shows available operations)
- Press 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.