nodes:list

List nodes with optional filters.

Reference for flywheel nodes:list.

Use this command when you need a lightweight read of graph nodes before drilling into a specific node or branch.

Command Group

Nodes & Graph Commands

Summary

List nodes with optional filters.

Usage

flywheel nodes:list [FLAGS]

Aliases

nl

Required flags

None.

Optional flags

FlagValueDefaultChoicesDescriptionNotes
--pageinteger1Page number (1-based).
--page_sizeintegerserver defaultPage size.
--statusstringFilter by node status.
--include_archivedInclude archived nodes.
--formatFORMATjson, tsv, csv, tableOutput format for command results.Use json for scripts and table for quick terminal inspection.
--envPROFILEUse a configured CLI profile for this invocation.
--outPATHWrite output to a file path, or use - for stdout.
--openOpen browser-bound URLs when supported.
--no-retryDisable transient-error retries.
--retry-maxNMaximum transient-error retry attempts.
--waitBlock on async operations until a terminal state is reached.
--wait-timeoutSECONDS600Seconds to wait for --wait before timing out. Defaults to 600.
--allow-selfAllow mutating the currently active credential.
--timeoutSECONDSSet the per-request timeout budget in seconds.
--idempotency-keyKEYReuse an Idempotency-Key so ambiguous write failures can be retried with the same key.
--forceForce safety-gated operations where supported.
--yesSkip confirmation prompts for destructive operations.
--debugPrint structured request debugging with secrets masked.
--verbosePrint verbose progress for long-running operations.
-h, --helpShow this help.

Examples

List the first page of active nodes.

flywheel nodes:list --page 1 --page_size 20

Include archived nodes in the output.

flywheel nodes:list --include_archived