CLI
commit
Inspect the graph commit history.
Every write to a branch produces a graph commit. commit list enumerates the
commit history on a branch; commit show returns the details of a single
commit. The commit graph is Omnigraph's audit surface. There is no separate
"run" or "transaction" log.
commit list
List graph commits on a branch, most recent first.
Usage
omnigraph commit list <path> [--branch <name>] [options]Arguments
| Argument | Required | Description |
|---|---|---|
path | yes | Graph URI (local path or s3://); required unless resolved from --target / --config |
Options
| Option | Required | Default | Description |
|---|---|---|---|
--branch | no | main | Branch whose commit history to list |
--target | no | — | Named graph from omnigraph.yaml |
--config | no | — | Path to an omnigraph.yaml |
--json | no | — | Output structured JSON |
Example
omnigraph commit list ./graph.omni --branch main --json{
"commits": [
{
"graph_commit_id": "01JQ6V6T4R3Y6Z8W1M8E0S4R9C",
"manifest_branch": "main",
"manifest_version": 12,
"parent_commit_id": "01JQ6V1VJ2E5N4K4T7T3A0M1D9",
"merged_parent_commit_id": null,
"actor_id": "act-andrew",
"created_at": 1748399200
}
]
}Use the graph_commit_id as --snapshot on omnigraph read to query the
graph at that historical state.
commit show
Show the metadata of a single commit by id.
Usage
omnigraph commit show --uri <path> <commit-id> [options]Options
| Option | Required | Default | Description |
|---|---|---|---|
--uri | yes | — | Graph URI |
--target | no | — | Named graph from omnigraph.yaml |
--config | no | — | Path to an omnigraph.yaml |
--json | no | — | Output as JSON |
Example
omnigraph commit show --uri ./graph.omni 01JQ6V6T4R3Y6Z8W1M8E0S4R9C --json