Documentation

Keyboard Shortcuts

Muxy is designed for keyboard-first context switching between running workspaces and captured windows.

Default Shortcuts

Shortcut	Action	Scope
cmd+shift+=	Toggle/focus Muxy window	Global
cmd+shift+]	Next workspace (or next window for active workspace)	Global + App
cmd+shift+[	Previous workspace (or previous window for active workspace)	Global + App
cmd+shift+return	Focus selected workspace and first window	App
cmd+shift+e	Open editor for workspace owning focused window	Global
cmd+shift+t	Open selected workspace terminal	App
cmd+shift+f	Open selected workspace in Finder	App
cmd+1 ... cmd+9	Focus workspace window by index	App

Workspace vs Window Navigation

• In-app next/previous cycles only running workspaces.
• Focusing a workspace sets it as the target for global window cycling.
• When Muxy is not focused, next/previous cycles windows for the active or focused workspace.
• Browser window disambiguation uses active tab URL matching in addition to window ID.

Customization

Keyboard bindings can be overridden in the Settings view and through CLI settings commands.

mx settings get --gui-hotkey
mx settings set --gui-hotkey cmd+shift+9
mx settings set --gui-next-shortcut cmd+shift+]
mx settings set --gui-prev-shortcut cmd+shift+[
mx settings reset --gui-hotkey

Text Input Safety

When a text field is focused, Muxy does not intercept standard text-edit shortcuts such as copy, cut, paste, undo, redo, and select-all.

Screenshot Placeholder

Settings Shortcuts Panel

Shortcut capture buttons and reset actions in the Settings view.

Screenshot Placeholder

Workspace Inline Shortcut Hints

Run tab showing action labels and dynamic `cmd+<n>` window hints.