[DOCS] Interactive mode and output styles docs still present `/output-style` as standard command after deprecation
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-styleto 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-styleas deprecated (or remove from primary command table) - Point users to
/configfor 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-stylecommand — use/configinstead. Output style is now fixed at session start for better prompt caching
5 Comments
wait why was it deprecated it's a feature i use
output-style was one of the most useful features of Claude and it needs to be reinstated! /config isn't a sufficient alternative for this.
Issue #33317 Verification
Title: [DOCS] Interactive mode and output styles docs still present
/output-styleas standard command after deprecationIssue Date: 2026-03-11
Verification Date: 2026-03-16
Status: RESOLVED
---
Issue Summary
This issue reports that three documentation pages — Interactive mode, Output styles, and Settings — still present
/output-styleas the primary/standard workflow for changing output style, even though changelog v2.1.73 deprecated the command in favor of/config. The reporter further notes that the docs fail to explain that output style is fixed at session start (for prompt-caching consistency) and provide no migration guidance for users or scripts that previously invoked/output-style.---
Verification Results
Claim 1: Interactive mode page still lists
/output-style [style]in the built-in command tableStatus: RESOLVED
The current Interactive mode page at https://code.claude.com/docs/en/interactive-mode contains no built-in command table at all. The page was restructured: it now covers keyboard shortcuts, vim mode, command history, background tasks,
/btw, the task list, and PR review status. Built-in commands are fully delegated to the separate Commands reference page. At https://code.claude.com/docs/en/commands, the complete command table (lines 16–79) lists/configas the entry for output style configuration (line 24: "Open the Settings interface to adjust theme, model, output style, and other preferences. Alias:/settings"). There is no/output-styleentry anywhere in the table.Verdict: The
/output-stylecommand has been removed from the Interactive mode page, and the Commands reference page does not list it.---
Claim 2: Output styles page still instructs users to run
/output-styledirectly as the primary workflowStatus: RESOLVED
The current Output styles page at https://code.claude.com/docs/en/output-styles, in the "Change your output style" section (lines 44–47), now reads:
There is no mention of
/output-styleanywhere on this page. The/configcommand is the sole documented workflow.Verdict: The primary workflow has been updated to
/config;/output-styleis not referenced on this page.---
Claim 3: Docs do not explain that output style is fixed at session start
Status: RESOLVED
The Output styles page (lines 58–61) now explicitly states:
Verdict: Session-start immutability and the prompt-caching rationale are both documented.
---
Claim 4: No migration guidance for users previously invoking
/output-styleStatus: RESOLVED
The changelog entry for v2.1.73 at https://code.claude.com/docs/en/changelog (line 118) reads:
The Commands reference page directs all output-style configuration through
/config. The output-styles page documents the direct JSON alternative (outputStylefield in settings files) for scripted or non-interactive use cases. Together these provide sufficient migration context. A dedicated migration callout is not present, but the canonical path is unambiguous.Verdict: The deprecation notice is in the changelog; the Commands and Output styles pages present
/configas the sole method with no residual/output-stylereferences.---
Current State
| Claim | Status |
|-------|--------|
| Interactive mode page lists
/output-style [style]in command table | RESOLVED || Output styles page instructs users to run
/output-styledirectly | RESOLVED || Docs do not explain session-start immutability | RESOLVED |
| No migration guidance from
/output-styleto/config| RESOLVED |---
Suggested Fix
N/A - issue has been resolved.
---
References
/output-stylepresent/configlisted as the command for output style selection;/output-styleabsent from full table/configand select Output style to pick a style from a menu"/output-stylecommand — use/configinstead. Output style is now fixed at session start for better prompt caching"---
Conclusion & Recommendation
Primary Concern: The Interactive mode and Output styles documentation still presented
/output-styleas the primary command for changing output styles after v2.1.73 deprecated it in favor of/config.Resolution Status: RESOLVED
Recommendation: CLOSE
All three pages cited in the issue have been updated: the interactive-mode command table no longer exists in that form (commands moved to a dedicated reference page with no
/output-styleentry), the output-styles page now instructs users to use/config, and the session-start immutability rationale is explicitly documented. The deprecation changelog entry is present in v2.1.73.---
fuck ai bro
This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.