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

[coygeek]

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

[Leclowndu93150]

wait why was it deprecated it's a feature i use

[xmcbx]

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.

[coygeek]

Issue #33317 Verification

Title: [DOCS] Interactive mode and output styles docs still present /output-style as standard command after deprecation
Issue 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-style as 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 table

Status: 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 /config as 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-style entry anywhere in the table.

Verdict: The /output-style command 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-style directly as the primary workflow

Status: 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:

Run /config and select Output style to pick a style from a menu. Your selection is saved to .claude/settings.local.json at the local project level.

There is no mention of /output-style anywhere on this page. The /config command is the sole documented workflow.

Verdict: The primary workflow has been updated to /config; /output-style is 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:

Because the output style is set in the system prompt at session start, changes take effect the next time you start a new session. This keeps the system prompt stable throughout a conversation so prompt caching can reduce latency and cost.

Verdict: Session-start immutability and the prompt-caching rationale are both documented.

---

Claim 4: No migration guidance for users previously invoking /output-style

Status: RESOLVED

The changelog entry for v2.1.73 at https://code.claude.com/docs/en/changelog (line 118) reads:

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

The Commands reference page directs all output-style configuration through /config. The output-styles page documents the direct JSON alternative (outputStyle field 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 /config as the sole method with no residual /output-style references.

---

Current State

Claim	Status
Interactive mode page lists /output-style [style] in command table	RESOLVED
Output styles page instructs users to run /output-style directly	RESOLVED
Docs do not explain session-start immutability	RESOLVED
No migration guidance from /output-style to /config	RESOLVED

---

Suggested Fix

N/A - issue has been resolved.

---

References

• URL: https://code.claude.com/docs/en/interactive-mode
  • Current page: no built-in command table; defers to commands reference; no /output-style present
• URL: https://code.claude.com/docs/en/commands
  • Line 24: /config listed as the command for output style selection; /output-style absent from full table
• URL: https://code.claude.com/docs/en/output-styles
  • Lines 44–47: "Run /config and select Output style to pick a style from a menu"
  • Lines 58–61: session-start immutability explicitly documented
• URL: https://code.claude.com/docs/en/changelog
  • Line 118 (v2.1.73 entry): "Deprecated /output-style command — use /config instead. 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-style as 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-style entry), 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.

---

[Leclowndu93150]

fuck ai bro

[github-actions]

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.