find_unused_symbols

[references]

Finds conservative unused symbol candidates in a loaded TS/JS project or file.

Why this tool exists

Safe edits depend on real symbol relationships, not text matches in comments, strings, or similarly named modules.

How it helps the agent

The model can see actual declarations, references, implementations, and conservative cleanup candidates before editing.

Try it locally in the TGlider playground

Parameters

NameTypeRequiredDescription
projectNamestringNoOptional loaded project name to scope the query.
filePathstringNoWorkspace-relative or absolute file path.
skipnumberNoNumber of matching results to skip.
takenumberNoMaximum number of matching results to return.

Examples

Find likely-unused private symbols

Request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "find_unused_symbols",
    "arguments": {
      "projectName": "app"
    }
  }
}

Response Notes

Returns cleanup candidates with symbol keys, spans, and conservative exclusion notes.

↑/↓ NavigateEnter OpenSpace Expand