Keyboard Shortcuts¶
Quick reference. Everything listed here is verified against the v2.5 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 and Discord. There is no setting to swap them.
Code editor¶
| Shortcut | Action |
|---|---|
| Ctrl+S | Save the project (all open files) |
| 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, the same action as F5 (Run → Run App) |
| F3 | Open the Build Executable dialog |
| Esc | Cancel current action / close search |
Theme¶
Theme switching is menu-only: View → Switch to Dark / Light Theme. No keyboard shortcut is assigned.
Panel layout¶
Panel sizing is drag-only (splitter handles between Projects / Chat / Preview). There are no toggle-panel shortcuts in v2.5. 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.5 — they're hardcoded. User-editable shortcuts are planned for a later release. 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, and where the rest of the controls live
- Multi-file Projects — shortcuts matter more in multi-file workflows