[DOCS] Interactive mode and keybindings docs show outdated `Ctrl+L` behavior

Resolved 💬 2 comments Opened Apr 16, 2026 by coygeek Closed May 2, 2026

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 modeGeneral 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+L now clears the screen and forces a full redraw — use this to recover when Cmd+K leaves the UI partially blank. Use Ctrl+U or 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+L row 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+U or double-Esc for clearing prompt input.
  • In Customize keyboard shortcuts, clarify how the default Ctrl+L behavior relates to app:redraw and chat:clearInput so 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+L now clears the screen and forces a full redraw — use this to recover when Cmd+K leaves the UI partially blank. Use Ctrl+U or double-Esc to clear prompt input.

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗