Keyboard Shortcuts¶
Quick reference. Everything listed here is verified against the v2.4 codebase. If you find a shortcut that looks like it should work and doesn't, it's not implemented yet — please report it.
Global¶
| Shortcut | Action |
|---|---|
| Ctrl+N | New project |
| Ctrl+, | Open Preferences |
| Ctrl+Shift+F | Multi-file search across the project |
| Alt+F4 | Quit Whittl |
Chat panel¶
| Shortcut | Action |
|---|---|
| Enter | Send the prompt |
| Shift+Enter | New line (for multi-line prompts) |
| Ctrl+Enter | Also sends the prompt (alternative to plain Enter) |
| Up | Previous prompt from history (when cursor is on the first line) |
| Down | Next prompt from history (when cursor is on the last line) |
Send-on-Enter
Plain Enter sends, Shift+Enter inserts a newline. This matches Slack / Discord. If you'd rather have Enter insert a newline and only Ctrl+Enter send, that toggle is planned but not yet in Preferences.
Code editor¶
| Shortcut | Action |
|---|---|
| Ctrl+S | Save current file |
| Ctrl+Z | Undo |
| Ctrl+Y | Redo |
| Ctrl+F | Find in current file |
| Ctrl+H | Find + replace in current file |
| Ctrl+G | Go to line number |
| Ctrl+/ | Toggle line comment (single line or selection) |
| Ctrl+D | Duplicate current line(s) |
| Alt+Up / Alt+Down | Move current line up / down |
| Ctrl+Space | Trigger autocomplete (Jedi — Python identifiers in scope) |
| Ctrl+Shift+[ | Fold all code blocks |
| Ctrl+Shift+] | Unfold all code blocks |
AI-assisted editor actions¶
These are context menu actions on selected code rather than keyboard shortcuts. See Explain Mode & Inline AI Help for full details.
| Action | How to trigger |
|---|---|
| Toggle whole-file Explain Mode | Explain button in the editor toolbar |
| Explain a specific block | Select → right-click → Explain Selection |
| Fix a specific block with AI | Select → right-click → Fix Selection with AI |
Run and test¶
| Shortcut | Action |
|---|---|
| F5 | Test Run the project |
| Ctrl+B | Test Run (alternative to F5) |
| F3 | Open the Build Executable dialog |
| Esc | Cancel current action / close search |
Theme¶
Theme switching is menu-only: View menu → Switch to Dark / Light Theme. No keyboard shortcut is assigned — a planned addition for a future version.
Panel layout¶
Panel sizing is drag-only (splitter handles between Projects / Chat / Preview). There are no toggle-panel shortcuts in v2.4. If you need more editor space, drag the Projects panel handle left or the Chat panel handle right.
Customizing¶
Shortcuts aren't user-customizable in v2.4 — they're hardcoded. User-editable shortcuts are planned for v2.5+. If a default collides with an OS-level shortcut on your system, report the conflict via Reporting Bugs and we'll adjust the default.
What's next¶
- Settings — every toggle in Preferences
- Multi-file Projects — shortcuts matter more in multi-file workflows