query_symbols

[symbols]

Queries symbols with text, kind, project, and export filters.

Why this tool exists

JS/TS names repeat across packages, files, exports, type/value spaces, and generated declarations.

How it helps the agent

Symbol tools turn fuzzy names and cursor positions into stable identities for references, callers, exports, and refactors.

Try it locally in the TGlider playground

Parameters

Name	Type	Required	Description
query	string	No	Optional symbol text filter.
kind	string	No	Optional TypeScript symbol kind filter.
projectName	string	No	Optional loaded project name to scope the query.
exportedOnly	boolean	No	Return only exported symbols.
matchMode	string	No	Name match mode: 'exact', 'prefix', or 'contains'. Default: exact matches win when they exist, otherwise contains.
limit	number	No	Maximum number of matching symbols to return.

Examples

Find exported interfaces

Request 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "query_symbols",
    "arguments": {
      "kind": "InterfaceDeclaration",
      "exportedOnly": true
    }
  }
}

Response Notes

Returns filtered symbols with stable keys, spans, and truncation/suppression reporting (totalMatches, truncated, appliedMatchMode, suppressedMatches, notes).