Keyboard Shortcuts

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/coollabsio/jean/llms.txt

Use this file to discover all available pages before exploring further.

​

Overview

​

Notation

• Cmd on macOS = Ctrl on Windows/Linux
• Opt on macOS = Alt on Windows/Linux
• Shift, Enter, Backspace are platform-independent

​

Default Keybindings

​

Navigation

​

Chat

​

Git

​

Customizing Shortcuts

​

Via Preferences

1. Open Preferences (Cmd+,)
2. Navigate to Keyboard Shortcuts tab
3. Find action to customize
4. Click on current shortcut
5. Press new key combination
6. Save changes

​

Shortcut Format

mod+shift+key

• mod - Cmd (macOS) or Ctrl (Windows/Linux)
• shift - Shift key
• alt - Alt (Windows/Linux) or Option (macOS)
• key - Letter, number, or special key

• mod+l - Cmd+L / Ctrl+L
• mod+shift+c - Cmd+Shift+C / Ctrl+Shift+C
• mod+alt+backspace - Cmd+Opt+Backspace / Ctrl+Alt+Backspace

​

Special Keys

comma      // ,
period     // .
slash      // /
backquote  // `
arrow up   // ↑
arrowdown  // ↓
arrowleft  // ←
arrowright // →
backspace  // Backspace/Delete
enter      // Enter/Return
tab        // Tab
escape     // Esc

​

Conflicts

• Another Jean action
• System shortcuts (Cmd+Q, Cmd+W, etc.)
• Browser shortcuts (if running in web mode)

​

Context-Specific Shortcuts

​

Canvas Views Only

• / - Focus search (only on canvas, not in chat)
• P - Open plan (only when session card selected)
• R - Open recap (only when session card selected)

​

Chat View Only

• Cmd+L - Focus input (only in chat window)
• Cmd+Enter - Approve plan (only when plan visible)
• Shift+Tab - Cycle mode (only in chat input)

​

Terminal Panel

• Cmd+` - Toggle terminal (works from anywhere)
• Standard terminal shortcuts when focused (Cmd+C, Cmd+V, etc.)

​

Shortcut Categories

​

Navigation (10 shortcuts)

• Sidebar, preferences, open in, worktree creation, canvas search, etc.

​

Chat (18 shortcuts)

• Focus input, sessions, execution modes, plan approval, model selection, etc.

​

Git (4 shortcuts)

• Commit, diff, magic commands, run script

​

Disabled Shortcuts

1. Preferences > Keyboard Shortcuts
2. Find action
3. Click shortcut field
4. Press Backspace to clear
5. Save

​

Platform Differences

​

macOS

• Cmd = Command (⌘)
• Opt = Option (⌥)
• Shift = Shift (⇧)
• Dead keys (Opt+E, Opt+M) avoided by using Cmd+Shift instead

​

Windows

• Ctrl = Control
• Alt = Alt
• Shift = Shift
• Terminal shortcuts: Cmd+ becomes Ctrl+

​

Linux

• Ctrl = Control
• Alt = Alt
• Shift = Shift
• May conflict with desktop environment shortcuts (varies by distro)

​

Resetting Shortcuts

​

Reset All

1. Preferences > Keyboard Shortcuts
2. Click Reset All to Defaults button
3. Confirm reset

​

Reset Single Shortcut

1. Preferences > Keyboard Shortcuts
2. Find action
3. Click Reset icon next to shortcut
4. Shortcut restored to default

​

Shortcut Migration

• If you had default Cmd+1, auto-updates to Cmd+B
• If you customized to Cmd+X, keeps Cmd+X

​

Shortcut Storage

{
  "keybindings": {
    "focus_chat_input": "mod+l",
    "toggle_left_sidebar": "mod+b",
    "open_preferences": "mod+comma",
    ...
  }
}

​

Complete Keybindings Reference

​

Full List (37 shortcuts)

export const DEFAULT_KEYBINDINGS: KeybindingsMap = {
  focus_chat_input: 'mod+l',
  toggle_left_sidebar: 'mod+b',
  open_preferences: 'mod+comma',
  open_commit_modal: 'mod+shift+c',
  open_git_diff: 'mod+g',
  execute_run: 'mod+r',
  open_in_modal: 'mod+o',
  open_magic_modal: 'mod+m',
  new_session: 'mod+t',
  next_session: 'mod+alt+arrowright',
  previous_session: 'mod+alt+arrowleft',
  close_session_or_worktree: 'mod+w',
  new_worktree: 'mod+n',
  cycle_execution_mode: 'shift+tab',
  approve_plan: 'mod+enter',
  approve_plan_yolo: 'mod+y',
  approve_plan_clear_context: 'mod+shift+y',
  approve_plan_clear_context_build: 'mod+shift+enter',
  open_plan: 'p',
  open_recap: 'r',
  restore_last_archived: 'mod+shift+t',
  focus_canvas_search: 'slash',
  toggle_terminal: 'mod+backquote',
  toggle_session_label: 'mod+s',
  open_provider_dropdown: 'mod+shift+p',
  open_model_dropdown: 'mod+shift+m',
  open_thinking_dropdown: 'mod+shift+e',
  open_unread_sessions: 'mod+shift+f',
  cancel_prompt: 'mod+alt+backspace',
  scroll_chat_up: 'mod+arrowup',
  scroll_chat_down: 'mod+arrowdown',
  open_github_dashboard: 'mod+shift+d',
  open_quick_menu: 'mod+period',
}

​

Accessibility

1. Preferences > Appearance
2. Enable Show Keybinding Hints
3. Shortcuts displayed at bottom of canvas views

1. Customize any shortcut to avoid conflicts
2. Use one-handed shortcuts (avoid multi-key combos)
3. Map to number pad keys if available

​

Tips

• Learn incrementally: Master 5-10 shortcuts first, add more over time
• Print cheat sheet: Screenshot this page, keep visible while learning
• Use hints: Enable keybinding hints in Preferences
• Muscle memory: Practice shortcuts daily for 1-2 weeks
• Customize for you: Change shortcuts to match your mental model

​

Troubleshooting

​

Shortcut Not Working

1. Check focus: Some shortcuts require specific focus (e.g., chat input)
2. Verify enabled: Check Preferences > Keyboard Shortcuts
3. Check conflicts: Look for system/browser conflicts
4. Restart Jean: Reload keybindings

​

Wrong Action Triggered

1. Check for duplicates: Multiple actions with same shortcut
2. Reset to defaults: Preferences > Reset All
3. Manually review: Check preferences.json for conflicts

​

Platform-Specific Issues

• Solution: Use Cmd+Shift+E, Cmd+Shift+M instead

• Solution: Customize toggle_terminal shortcut

• Solution: Customize prev/next session shortcuts