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

View Navigation

Movement

View-Specific Shortcuts

Jobs View

Nodes View

Partitions View

QoS View

Accounts View

Users View

Reservations View

Dashboard View

Health View

Search and Filter Mode

Enter filter mode with / in any view:

Basic Filter

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

Advanced Filter

The advanced filter bar supports field-specific filtering with operators (equals, contains, greater than, less than) and multiple filter conditions. Note that the global F3 key opens Preferences, which takes priority over view-level filter bindings.

Global Search

Press Ctrl+F in any data view (Jobs, Nodes, Partitions, QoS, Accounts, Users, Reservations) to search across all entity types.

Tips & Tricks

Efficiency Tips

1. Use arrow keys: ↑/↓ for up/down, Home/End for top/bottom
2. Quick view switching: Number keys 1-9 switch directly to views
3. Quick filters: / for instant filtering in any view
4. Multi-select: Use v in jobs view for batch operations
5. Sort quickly: Press S to open the sort modal

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 : to enter vim-style command mode with intelligent tab completion:

Quick Examples

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

Tab Completion

• Type :req and press Tab → completes to :requeue
• Type :cancel and press Tab → shows available job IDs
• Type :drain and press 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 : commands with Tab completion
• ASCII visualizations - Resource usage shown with colored progress bars
• Advanced filtering - Use / to filter data in any view, or Ctrl+F in data views for global search
• Sortable columns - Press S to open the sort modal
• Detailed analytics - Press A or 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 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:

• █ - Used/Actual usage
• ▒ - Allocated by SLURM
• ▱ - 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: S9S_ENABLE_MOCK=1 s9s --mock
• Learn advanced filtering techniques
• Explore individual view guides:
  • Jobs View
  • Nodes View
  • Partitions View
  • Dashboard View
  • Health View