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>

Command Group

Local Repository

Summary

Stage one branched node in the selected local repository and one lineage relation copying the source's title.

Usage

flywheel repo:node:branch [FLAGS] <node_id>

Arguments

ArgumentRequiredChoicesDescription
<node_id>YesNode UUID.

Required flags

None.

Optional flags

FlagValueDefaultChoicesDescription
--repostringLocal repository filesystem path.
--personalUse the configured personal repository.
--formatFORMATjson, tsv, csv, tableOutput format for command results.
--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

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