Skip to main content
Mux is designed to be keyboard-driven for maximum efficiency. All major actions have keyboard shortcuts.
This document should be kept in sync with src/browser/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+] / Ctrl+Shift+[ step thinking effort up/down (clamped at the model’s range) and remember your last preference for each model
  • Terminal access: Ctrl+T opens the current workspace in your system terminal