[DOCS] Code intelligence docs omit click-to-expand LSP diagnostic summaries

Open 💬 3 comments Opened Apr 28, 2026 by coygeek

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/discover-plugins

Section/Topic

What Claude gains from code intelligence pluginsAutomatic diagnostics

Current Documentation

The docs currently say:

* Automatic diagnostics: after every file edit Claude makes, the language server analyzes the changes and reports errors and warnings back automatically. Claude sees type errors, missing imports, and syntax issues without needing to run a compiler or linter. If Claude introduces an error, it notices and fixes the issue in the same turn. This requires no configuration beyond installing the plugin. You can see diagnostics inline by pressing Ctrl+O when the "diagnostics found" indicator appears.

The terminal shortcuts page also says:

| Ctrl+O | Toggle transcript viewer | Shows detailed tool usage and execution. Also expands MCP calls, which collapse to a single line like "Called slack 3 times" by default |

These pages mention automatic diagnostics and Ctrl+O, but they do not document the new click-to-expand behavior for LSP diagnostic summaries or the new expand hint in the UI.

What's Wrong or Missing?

Changelog v2.1.121 added a new interaction for inline LSP diagnostics:

LSP diagnostic summaries now expand on click/ctrl+o and show the expand hint

The current documentation tells users that diagnostics appear after edits and that Ctrl+O opens the transcript viewer, but it does not explain that diagnostic summaries themselves can now be expanded directly by clicking them, nor that Claude Code shows an expand hint to advertise that interaction.

That leaves the new behavior undiscoverable for users who rely on inline diagnostics while editing with code intelligence plugins enabled.

Suggested Improvement

Update the code intelligence documentation to describe how inline LSP diagnostic summaries behave in v2.1.121 and later.

For example, the Automatic diagnostics section could add a note like:

When the diagnostics found indicator appears, open the diagnostic summary with Ctrl+O or click the summary directly. Claude Code now shows an expand hint when more detail is available.

The terminal interaction docs should also mention that Ctrl+O can expand LSP diagnostic summaries in addition to opening the verbose transcript.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/discover-plugins | Primary code intelligence page describing automatic diagnostics after edits |
| https://code.claude.com/docs/en/interactive-mode | Ctrl+O shortcut reference should mention LSP diagnostic summary expansion behavior |
| https://code.claude.com/docs/en/tools-reference | LSP tool behavior section describes automatic diagnostics but not how users expand the summaries |

Total scope: 3 pages affected

Source: Changelog v2.1.121

Exact changelog entry:

LSP diagnostic summaries now expand on click/ctrl+o and show the expand hint

View original on GitHub ↗

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