Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

OxQL

query and explain execute raw OxQL — an OxGraph-native, Cypher-flavored query language. oxcode exposes a deliberately small, read-only slice of it for navigating the code graph. For keyword discovery prefer symbols; do not pass plain English phrases to query.

Accepted profile

CATALOG
MATCH ELEMENTS
MATCH ELEMENTS HAS LABEL <label>
MATCH ELEMENTS WHERE <property> = '<value>'
MATCH RELATIONS TYPE <type>
GRAPH calls WALK FROM <element-id> DEPTH <n> [DIRECTION outgoing|incoming|both] [LIMIT n]

Examples

oxcode query "MATCH ELEMENTS WHERE qualified_name = 'crate::entry'" --path path/to/project
oxcode query "MATCH RELATIONS TYPE calls" --format expand --path path/to/project
oxcode query "GRAPH calls WALK FROM 12 DEPTH 2 DIRECTION both LIMIT 100" --path path/to/project

Use --format expand to expand graph IDs back into function names, definition ranges, signatures, and source context.

The full OxQL surface — compound WHERE predicates, ordered comparisons, typed-property and relation matching — lives in the engine itself; see oxgraph → Embedded database.