[DOCS] Slash command docs omit mid-input autocomplete behavior

Open 💬 4 comments Opened May 8, 2026 by coygeek

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/commands

Section/Topic

Slash command discovery and autocomplete behavior in interactive input

Current Documentation

The docs currently say:

Type / to see every command available to you, or type / followed by letters to filter. A command is only recognized at the start of your message. Text that follows the command name is passed to it as arguments.

The interactive mode page also says:

| / at start | Command or skill | See [commands](#commands) and skills |

What's Wrong or Missing?

These pages currently frame slash commands as a start-of-message interaction and do not explain the current autocomplete behavior when / is typed later in the input.

That wording conflates two different things:

A. Command execution

/command execution still needs clear start-of-message rules.

B. Command autocomplete and discovery

The docs do not say that the slash-command autocomplete UI can appear when / is typed mid-input, so users reading the reference can reasonably conclude that later-in-prompt slash autocomplete is unsupported or broken.

Suggested Improvement

Add a short clarification to the commands and interactive mode docs that separates command execution from autocomplete behavior.

Before:

A command is only recognized at the start of your message.

After:

Claude executes a slash command only when it starts the message, but the slash-command autocomplete menu can appear anywhere in the input when you type /, so you can discover or insert a command while editing a longer prompt.

Also update the interactive mode quick-commands table so the / row does not imply that slash-related discovery only works at prompt start.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/commands | 11-13 | Says / shows commands, then states commands are only recognized at the start of the message |
| https://code.claude.com/docs/en/interactive-mode | 83-86, 106 | Quick commands table labels / as "at start" and the commands section does not clarify mid-input autocomplete |

Cross-reference:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/changelog | 2262-2263 | Changelog already says slash command autocomplete works when / appears anywhere in input |

Total scope: 2 primary docs pages affected

Version context: This gap is relevant to the v2.1.136 slash-command autocomplete change under review because the reference pages still present slash discovery as start-of-message only.

View original on GitHub ↗

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