Skip to content

Window Mode

Jump to bottom
Alejandro Quintanar edited this page Nov 30, 2025 · 1 revision

Window Mode

Window Mode provides full keyboard control over window management, inspired by vim-style navigation.

Entering and Exiting

Key Action
` (backtick) Toggle Window Mode
F8 Toggle Window Mode
ESC Exit Window Mode

Tip: Double-press ` quickly to send a literal backtick to the terminal instead of entering Window Mode.

Visual Indicator

When Window Mode is active, you'll see an indicator in the top bar showing the current mode:

  • [WIN] - Normal Window Mode
  • [MOVE] - Move Mode active
  • [SIZE] - Resize Mode active

Navigation

Move focus between windows using vim-style or arrow keys:

Key Action
h / Left Focus window to the left
j / Down Focus window below
k / Up Focus window above
l / Right Focus window to the right
Tab Cycle to next window
Shift+Tab Cycle to previous window

Snap Positions

Half-Screen Snap

Use Shift + direction to snap windows to half the screen:

Key Position
H (Shift+h) Left half
J (Shift+j) Bottom half
K (Shift+k) Top half
L (Shift+l) Right half

Numpad-Style Positions (1-9)

Snap windows to any of 9 positions using number keys:

┌─────────┬─────────┬─────────┐
│    7    │    8    │    9    │
│Top-Left │Top-Ctr  │Top-Right│
├─────────┼─────────┼─────────┤
│    4    │    5    │    6    │
│Mid-Left │ Center  │Mid-Right│
├─────────┼─────────┼─────────┤
│    1    │    2    │    3    │
│Bot-Left │Bot-Ctr  │Bot-Right│
└─────────┴─────────┴─────────┘

Window Actions

Key Action
m Enter Move mode
r Enter Resize mode
z / + / Space Toggle maximize
- / _ Toggle minimize
x / q Close focused window
? Show help overlay

Move Mode

Press m to enter Move mode for precise window positioning.

Controls

Key Action
h / Left Move window left
j / Down Move window down
k / Up Move window up
l / Right Move window right

Modifiers

Modifier Effect
Hold key Adaptive acceleration (faster with continuous press)
Shift + direction Snap to screen edge

Exit Move Mode

Key Action
Enter Confirm position and exit
Esc Cancel and exit
m Exit Move mode

Resize Mode

Press r to enter Resize mode for precise window sizing.

Controls

Key Action
h Shrink width (from right edge)
l Grow width (from right edge)
k Shrink height (from bottom edge)
j Grow height (from bottom edge)

Modifiers

Modifier Effect
Shift + key Resize from opposite edge

Exit Resize Mode

Key Action
Enter Confirm size and exit
Esc Cancel and exit
r Exit Resize mode

Workflow Examples

Example 1: Tile Two Windows Side by Side

  1. Press ` to enter Window Mode
  2. Focus first window, press H to snap left
  3. Press Tab to focus second window
  4. Press L to snap right
  5. Press ` to exit Window Mode

Example 2: Move Window to Corner

  1. Press ` to enter Window Mode
  2. Press 7 to snap to top-left corner
  3. Press ` to exit Window Mode

Example 3: Custom Position and Size

  1. Press ` to enter Window Mode
  2. Press m to enter Move mode
  3. Use h/j/k/l to position window
  4. Press Enter to confirm
  5. Press r to enter Resize mode
  6. Use h/j/k/l to adjust size
  7. Press Enter to confirm
  8. Press ` to exit Window Mode

See Also

Clone this wiki locally