but land
Land a branch directly onto the target branch.
Lands the branch onto the configured target (for example origin/master) without going
through a pull request — the "just push to the target" workflow. By default the target is
fast-forwarded to the branch tip when possible (no merge commit); otherwise a merge commit
is created. For a local (gb-local) target the refs are moved locally; otherwise the result
is pushed to the remote. After landing, the remaining applied branches are reconciled onto
the moved target, just like but pull.
Requires an active GitButler workspace. Updating the target is direct and not easily
reversible, so a confirmation is required (use --yes to skip it in scripts).
When NOT to use this: if your project lands changes through pull requests / code review,
use but push and open a PR (but pr new) instead — but land deliberately bypasses that
process. On a real remote, a branch protected against direct pushes will reject the land.
Examples
Land a branch by its CLI ID:
Land a branch by name, forcing a merge commit:
Usage: but land <BRANCH> [OPTIONS]
Arguments
<BRANCH>— Branch ID or name to land onto the target branch (required)
Options
--yes— Skip the confirmation prompt--no-ff— Always create a merge commit, even when the branch can be fast-forwarded
Last updated on