Skip to content

Documentation Error #13388

Description

@OldSubSailor

Pre-submit Checks

Describe the bug

Bug Report: Documentation Error - Command Suggestion Keyboard Shortcut

Summary:
Documentation incorrectly states Cmd+Return for accepting AI command suggestions on macOS; actual shortcut is Ctrl+Return.

Affected Documentation:

  • Agent Platform > Active AI Recommendations > Prompt Suggestions
  • States: "If you press CMD-ENTER (on macOS)..."

Actual Behavior (macOS):

  • AI command suggestion blocks display ^⏎ (Ctrl+Return)
  • Ctrl+Return accepts the suggestion
  • Cmd+Return does not work

Expected Fix:
Update documentation to reflect correct shortcut:

  • macOS: CTRL-ENTER (not CMD-ENTER)

Environment:

  • macOS (confirmed on user system)
  • Warp Terminal

Impact:
Low severity but causes user confusion when documentation contradicts UI indicators.

To reproduce

This report is submitted as per the AI and is a result of a discussion about the keystroke shortcut that appears when using the AI with Warp a command suggestion or AI command suggestion block.

Expected behavior

Have the Documentation as per the AI report that the proper shortcut is CTRL + RETURN (or ENTER)

Screenshots, videos, and logs

No response

Operating system (OS)

macOS

Operating system and version

15.7.7

Shell Version

zsh version 5.9.

Current Warp version

v0.2026.07.01.09.21.stable_01

Regression

No, this bug or issue has existed throughout my experience using Warp

Recent working Warp date

today

Additional context

As reported, this is evidently a Document Concern as per the Warp AI, Claude 4.5 Sonnet.

Does this block you from using Warp daily?

No

Is this an issue only in Warp?

Yes, I confirmed that this only happens in Warp, not other terminals.

Warp Internal (ignore): linear-label:b9d78064-c89e-4973-b153-5178a31ee54e

No response

Metadata

Metadata

Assignees

Labels

area:agentAgent workflows, conversations, prompts, cloud mode, and AI-specific UI.area:suggestionsAI-predictive suggestions, prompt predictions, next-command suggestions, and auto-suggest heuristicsdocumentationImprovements or additions to documentation.os:macmacOS-specific behavior, regressions, or requests.repro:highThe report includes enough evidence that the issue appears highly reproducible.triagedIssue has received an initial automated triage pass.warp:auto-triage-review

Type

No type

Fields

No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions