[DOCS] Ctrl+L keyboard shortcut docs still say it clears prompt input
Documentation Type
Incorrect/outdated documentation
Documentation Location
https://code.claude.com/docs/en/interactive-mode
Section/Topic
Keyboard shortcuts table, Ctrl+L row
Current Documentation
The interactive mode docs currently describe Ctrl+L as clearing typed input:
Ctrl+L | Clear prompt input and redraw screen | Clears typed text and forces a full terminal redraw. Conversation history is kept. Use this to recover if the display becomes garbled or partially blank
The keybindings reference also maps Ctrl+L to chat:clearInput:
chat:clearInput| Ctrl+L | Clear prompt input and force a full screen redraw. In fullscreen rendering, press twice within two seconds to run/clear
The fullscreen page repeats the old first-press behavior:
PressCtrl+Ltwice within two seconds to run/clearand start a new conversation. The first press clears the input box and shows a hint; the second press clears the conversation.
However, the v2.1.126 changelog says the behavior changed:
Fixed Ctrl+L clearing the prompt input - it now only forces a screen redraw, matching readline behavior
What's Wrong or Missing?
The Claude Code docs still document the pre-v2.1.126 behavior where pressing Ctrl+L clears prompt input. In v2.1.126, Ctrl+L was fixed to only force a screen redraw and no longer clear the prompt input.
This leaves the keyboard shortcut documentation internally inconsistent with the changelog and may cause users to expect prompt text loss when using the redraw shortcut.
Suggested Improvement
Update the affected Ctrl+L descriptions to match the v2.1.126 behavior.
For example, change the interactive mode row from:
Clear prompt input and redraw screen
to:
Redraw screen
And change the description from:
Clears typed text and forces a full terminal redraw.
to:
Forces a full terminal redraw without clearing typed text.
Also update the keybindings reference so Ctrl+L is no longer documented as chat:clearInput unless that action name remains correct internally for compatibility reasons. If the fullscreen double-press behavior still exists, clarify that the first press redraws the screen and shows the /clear hint without clearing the input box.
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 row says it clears prompt input and typed text |
| https://code.claude.com/docs/en/keybindings | 105 | chat:clearInput row maps Ctrl+L to clearing prompt input and forcing redraw |
| https://code.claude.com/docs/en/fullscreen | 121 | Double-press /clear docs say the first Ctrl+L press clears the input box |
| https://code.claude.com/docs/en/changelog | 36 | v2.1.126 changelog says Ctrl+L now only forces a screen redraw |
Total scope: 3 documentation pages appear outdated, with the changelog providing the current behavior reference.
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗