Navigation & Keyboard Shortcuts

S9S follows vim-style navigation patterns, making it intuitive for terminal power users. This guide covers all keyboard shortcuts and navigation methods currently implemented.

Navigation Philosophy

S9S uses a simple interface inspired by vim with basic navigation and view switching capabilities.

Global Shortcuts

These shortcuts work across all views:

Essential Keys

Ctrl+C

Esc

Tab

F1

F2

F5

View Navigation

1

2

3

4

5

6

7

8

9

Movement

j

↓

k

↑

g

G

View-Specific Shortcuts

Jobs View

Enter

s

c

H

r

o

d

q

b

v

m

/

F3

Ctrl+F

F1

F2

1-9

R

Nodes View

Enter

s

d

r

/

F3

Ctrl+F

1-9

R

p

a

g

Space

Partitions View

Enter

J

N

A

W

/

F3

Ctrl+F

1-9

R

QoS View

Enter

/

F3

Ctrl+F

1-9

R

Accounts View

Enter

H

/

F3

Ctrl+F

1-9

R

Users View

Enter

a

/

F3

Ctrl+F

1-9

R

Reservations View

Enter

a

f

/

F3

Ctrl+F

1-9

R

Dashboard View

J

N

P

A

H

R

Health View

Enter

a

r

c

R

H

s

Search and Filter Mode

Enter filter mode with

/

F3

Basic Filter

Copy
/keyword           # Simple text search in current view
/RUNNING          # Find all running items
/gpu              # Find GPU-related items

Advanced Filter

Press

F3

• Field-specific filtering
• Operator support (equals, contains, greater than, less than)
• Multiple filter conditions
• Save and load filter presets

Global Search

Press

Ctrl+F

Tips & Tricks

Efficiency Tips

1. Use vim keys:
   Copy

   j

   /
   Copy

   k

   for up/down,
   Copy

   g

   /
   Copy

   G

   for top/bottom
2. Quick view switching: Number keys
   Copy

   1-9

   switch directly to views
3. Quick filters:
   Copy

   /

   for instant filtering in any view
4. Multi-select: Use
   Copy

   v

   in jobs view for batch operations
5. Sort quickly: Use
   Copy

   1-9

   to sort by different columns

Power User Workflows

Copy
# Cancel all failed jobs
1                # Switch to jobs view
/FAILED         # Filter failed jobs
v                # Enter multi-select mode
c                # Cancel selected jobs

# SSH to GPU node
2                # Switch to nodes view
/gpu             # Filter GPU nodes
s                # SSH to selected node

# Check partition health
3                # Switch to partitions view
W                # View wait time analytics

Command Mode

Press

:

Quick Examples

Copy
:cancel 12345      # Cancel job 12345
:drain node01      # Drain node01
:requeue 67890     # Requeue job 67890

Tab Completion

• Type
  Copy

  :req

  and press
  Copy

  Tab

  → completes to
  Copy

  :requeue

• Type
  Copy

  :cancel 

  and press
  Copy

  Tab

  → shows available job IDs
• Type
  Copy

  :drain 

  and press
  Copy

  Tab

  → shows available node names

Commands use cached data from views for instant autocomplete without API calls.

See Commands Reference for complete command documentation.

Features

• Real-time updates - Data refreshes automatically
• Command mode with autocomplete - Vim-style
  Copy

  :

  commands with Tab completion
• ASCII visualizations - Resource usage shown with colored progress bars
• Advanced filtering - Use
  Copy

  /

  to filter data in any view or
  Copy

  F3

  for advanced filters
• Sortable columns - Use number keys
  Copy

  1-9

  to sort
• Detailed analytics - Press
  Copy

  A

  or
  Copy

  W

  in partitions for insights
• Node grouping - Group nodes by partition, state, or features
• Wait time analysis - Predictive queue analytics in partitions
• Health monitoring - Cluster health scoring and alerts in health view
• Hierarchical views - Account hierarchy and dependency trees
• Global search - Cross-view search with
  Copy

  Ctrl+F

Color Coding

• Green - Running, Available, Healthy states
• Yellow - Pending, Mixed, Warning states
• Red - Failed, Down, Error states
• Blue - Allocated, Active states
• Cyan - Information, Special states
• Orange - Drain, Maintenance states
• Gray - Unknown, Inactive states

Resource Usage Bars

Visual representation of resource utilization:

• Copy

  █

  - Used/Actual usage
• Copy

  ▒

  - Allocated by SLURM
• Copy

  ▱

  - Free/Available

Bar colors:

• Green bars - Low usage (< 50%)
• Yellow bars - Medium usage (50-80%)
• Red bars - High usage (> 80%)

Next Steps

• Practice navigation in mock mode:
  Copy

  s9s --mock

• Learn advanced filtering techniques
• Explore individual view guides:
  • Jobs View
  • Nodes View
  • Partitions View
  • Dashboard View
  • Health View