Navigation & Controls
Master Gonzo's keyboard shortcuts and mouse controls to analyze logs efficiently. This comprehensive reference covers all navigation techniques, from basic panel switching to advanced power-user workflows.
Quick Reference Needed? Jump to the Complete Shortcut Reference at the bottom of this page.
Navigation Philosophy
Gonzo's navigation is designed around three core principles:
🎯 Efficiency - Common actions have single-key shortcuts
🔄 Consistency - Same shortcuts work across similar contexts
🖱️ Flexibility - Both keyboard and mouse work seamlessly
The interface supports both vim-style navigation (hjkl) and arrow keys, plus point-and-click for users who prefer mouse interaction.
Global Navigation
These shortcuts work from anywhere in Gonzo:
Essential Global Shortcuts
Tab
Next panel
Move clockwise through panels
Fastest way to switch focus
Shift+Tab
Previous panel
Move counter-clockwise
Reverse direction navigation
Space
Global pause/unpause
Freeze entire dashboard
Use to examine data closely
q / Ctrl+C
Quit Gonzo
Exit application
Always works, even from modals
? / h
Show help
Display help overlay
Quick reference without leaving
r
Reset all data
Clear analysis, restart
Fresh start with same config
Advanced Global Controls
u
Cycle update intervals (forward)
1s → 2s → 5s → 10s
Slow down for high-volume logs
U
Cycle update intervals (backward)
10s → 5s → 2s → 1s
Speed up for real-time monitoring
c
Toggle Host/Service columns
Show/hide extra columns in log view
Adjust for terminal width
m
Switch AI model
Open model selection modal
Change AI provider on the fly
Moving Between Panels:
Order: Log Viewer → Word Frequency → Attributes → Counts → repeat
Reverse: Use Shift+Tab to go backwards through this cycle
Click to Focus:
Click anywhere in a panel to focus it immediately
No need to Tab through panels - just click where you want to go
Mouse wheel works in focused panels for scrolling
Mouse + Keyboard Combo:
Click to focus, then use keyboard for precise navigation
Best of both worlds for different interaction styles
Panel-Specific Navigation
Each panel has specialized navigation optimized for its content:
Log Viewer (Top Left)
Basic Movement:
↑/↓ or k/j
Move up/down
Navigate through log entries line by line
Page Up/Down
Jump by pages
Navigate by 10 entries at a time
Home
Jump to top
Go to oldest log (stops auto-scroll)
End
Jump to bottom
Go to newest log (resumes auto-scroll)
Enter
View log details
Open detailed modal for selected entry
Smart Auto-Scroll Behavior:
Advanced Log Navigation:
Mouse Wheel
Scroll up/down
Quick browsing through logs
Click log entry
Select specific log
Jump to particular entry
Shift+Click
Range selection
Select multiple entries (future feature)
Pro Tip: Use Home to jump to the beginning of your log buffer, then End to return to live mode. This is perfect for comparing current issues with earlier events.
Word Frequency (Top Right)
↑/↓ or k/j
Navigate word list
Browse through frequency rankings
Enter
Filter by word
Apply selected word as log filter
Click word
Quick filter
Mouse alternative to Enter
Mouse Wheel
Scroll through words
Browse long frequency lists
Filtering Workflow:
Focus Word Frequency panel (
Tabto navigate there)Use arrows to highlight interesting word
Press
Enterto filter logs containing that wordPress
/and clear filter to return to all logs
Attributes (Bottom Left)
↑/↓ or k/j
Browse attributes
Navigate through key-value pairs
Enter
Search by attribute
Filter logs containing this attribute
Click attribute
Quick search
Mouse alternative to Enter
Mouse Wheel
Scroll attributes
Browse through longer attribute lists
Real-time Updates:
Attributes panel updates based on currently selected log in Log Viewer
Navigate through logs to see how attributes change
Perfect for correlating structured data with specific log entries
Counts (Bottom Right)
Enter
Open analysis modal
View detailed patterns and heatmap
Click panel
Open analysis modal
Mouse alternative to Enter
Analysis Modal Navigation:
↑/↓ or k/j
Scroll content
Navigate through analysis sections
Page Up/Down
Jump by sections
Quick movement through large analysis
Mouse Wheel
Scroll smoothly
Alternative to keyboard scrolling
ESC
Close modal
Return to main dashboard
Filtering and Search Navigation
Filter Mode
/
Enter filter mode
Type regex patterns to filter logs
ESC
Exit filter mode
Cancel filter input, return to normal mode
Enter
Apply filter
Activate the typed filter pattern
Ctrl+C
Clear filter
Remove current filter and show all logs
Filter Mode Workflow:
Search and Highlight
s
Search mode
Find and highlight text in current view
n
Next match
Jump to next highlighted occurrence
N
Previous match
Jump to previous highlighted occurrence
ESC
Clear search
Remove highlighting and exit search
Search vs Filter:
Filter (/): Shows only matching logs, hides others
Search (s): Highlights matches but shows all logs
Modal Navigation
Several features open detailed modals that have their own navigation:
Log Details Modal
Opened by: Pressing Enter on a log entry in Log Viewer
↑/↓ or k/j
Scroll content
Navigate through log details
Tab
Switch between panels
Toggle between log details and chat
i
AI analysis
Get intelligent insights (if AI configured)
c
Start AI chat
Interactive chat about current log
m
Switch AI model
Change AI model without closing modal
ESC
Close modal
Return to main dashboard
AI Analysis Modal
Opened by: Pressing i in log details or using AI features
↑/↓ or k/j
Navigate analysis
Scroll through AI insights
Tab
Switch sections
Move between analysis and recommendations
Enter
Interactive prompts
Respond to AI questions (if available)
m
Switch model
Change AI model mid-analysis
ESC
Close analysis
Return to previous view
Model Selection Modal
Opened by: Pressing m anywhere in the interface
↑/↓ or k/j
Navigate models
Browse available AI models
Page Up/Down
Jump by sections
Quick navigation through many models
Enter
Select model
Switch to highlighted model
ESC
Cancel selection
Keep current model, close modal
Mouse Wheel
Scroll models
Alternative to keyboard navigation
Advanced Navigation Techniques
Power User Workflows
Scenario: You notice errors in Word Frequency
Scenario: Investigating recurring issues
Scenario: Correlating events across services
Efficiency Tips
🚀 Speed Navigation:
Learn the Tab cycle: Log → Words → Attributes → Counts → repeat
Use Home/End for quick time-based navigation
Master Space for pause/unpause during investigation
🎯 Context Switching:
Click panels for instant focus switching
Use mouse wheel + keyboard combo for best of both worlds
Remember ESC always gets you out of modals
🔍 Search Strategy:
Start broad with Word Frequency filtering
Narrow down with regex filters (/)
Use search (s) for highlighting without filtering
Combine with AI analysis (i) for insights
Customization Options
Update Interval Control
Adjust how often the interface refreshes:
Display Customization
Accessibility Features
Visual Indicators
Focus highlighting - Current panel has distinct border
Selection highlighting - Current item is clearly marked
Color coding - Severity levels use consistent colors
Progress indicators - Loading states and scroll positions
Alternative Navigation
Mouse support - Full click navigation for users who prefer pointing
Arrow key alternatives - Both hjkl (vim) and arrow keys work
Multiple ways to same action - keyboard shortcuts + mouse + menu options
Troubleshooting Navigation Issues
Terminal Size Issues
Key Conflicts
Performance Issues
Complete Shortcut Reference
Global Shortcuts
Tab / Shift+Tab
Navigate panels
Always
Space
Pause/unpause dashboard
Always
q / Ctrl+C
Quit
Always
/
Filter mode
Always
s
Search and highlight
Always
r
Reset data
Always
u / U
Cycle update intervals
Always
c
Toggle Host/Service columns
Always
m
Switch AI model
Always
? / h
Show help
Always
Panel Navigation
↑/↓ or k/j
Move up/down
Any list
Page Up/Down
Jump by pages
Any list
Home / End
Jump to top/bottom
Any list
Enter
Select/details
Selected item
Mouse Click
Focus/select
Any panel
Mouse Wheel
Scroll
Focused panel
Modal Controls
ESC
Close modal
Any modal
Tab
Switch modal sections
Multi-section modals
i
AI analysis
Log details
c
AI chat
Log details
Advanced Features
n / N
Next/previous search match
Search mode
Ctrl+C
Clear filter
Filter active
Master these navigation techniques and you'll analyze logs with incredible efficiency! 🚀 The key is building muscle memory for the Tab cycle and essential shortcuts like Space for pause/unpause.
Last updated