Exploring the graph

Everything the system knows — the machine, your code, projects, knowledge corpora, and map data — is stored as entities joined by relationships in one local graph. aios graph browses it from the terminal; the dashboard Graph tab is the same thing with click-to-explore.

All of it runs against the live kernel, so it always reflects the current state. It needs no model and no network.

Overview

aios graph

Prints a histogram of the root entity types (things not nested under something else — a Host’s CPU and disks hang under the Host, not at the top level) and the total entity count.

Listing and searching

aios graph list Function          # root entities of a type (use --limit N to widen)
aios graph search "invoice"       # free-text search across entities

Inspecting one entity

aios graph show foo               # by name…
aios graph show a1b2c3d4…         # …or by id (exact)

show prints the entity’s properties and every edge, in and out — e.g. what a function CALLS, what IMPORTS a file, what a Host CONTAINS. To traverse, run aios graph show again on a name from the edge list. A name is matched against an entity’s name/path/key (exact first, then substring); if several match, the candidates are listed so you can be specific.

Provenance

aios graph history foo            # how this entity was observed over time (source + confidence)

From the assistant

You don’t have to use the CLI — in Assistant (or aios ask) the assistant can browse the graph itself: ask “tell me about the host” or “what is X connected to” and it inspects the entity’s properties and relationships for you, the same data aios graph show returns.

Scripting

Add --json to any subcommand for machine-readable output:

aios graph list Host --json
aios graph show foo --json