Building the graph
Asking questions
query accepts --depth, --budget, and repeatable --context filters to
restrict traversal to particular edge kinds (calls only, imports only, and so
on); when you don’t pass a filter, one is inferred from the question itself.
Impact analysis
Two commands answer “what does this change touch”:affected walks the reverse edges from a symbol and reports everything that
depends on it — with the call sites, not just the definitions. impact diffs
your branch against a base ref, maps the changed lines to symbols, and reports
the blast radius and the subsystems it touches: a review map for the branch.
Understanding the shape of the codebase
The Atlas view in the editor
The editor renders the same graph as an interactive view alongside your code. Large graphs open as a subsystem overview — one node per community — rather than a hairball; double-click a subsystem to drill into it, and running a query shows exactly the answer’s subgraph. Smaller graphs render in full.- Click a symbol to see its explanation — identity and connections.
- Double-click a symbol to open its file at the defining line.
- Search for a symbol to jump to it across views.
Work-memory: the graph learns your branch
Query outcomes can be recorded into the branch’s committed history:.reasonos/ tree, so they travel with
the branch through git — the sources that answered questions well rank higher
in future queries, and dead ends rank lower, for everyone on the branch and
for the agents working on it.
Querying other repositories
Every read command accepts--workspace to query a graph you haven’t cloned:
@org/project[@branch] slug resolved through the
control plane, a local workspace path, or a node URL.