Keyboard Shortcuts

Plexus supports comprehensive keyboard shortcuts for efficient navigation and control. The interface is designed with Vim-style keybindings, allowing power users to manage their AI agent sessions without touching the mouse.

Press ? at any time to see the keyboard shortcuts cheatsheet overlay.

Global Shortcuts

These shortcuts work anywhere in the application.

View Switching

Switch between different views using key sequences. Type both keys quickly (within 500ms).

How Key Sequences Work

Key sequences require typing two keys in quick succession:

1. Press the first key (e.g., v)
2. Within 500ms, press the second key (e.g., s)
3. The action triggers when the sequence is complete

Quick Jump to Recent Agents

Jump directly to your most recently active agent sessions. These shortcuts work in the Sessions view.

This feature allows you to quickly switch between your active AI agent terminals without navigating through the list.

Navigation (Vim-style)

Navigate through lists and panels using familiar Vim keybindings.

Navigation Tips

• Use j and k to quickly scroll through your session list
• gg and G are useful for jumping to the beginning or end of long lists
• Use H and L to switch between project groups

Session Management

Manage your AI agent sessions efficiently.

Agent Actions

Control your AI agents when they require attention.

Permission Requests

When an AI agent requests permission to perform an action (like file modifications or command execution), the session card will highlight. You can quickly respond:

1. Press j/k to navigate to the waiting session
2. Press y to approve or n to reject
3. The agent will continue or abort based on your response

History View Shortcuts

These shortcuts are available when viewing conversation history.

Quick Reference Card

For quick access, here are the most commonly used shortcuts:

Customizing Shortcuts

Currently, keyboard shortcuts cannot be customized. Custom keybinding support is planned for a future release.

Tips for Vim Users

If you're familiar with Vim, you'll feel right at home:

• jk navigation works as expected
• gg and G motions are supported (first/last)
• H and L switch between project groups
• Press Esc to exit any mode and return to normal navigation
• Key sequences like vs, vh, va follow the Vim-style "verb + noun" pattern

Accessibility

All keyboard shortcuts are designed to be accessible:

• Visual focus indicators show the currently selected item
• Screen readers announce the current selection
• Press ? to see all available shortcuts in an overlay

Troubleshooting

Shortcuts Not Working

1. Ensure the Plexus window is focused
2. Check that you're not in an input field (press Esc first)
3. For key sequences, make sure you type both keys within 500ms

Conflicts with System Shortcuts

If a Plexus shortcut conflicts with your system shortcuts:

1. The system shortcut takes precedence
2. Use alternative shortcuts if available
3. Future versions will allow remapping conflicting shortcuts