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

Status Fixed / completed
Maintainer reply None cached
Activity 5 comments · opened Mar 11, 2026 · 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 ↗

5 Comments

Leclowndu93150 · 7 months ago

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

xmcbx · 7 months ago

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 · 7 months ago

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

---

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 · 7 months ago

fuck ai bro

github-actions[bot] · 6 months ago

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.