cx-zjtn.5: Ctrl+Cmd+E focuses the workspace sidebar in classic

Merged
TE
1mo ago
+369-2

Summary

Classic had no way to reach the workspace sidebar from the keyboard. Ctrl+Cmd+E (Focus Sidebar, matching cmux-next) now reveals the left sidebar if it's hidden and gives its workspace list the keyboard. Down/Up select the next/previous workspace while the list keeps focus, and Return or Escape go back to the selected workspace's terminal. Other keys, and arrows with modifiers, still go to AppKit.

The list never accepted row selection, so the arrows reuse Next/Previous Workspace (TabManager.selectNextTab / selectPreviousTab), and Return reuses the focus restore the hidden-sidebar path already uses. A workspace switch restores its panel's focus, so the list takes focus back after each step.

The shortcut is rebindable in Settings and via shortcuts.bindings.focusSidebar, and it's listed on the keyboard-shortcuts docs page and in the schema. The label is translated in all 19 catalog locales.

Part of cx-zjtn.5 (keyboard-only cmux).

Testing

  • tests_v2/test_focus_sidebar_keyboard.py (committed first at 1320b036454f): Ctrl+Cmd+E, then Down, Up, Up, Return, reading the selected workspace from workspace.list and terminal focus from debug.terminal.is_focused. It needs a key window, so it runs on a whole capture mini, not a shared slot.
    • Red on main-based fleet build a8890865: RESULT 2/7 (the two passes are the starting state and Return on an already-focused terminal).
    • Green: RESULT 7/7 on fleet build 808d0688 (head da5b7c99), whole capture mini with the app key. The first green attempt scored 3/7 because focus key repair pulled Down back into the terminal; the head now exempts the focused workspace list from that repair.
  • python3 scripts/verify-local.py: 17/17.

Changelog

Added: Ctrl+Cmd+E focuses the workspace sidebar; arrow keys switch workspaces and Return or Esc goes back to the terminal

Proof

Keyboard focus change; the socket test above is the proof.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features
    • Added a “Focus Sidebar” keyboard shortcut, set by default to Control–Command–E, to move keyboard focus to the workspace sidebar.
    • While the sidebar has focus, use Up and Down to switch workspaces. Press Return or Escape to return focus to the selected workspace’s terminal.
  • Documentation
    • Updated the shortcut reference with the new action and its keyboard controls.