[DOCS] Shell mode docs omit live file path autocomplete for `!` commands

Open 💬 0 comments Opened Jun 25, 2026 by coygeek

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/interactive-mode

Section/Topic

Shell mode with ! prefix.

Current Documentation

The interactive mode page explains regular file mentions separately:

@ | File path mention | Trigger file path autocomplete

The Shell mode section currently says:

Supports history-based autocomplete: type a partial command and press Tab to complete from previous ! commands in the current project

What's Wrong or Missing?

Claude Code v2.1.193 added live file path autocomplete to bash mode (!), but the Shell mode docs still only mention history-based autocomplete from previous ! commands.

Users reading the page cannot tell:

  • that file path completion now works while composing a ! shell command
  • whether it uses the same autocomplete keybindings as other menus
  • how it differs from @ file mentions in normal prompts
  • whether path completions are rooted in the current working directory and additional directories

Suggested Improvement

Update the Shell mode bullet list to include live file path autocomplete.

Suggested minimum addition:

Supports live file path autocomplete while composing ! commands, in addition to history-based command completion. Use the autocomplete keybindings to navigate and accept path suggestions.

Also consider adding a short example such as:

! cat src/

with a note that path suggestions appear before the command is submitted.

Impact

Low - Minor confusion or inconvenience

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/interactive-mode | Shell mode section mentions history autocomplete but not file path autocomplete |
| https://code.claude.com/docs/en/keybindings | Autocomplete actions are documented generically, but not connected to Shell mode path completion |
| https://code.claude.com/docs/en/tools-reference | PowerShell routing for interactive ! commands is documented, but path autocomplete behavior is not |

Total scope: 3 pages affected

Version context: Claude Code v2.1.193 release note: "Added live file path autocomplete to bash mode (!)."

View original on GitHub ↗