hosted:node:branch
Create one branched node and one lineage relation from the source. Only the source's title is copied, not its content, summary, tag assignments or artifacts, and the source is unchanged. Without --repository-id the server places it in the source's repository when you hold a repository write role there, otherwise in your fork. A fork node copies the source's sharing when you hold a named Editor or Admin grant on it; otherwise it starts private unless you have added fork members. With --repository-id, commit it in that hosted repository, which must hold the source.
Reference for flywheel hosted:node:branch.
Create and commit one branched node that copies the source's title. Without --repository-id, the server chooses the repository: the source's repository when you hold a write role there, otherwise your fork of that repository, where it starts shared like the parent when you hold a named Editor or Admin grant on it, otherwise private unless you have added fork members. The result names the node, the repository it landed in and the placement. With --repository-id, the branch is committed in that hosted repository, which must already hold the source and requires a sufficient repository role. An existing repository refuses insufficient membership with 403 repository_forbidden (CLI exit 3). To add your own node under a readable parent without joining its repository, run flywheel hosted:node:create --parent <node_id> --title 'My addition'; without a write role there, it lands in your fork. Missing and unreadable sources still return 404, and nothing is created. See Add to a graph you don't own for the server-placement workflow.
Initial sharing is copied once at creation; see Sharing when a node is created for the full rule. To review work before publishing it, use a local repository and push only when ready.
Command Group
Hosted Repository
Summary
Create one branched node and one lineage relation from the source. Only the source's title is copied, not its content, summary, tag assignments or artifacts, and the source is unchanged. Without --repository-id the server places it in the source's repository when you hold a repository write role there, otherwise in your fork. A fork node copies the source's sharing when you hold a named Editor or Admin grant on it; otherwise it starts private unless you have added fork members. With --repository-id, commit it in that hosted repository, which must hold the source.
Effect
changes data
Usage
flywheel hosted: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 |
|---|---|---|---|---|
--repository-id | string | Hosted repository UUID to commit to. Omit it to let the server choose the repository. | ||
--message | string | Hosted commit message. Only with --repository-id. | ||
--expected-head | string | Hosted head this write expects, as head from flywheel hosted:repository:head <repository_id>. When set, the automatic head read is skipped; if the head has moved, the write is refused with repository_head_mismatch: read the head again and retry. Only with --repository-id. | ||
--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
Branch a node you can read; the branch lands in the source's repository or in your fork of it.
flywheel hosted:node:branch <node_id> --format=jsonCommit one branched node in this hosted repository and one lineage relation copying the source's title.
flywheel hosted:node:branch --repository-id=<uuid> <node_id> --format=jsonOutput
Default format: human.
| Field | Type |
|---|---|
node_id | string |
repository_id (optional) | string |
placement (optional) | "parent_repository" | "fork" | "default_workspace" |
commit_id (optional) | string |
head (optional) | string |
cursor (optional) | string |
receipt_sequence (optional) | integer |
warnings (optional) | array<string> |
hosted:node-tag:remove
Commit removing a tag from a node. One assignment per commit; removing a tag the node does not hold is refused.
hosted:node:create
Create a node from --title or the full six-field JSON values file. Without --repository-id the server places it: under --parent, in the parent's repository when you hold a repository write role there, otherwise in your fork. A fork node copies the parents' sharing when all parents are in one upstream repository and you hold a named Editor or Admin grant on every parent; otherwise it starts private unless you have added fork members. With no --parent, create a root in your default workspace. With --repository-id, commit a root in that hosted repository.