[DOCS] Prompt suggestions docs still say Enter accepts and submits suggestions
Documentation Type
Incorrect/outdated documentation
Documentation Location
https://code.claude.com/docs/en/interactive-mode
Section/Topic
"Prompt suggestions" section
Current Documentation
The docs currently say:
When you first open a session, a grayed-out example command appears in the prompt input to help you get started. Claude Code picks this from your project's git history, so it reflects files you've been working on recently. After Claude responds, suggestions continue to appear based on your conversation history, such as a follow-up step from a multi-part request or a natural continuation of your workflow. Press Tab or Right arrow to accept the suggestion, or press Enter to accept and submit Start typing to dismiss it
What's Wrong or Missing?
This appears to document pre-v2.1.136 behavior.
The v2.1.136 release entry says Claude Code fixed prompt suggestions being auto-submitted by Enter on an empty input and now requires Tab or arrow acceptance first. The current interactive-mode page still tells users that Enter accepts and submits a prompt suggestion directly.
That leaves the page out of date and can mislead users into expecting Enter to accept a suggestion when the current behavior requires explicit acceptance with Tab or an arrow key.
Suggested Improvement
Update the "Prompt suggestions" instructions so they match v2.1.136 behavior.
Before:
* Press Tab or Right arrow to accept the suggestion, or press Enter to accept and submit
After:
Press Tab or Right arrow to accept the suggestion Enter on an empty input should not auto-accept a prompt suggestion; accept it first, then submit normally if needed
If Enter has any remaining prompt-suggestion-specific behavior after acceptance, document that separately so the page is explicit about the distinction.
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/interactive-mode | 288-293 | Prompt suggestions still say Enter accepts and submits the suggestion |
Related context:
| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/keybindings | 121-130 | Autocomplete actions list autocomplete:accept as Tab, which already points toward explicit acceptance instead of Enter auto-submission |
Total scope: 1 page with outdated prompt-suggestion instructions
Relevant release context: v2.1.136
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗