shelbi merge
Merge a worker's branch into the project's default branch, locally or via a GitHub PR.
shelbi merge
shelbi merge [OPTIONS] <ID>shelbi merge is the bridge between a task in review and a clean default
branch. By default it performs a local squash-merge of the task's branch
into the project's default branch (typically main) using the worker's
commit message. Pass --pr to push the branch and open a GitHub pull
request instead — useful when your team's workflow requires a code-review
roundtrip before anything lands.
The command does not move the card. After a successful local merge, the
orchestrator's "merged → done" sweep (or you, manually) moves the task to
done. After a --pr merge, the card stays in review until the PR
itself lands.
Arguments
| Argument | Type | Default | Description |
|---|---|---|---|
<ID> | string | — | Task id whose branch to merge (required). |
Flags
| Flag | Type | Default | Description |
|---|---|---|---|
--pr | flag | off | Push the branch and open a GitHub PR instead of a local squash-merge. |
-p, --project <PROJECT> | string | env / marker file | Project to operate on. |
Examples
Squash-merge a reviewed task locally:
shelbi merge docs-write-cli-reference-pagesOpen a GitHub PR for the branch instead of merging locally:
shelbi merge docs-write-cli-reference-pages --prSee also
- Columns — where
reviewanddonesit and what each transition signals. shelbi review— the upstream step that puts the branch in front of a reviewer before merge.