Skip to main content

Cross-Graph Tools

The cross-graph tool bridges the code graph and docs graph, giving you a unified view of a symbol across both source code and documentation.

info

This tool requires both the docs graph and code graph to be enabled.

docs_cross_references

Returns the complete picture for a symbol: its source code definition, documentation mentions, and code examples from docs.

Parameters

ParameterRequiredDescription
symbolYesSymbol name to look up (e.g. "hashPassword", "UserService")

Returns

{
"definitions": [...],
"documentation": [...],
"examples": [...]
}
FieldDescription
definitionsSource code symbols from the code graph (signatures, file locations)
documentationDocumentation sections that mention the symbol
examplesCode blocks from docs that reference the symbol

When to use

Use docs_cross_references when you need complete context about a symbol. Instead of making separate calls to code_search, docs_search, and docs_find_examples, this single tool gives you everything:

  • The actual code definition (from source files)
  • The documentation that explains it (from markdown)
  • The usage examples (from code blocks in docs)

This is particularly useful before modifying a function or class — you see its implementation, how it is documented, and what examples reference it, all at once.