Keyboard Shortcuts

mux is designed to be keyboard-driven for maximum efficiency. All major actions have keyboard shortcuts.

Note: This document should be kept in sync with src/utils/ui/keybinds.ts, which is the source of truth for keybind definitions.

Platform Conventions

• macOS: Shortcuts use ⌘ (Command) as the primary modifier
• Linux/Windows: Shortcuts use Ctrl as the primary modifier

When documentation shows Ctrl, it means:

• ⌘ (Command) on macOS
• Ctrl on Linux/Windows

General

Chat & Messages

Workspaces

Modes

Interface

Command Palette

The command palette (Ctrl+Shift+P) has two modes:

• Default (no prefix): Workspace switcher - shows only switching commands
• > prefix: Command mode - shows all other commands (create/delete/rename workspaces, navigation, chat, modes, projects, etc.)
• / prefix: Slash commands - shows slash command suggestions for inserting into chat

This separation keeps the switcher clean and fast while making all other commands easily accessible via >.

Tips

• Vim-inspired navigation: We use J/K for next/previous navigation, similar to Vim
• VS Code conventions: Command palette is Ctrl+Shift+P and quick toggle is Ctrl+P (use ⌘ on macOS)
• Consistent modifiers: Most workspace/project operations use Ctrl as the modifier
• Natural expectations: We try to use shortcuts users would naturally expect (e.g., Ctrl+N for new)
• Focus anywhere: Use Ctrl+I to quickly jump to the chat input from anywhere in the application
• Per-model thinking: Ctrl+Shift+T toggles thinking on/off and remembers your last preference for each model
• Terminal access: Ctrl+T opens the current workspace in your system terminal