find_references

[references]

Finds references for a previously discovered symbol key.

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
symbolKeystringYesStable symbol key returned by a prior symbol discovery tool.

Examples

Find all references to a symbol

Request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "find_references",
    "arguments": {
      "symbolKey": "role=canonical|..."
    }
  }
}

Response Notes

Returns reference locations with file and line text, plus a partial flag and notes when resolution may have missed call sites (for example only the declaration was found or a project could not re-resolve the declaration).

↑/↓ NavigateEnter OpenSpace Expand