[DOCS] /doctor docs omit interactive fix shortcut and status indicators

Resolved 💬 3 comments Opened Apr 13, 2026 by coygeek Closed Jun 23, 2026

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/troubleshooting

Section/Topic

/doctor command guidance in troubleshooting and related command references

Current Documentation

The docs currently describe /doctor as a diagnostic command, but not as an interactive fix flow:

/doctor | Diagnose and verify your Claude Code installation and settings

And the troubleshooting page says:

Run /doctor to diagnose issues. It checks: Installation type, version, and search functionality Auto-update status and available versions Invalid settings files (malformed JSON, incorrect types) MCP server configuration errors Keybinding configuration problems Context usage warnings (large CLAUDE.md files, high MCP token usage, unreachable permission rules) * Plugin and agent loading errors

I could not find any code.claude.com page that explains the /doctor status-icon layout or that users can press f to have Claude fix reported issues.

What's Wrong or Missing?

The v2.1.105 release entry says /doctor was improved with status icons and that users can press f to have Claude fix reported issues.

That is a user-facing behavior change, but the docs still describe /doctor only as a passive diagnostic command. Users are not told that /doctor now has an interactive remediation path or how to discover and use it.

As a result, someone who runs /doctor from the setup or troubleshooting docs may not realize that reported issues can be fixed directly from the command UI.

Suggested Improvement

Update the /doctor documentation to describe the new interactive workflow introduced in v2.1.105.

Minimum fix:

  • In troubleshooting, add a short subsection explaining that /doctor shows status icons for reported checks
  • Document that users can press f to have Claude attempt to fix supported issues directly from /doctor
  • In commands and other overview pages, expand the /doctor description from diagnosis-only wording to diagnosis plus guided fixes

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/troubleshooting | Primary explanation of what /doctor checks |
| https://code.claude.com/docs/en/commands | Slash command reference lists /doctor |
| https://code.claude.com/docs/en/setup | Installation guide tells users to run claude doctor |
| https://code.claude.com/docs/en/how-claude-code-works | Introductory help section describes /doctor as a diagnostic tool |
| https://code.claude.com/docs/en/keybindings | Keybinding docs send users to /doctor for warnings |
| https://code.claude.com/docs/en/claude-directory | Command inventory lists /doctor under diagnostics |

Total scope: 6 pages affected

Source: Changelog v2.1.105

Exact changelog entry: Improved /doctor layout with status icons; press f to have Claude fix reported issues

View original on GitHub ↗

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