[DOCS] Interactive mode and output styles docs still present `/output-style` as standard command after deprecation

Resolved 💬 5 comments Opened Mar 11, 2026 by coygeek Closed Mar 16, 2026

Documentation Type

Incorrect/outdated documentation

Documentation Location

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

Section/Topic

Built-in command reference and output style workflow after /output-style deprecation.

Current Documentation

The interactive command table currently states:

| /output-style [style] | Switch between output styles ... |

And Output styles currently instructs:

Run /output-style to access a menu and select your output style Run /output-style [style], such as /output-style explanatory, to directly switch to a style

What's Wrong or Missing?

Changelog v2.1.73 says /output-style is deprecated in favor of /config, and output style is fixed at session start for prompt-caching consistency.

Current docs still present /output-style as the primary/normal workflow and do not explain session-start immutability, which can cause users to expect mid-session switching that no longer applies.

Suggested Improvement

Update Interactive mode and Output styles docs to:

  • Mark /output-style as deprecated (or remove from primary command table)
  • Point users to /config for selecting output style
  • Explicitly document that output style is fixed at session start and when the new style takes effect
  • Add migration guidance for users/scripts that previously invoked /output-style

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/interactive-mode | Built-in command table still lists /output-style [style] as an active command |
| https://code.claude.com/docs/en/output-styles | Primary workflow still instructs users to run /output-style directly |
| https://code.claude.com/docs/en/settings | /config-driven settings flow should be the canonical place for output-style selection |

Total scope: 3 pages affected

Source: Changelog v2.1.73

Exact changelog entry:

Deprecated /output-style command — use /config instead. Output style is now fixed at session start for better prompt caching

View original on GitHub ↗

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