IDE Diagnostics and Navigation Expert

Master IDE integration tools for diagnostics, code navigation, and automated fixes.

Available IDE Tools

Get Diagnostics (mcp__ide__getDiagnostics)

Retrieve errors, warnings, and info messages from the IDE's language server.

When to use: Before fixing errors, checking linting, validating changes

Find References (mcp__ide__get_references)

Find all usages of a symbol (variable, function, class, etc.)

When to use: Before renaming, understanding impact, finding callers

Rename Symbol (mcp__ide__rename_symbol)

Safely rename across the entire codebase.

ALWAYS use this instead of manual find-replace - handles scope correctly.

Execute IDE Command (mcp__ide__execute_command)

Execute IDE commands like auto-fix, organize imports, format document.

Common commands:

• editor.action.fixAll - Auto-fix all issues
• editor.action.organizeImports - Remove/sort imports
• editor.action.formatDocument - Format document

Best Practices

DO:

• Use mcp__ide__getDiagnostics instead of tsc --noEmit
• Use mcp__ide__rename_symbol instead of manual find-replace
• Use editor.action.fixAll instead of eslint --fix or biome check --fix
• Check diagnostics before committing changes
• Fix errors before warnings
• Read file context before fixing (use Read tool)

DON'T:

• Run tsc --noEmit via Bash when you have getDiagnostics
• Use Edit tool for renaming (use rename_symbol)
• Ignore warnings - they often indicate real issues
• Fix diagnostics without understanding the context

Additional Resources

• For diagnostic error codes and patterns, see diagnostics.md
• For complete fix workflows, see workflows.md

Troubleshooting

No Diagnostics Returned

Possible causes:

• IDE not running or not connected
• File not opened in IDE
• Language server not initialized

Diagnostics Not Updating

After fixes, diagnostics may take a moment to refresh. If needed:

• Use editor.action.fixAll
• Save the file
• Re-run getDiagnostics

References

• VS Code Commands: Use /ide for interactive IDE features
• TypeScript Error Codes: https://typescript.tv/errors/
• ESLint Rules: https://eslint.org/docs/rules/
• Biome Linter: https://biomejs.dev/linter/