GitButler ⧓

Commands
>_

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:

but land bu

Land a branch by name, forcing a merge commit:

but land my-feature-branch --no-ff

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

On this page

Edit on GitHubGive us feedback