Troubleshoot Kast

Use the failure returned by Kast. An empty partial or rejected query is not evidence that the symbol is absent.

Symptom	First check
No Kast tools	Restart the client, then inspect its MCP or RPC catalog.
Installer reports no matching plugin	Check the IDEA release line in compatibility.
Project trust, import, or indexing blocker	Resolve the reported IDEA state, then repeat the read.
Wrong workspace	Start the client from the intended Gradle repository or worktree.
Partial query	Keep returned facts and limitations; narrow scope before retrying.
Stale `ref`	Search again and use the newly returned reference unchanged.
Uncertain change	Keep the plan and recovery evidence; see change.

health_check reports the bound workspace and IDEA readiness. It does not prove that every semantic query will succeed. validate_workspace runs specific read-only probes when you need stronger evidence.

Get started

Work with code

Workspace and support

Troubleshoot Kast