repo:node:branch
Stage one branched node in the selected local repository and one lineage relation copying the source's title.
Reference for flywheel repo:node:branch.
Stage one branched node in the selected local repository plus one lineage relation from the source node, copying its title, as a single staged update. The source may already be committed or may have been created or edited in the same open staging area; an unknown or tombstoned source fails the command without changing staged work. Commit the staged work afterwards with repo:commit.
The source must be in this local repository; local commands never read the hosted service. A source this repository has no node for fails with repository_branch_source_not_in_repository. To add a node under a node in another repository you can read, create the node, then link it across the boundary; flywheel hosted:node:get <source_node_id> prints the source's repository_id:
flywheel repo:node:create --title "My addition"
flywheel repo:lineage:add <source_node_id> <new_node_id> --parent-repository-id <source_repository_id>Initial hosted sharing is applied when repo:push publishes the node, not when you stage or commit it, including the named Editor/Admin fork exception. See Sharing when a node is created for the full rule.
Command Group
Local Repository
Summary
Stage one branched node in the selected local repository and one lineage relation copying the source's title.
Effect
changes data
Usage
flywheel repo:node:branch [FLAGS] <node_id>Arguments
| Argument | Required | Choices | Description |
|---|---|---|---|
<node_id> | Yes | Node UUID. |
Required flags
None.
Optional flags
| Flag | Value | Default | Choices | Description |
|---|---|---|---|---|
--repo | string | Local repository filesystem path. | ||
--personal | Use the configured personal repository. | |||
--format | FORMAT | json, tsv, csv, table | Output format for command results. | |
--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
Stage one branched node in the selected local repository and one lineage relation copying the source's title.
flywheel repo:node:branch <node_id> --format=json