chio lineage

Walk, compare, and list the anchored roots of the lineage graph that records which grant each delegated grant came from.

On this page

All command families · Global flags

chio lineage

Query, diff, or list anchored roots in the lineage DAG.

Command synopsistext

chio lineage [OPTIONS] <COMMAND>

Additional behavior

Surfaces the lineage graph (chio-lineage): - query walks forward or reverse from a seed node id over a lineage JSON dump. - diff computes the symmetric edge diff between two dumps. - roots lists pinned-frontier artifacts in a directory.

chio lineage query Walk forward or reverse from a seed node id over a lineage JSON dump.
chio lineage diff Symmetric edge diff between two lineage JSON dumps.
chio lineage roots List pinned-frontier artifacts in a directory.

chio lineage query

Walk forward or reverse from a seed node id over a lineage JSON dump.

Command synopsistext

chio lineage query [OPTIONS]

--graph <PATH> Path to the lineage JSON dump (the same format the static viewer at docs/demo/lineage reads).
--seed <ID> Seed node ids. Repeatable.
--direction <DIRECTION> Walk direction. forward walks downstream edges; reverse walks upstream. Default forward.
--depth-limit <DEPTH_LIMIT> Maximum recursion depth. Defaults to 20 (matches the recursive-CTE bound documented on chio-store-sqlite::lineage_cte). Default 20.
--row-limit <ROW_LIMIT> Maximum row count. Default 10000.
--live Read the lineage graph from the kernel’s configured receipt store instead of a --graph dump.
--json Emit a JSON report instead of a TTY summary.

chio lineage diff

Symmetric edge diff between two lineage JSON dumps.

Command synopsistext

chio lineage diff [OPTIONS] --left-label <LABEL> --left <PATH> --right-label <LABEL> --right <PATH>

--left-label <LABEL> Required.
--left <PATH> Required.
--right-label <LABEL> Required.
--right <PATH> Required.
--json

chio lineage roots

List pinned-frontier artifacts in a directory.

Command synopsistext

chio lineage roots [OPTIONS] --dir <PATH>

--dir <PATH> Required.
--json