opschain nodes list

Included from Basic tier

opschain nodes list [<path>] [--kind <kind>] [--wide]

Lists the estate as a flat table, depth-first. With no argument it walks every project's subtree (projects first, children sorted by code); with a node path it lists that node and everything beneath it. Node paths are the usual demo, demo/environments/dev, demo/environments/dev/assets/web shapes — see opschain docs cli/nodes.

The walk reads each node's child collections from the server, so a large estate costs one request per node that can hold children.

Flags

Flag	Meaning
--kind <kind>	Keep only nodes of this kind: project, environment or asset. Applied after the walk — the subtree is still traversed in full (filtering to asset still visits the projects and environments above them).
--wide	Add the DESCRIPTION and BY (created-by) columns.
--filter <column>[!]=<value>	Keep only rows matching the term (repeatable; terms AND). Columns are the printed table headers lowercased (spaces/dashes fold to _); * wildcards match the whole cell case-insensitively, != negates, commas mean any-of. Applied client-side after the walk, like --kind. Grammar: opschain docs cli.

Output

PATH                                      KIND         NAME            TEMPLATE            MAINTENANCE
/projects/demo                            project      Demo            -                   -
/projects/demo/environments/dev           environment  dev             -                   -
/projects/demo/environments/dev/assets/web  asset      web             web-template:1.0.0  -

• NAME carries an (archived) suffix on archived nodes.
• TEMPLATE is an asset's pinned template as <code>:<version> (- elsewhere); the asset collections are fetched with the template includes so it resolves on every listed asset.
• MAINTENANCE shows the reason of the node's maintenance badge (an active window covering the node, or a scheduled one starting within the server's badge horizon), - when none.

-o json / -o yaml print the same rows as an array of node objects (id, path, kind, code, name, description, archived, created_by, project_type, template, maintenance), the stable machine shape shared with nodes show.

Exit codes

Code	Meaning
0	Listed.
1	A server request failed.
2	Usage error — bad path, bad --kind, no server target.

Named errors

• invalid --kind "…" (must be project, environment or asset)
• expected a node path like demo, demo/environments/dev or /projects/demo/environments/dev/assets/web, got "…"
• nodes operate on a server's estate — pass --server <url> or 'opschain context use <name>'

All exit 2.

Examples

opschain nodes list
opschain nodes list demo --kind asset
opschain nodes list demo/environments/dev --wide
opschain nodes list -o json

See also

• opschain docs cli/nodes-show — one node in full.
• opschain learn 1.1 — the estate, guided.