[DOCS] Interactive mode and keybindings docs show outdated `Ctrl+L` behavior
Documentation Type
Incorrect/outdated documentation
Documentation Location
https://code.claude.com/docs/en/interactive-mode
Section/Topic
Ctrl+L in the "Keyboard shortcuts" / "General controls" table, plus the default shortcut mappings on the keybindings page
Current Documentation
The docs currently say:
In Interactive mode → General controls: | Ctrl+L | Clear prompt input | Clears typed text, keeps conversation history |
In Customize keyboard shortcuts: |app:redraw| (unbound) | Force terminal redraw | |chat:clearInput| Ctrl+L | Clear prompt input |
What's Wrong or Missing?
Changelog v2.1.111 says:
Ctrl+Lnow clears the screen and forces a full redraw — use this to recover when Cmd+K leaves the UI partially blank. UseCtrl+Uor double-Esc to clear prompt input.
The current docs still describe Ctrl+L as a prompt-clearing shortcut and show redraw as unbound.
A. Interactive mode documents the old behavior
Users reading the keyboard shortcut table are told that Ctrl+L clears typed text, but the release notes say the shortcut now exists to clear the screen and force a redraw.
B. Keybindings does not reflect the shipped default behavior
The keybindings reference still shows app:redraw as unbound and chat:clearInput on Ctrl+L, so it does not explain the current default shortcut behavior or point users to Ctrl+U / double-Esc for clearing prompt input.
Suggested Improvement
Update both pages to match the v2.1.111 behavior:
- In Interactive mode, change the
Ctrl+Lrow to describe clearing the screen and forcing a full redraw, including the recovery use case for partially blank UI. - In the same shortcut docs, point users to
Ctrl+Uor double-Esc for clearing prompt input. - In Customize keyboard shortcuts, clarify how the default
Ctrl+Lbehavior relates toapp:redrawandchat:clearInputso custom keybinding users know which action is actually bound by default.
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/interactive-mode | 31 | Ctrl+L is documented as "Clear prompt input" |
| https://code.claude.com/docs/en/keybindings | 84, 105 | app:redraw is shown as unbound while chat:clearInput is bound to Ctrl+L |
Total scope: 2 pages affected
Source: Changelog v2.1.111
Changelog entry:
Ctrl+Lnow clears the screen and forces a full redraw — use this to recover when Cmd+K leaves the UI partially blank. UseCtrl+Uor double-Esc to clear prompt input.
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗