hosted:node:list
List one page of nodes with optional filters. Returns nodes, total (all matches), page, page_size and has_more; raise --page while has_more is true. Narrow with --owners, --writers, --visibility, --root_only and --repo_url; --projection sets how much of each node comes back. Use graph:get for connections. Searches only your own nodes unless --access_scopes is given; MCP flywheel_list_nodes always searches owned, shared and public. owner_email and author_email are included only for nodes you own, hold a repository role on, or that are shared with you by name. Public or link access alone does not include these emails; the owner column is empty for other people's public nodes.
Reference for flywheel hosted:node:list.
Use this command when you need a lightweight read of graph nodes before drilling into a specific node or branch. Use --access_scopes shared or --access_scopes public to discover other people's readable nodes. owner_email and author_email are included only for nodes you own, hold a viewer/editor/admin role in the repository containing the node, or that are shared with you by name. Public or Unlisted link access alone does not include another account's email, even when signed in; the table's owner column is empty for other people's public nodes. See Add to a graph you don't own.
Command Group
Hosted Repository
Summary
List one page of nodes with optional filters. Returns nodes, total (all matches), page, page_size and has_more; raise --page while has_more is true. Narrow with --owners, --writers, --visibility, --root_only and --repo_url; --projection sets how much of each node comes back. Use graph:get for connections. Searches only your own nodes unless --access_scopes is given; MCP flywheel_list_nodes always searches owned, shared and public. owner_email and author_email are included only for nodes you own, hold a repository role on, or that are shared with you by name. Public or link access alone does not include these emails; the owner column is empty for other people's public nodes.
Effect
read-only
Usage
flywheel hosted:node:list [FLAGS]Aliases
nl
Required flags
None.
Optional flags
| Flag | Value | Default | Choices | Description | Notes |
|---|---|---|---|---|---|
--page | integer | 1 | Page number from 1 (omitted: 1). Past the end: empty; stop on has_more or the total. | ||
--page_size | integer | server default | Items per page (omitted: command default). Out of range: clamped or 422, by command. | ||
--access_scopes | string | owned | Comma-separated scopes to list: owned (your nodes), shared (shared with you, including through a repository role), public. | ||
--owners | string | Owner selectors: me or an email address (user IDs are refused). Keeps nodes owned by any listed user; an unknown email: 422. Omitted: any owner. Comma-separated values. | |||
--writers | string | Writer selectors, same syntax as owners. A writer is the node's owner, someone given editor or admin on the node, or an editor or admin of its repository; link-only access and past authorship don't count. Keeps nodes where any listed user is a writer. Omitted: no filter. Comma-separated values. | |||
--visibility | string | private, shared, unlisted, public | Keeps nodes with any listed derived visibility: private (owner only), shared (shared with named people), unlisted (open to anyone with the link) or public. Omitted: all. Comma-separated values. | ||
--root_only | false | true: only root nodes (nodes with no parent). Omitted: all nodes. | |||
--repo_url | string | Git URL of the checkout a node was written from (its repo_context, not a Flywheel repository). A repository's HTTPS and SSH URLs and a trailing .git match each other; case is ignored. Unparseable: 422. Omitted: no filter. | |||
--repo_match_mode | string | exact | exact, fuzzy | With repo_url: exact (default) needs the same repository; fuzzy matches any stored URL that contains it (a substring match, not spelling similarity). | |
--projection | string | topology | core, topology, full | core: node fields with content and summary, no artifacts. topology: same, content and summary empty (a root may keep its banner artifact). full: core plus artifacts (and executions where returned), where offered. Omitted: command default. Relationship IDs vary by command; tree entries are layout only. | |
--format | FORMAT | json, tsv, csv, table | Output format for command results. | Use json for scripts and table for quick terminal inspection. | |
--env | PROFILE | Select a CLI profile; unconfigured default requires FLYWHEEL_BASE_URL. | |||
--out | PATH | Write output to a file path, or use - for stdout. | |||
--open | Open browser-bound URLs when supported. | ||||
--no-retry | Disable transient-error retries. | ||||
--retry-max | N | Maximum transient-error retry attempts. | |||
--wait | Block on async operations until a terminal state is reached. | ||||
--wait-timeout | SECONDS | 600 | Seconds to wait for --wait before timing out. Defaults to 600. | ||
--allow-self | Allow mutating the currently active credential. | ||||
--timeout | SECONDS | Set the per-request timeout budget in seconds. | |||
--idempotency-key | KEY | Reuse an Idempotency-Key so ambiguous write failures can be retried with the same key. | |||
--force | Force safety-gated operations where supported. | ||||
--yes | Confirm forced compute:release-all --force. Other runtime commands do not read --yes. | ||||
--debug | Print structured request debugging with secrets masked. | ||||
--verbose | Print verbose progress for long-running operations. | ||||
-h, --help | Show this help. |
Examples
List the first page of your nodes.
flywheel hosted:node:list --page 1 --page_size 20List root nodes you own with their full payloads.
flywheel hosted:node:list --owners me --root_only --projection fullList nodes shared with you, with their owners.
flywheel hosted:node:list --access_scopes shared --format=tableList public nodes.
flywheel hosted:node:list --access_scopes publicOutput
Default format: human.
| Field | Type |
|---|---|
nodes | array<object> |
total | integer |
page | integer |
page_size | integer |
has_more | boolean |
hosted:node:get
Read one node by node_id: title, slug_name, content, summary, tags, revision (the expected_revision for writes), visibility, can_write and timestamps. owner_email and author_email are included only for nodes you own, hold a repository role on, or that are shared with you by name. Public or link access alone does not include these emails. --projection chooses the fields; full includes at most 40 artifacts, with artifacts_total and artifacts_truncated indicating more. Parent and child IDs are not listed: use hosted:lineage:list.
hosted:node:merge
Commit one merged node in this hosted repository and one lineage relation from each supplied source, in argument order. The sources are kept, not deleted or changed. The merged node takes the first nonblank source title (else "Merged node"); its content and summary start empty.