CLI

Navigation commands

Command	What it does
`index`	Index a project into `.oxcode/index.oxgdb/`.
`status`	Report index state for a project.
`context`	Rank entry-point symbols for a task, then expand nearby relationships. Deterministic and graph-derived.
`symbols`	Keyword discovery over symbols, with repeatable `--kind` filters.
`files`	Find files relevant to a query.
`symbol`	Resolve a single selector to its definition, signature, and source.
`calls`	Walk the call graph outward from a symbol.
`callers`	Walk the call graph inward to a symbol.
`query` / `explain`	Execute raw OxQL.

context ranks entry-point symbols for the task text, then expands nearby calls, contains, references, and implements relationships. For keyword discovery use symbols; do not pass plain English phrases to query.

Two more subcommands sit outside navigation: oxcode languages lists the registered language extractors, and oxcode mcp runs the stdio MCP server.

Selectors

Navigation commands accept several selector forms:

element:<id> — a concrete OxGraph element ID.
an exact crate-qualified name such as my_crate::auth::tenant_middleware (qualified names are anchored at the crate, so the first segment is the package name with - normalized to _).
name:<name> — a simple function name.
file:<path>:<line> — the innermost symbol covering a source line.

Symbol kinds

symbols accepts repeatable --kind <kind> filters. Valid kinds:

file, module, namespace, package, class, struct, enum, trait, interface, impl_block, function, method, field, variable, constant, type_alias, macro.