Skip to main content
Local merge is the way out for anyone who isn’t going to open a PR: it takes the session’s commits and puts them on the base branch, right there, with no network. It lives in Deliver → Merge locally, at the footer of the review panel. It comes painted red and marked red action — because it touches your main repository.

​
The preview

Opening the dialog fires worktree_merge_preview before anything else. It shows:
And underneath, what the preview actually went to fetch: merge-tree is the point: TYBA knows whether there will be a conflict without doing the merge, without a checkout, without a stash, without touching your working directory.

​
The three locks

The Merge into base button stays off, with the reason spelled out, in three cases:
The base is dirty. The base branch has uncommitted changes — commit or discard them before merging. TYBA is not going to move your work in progress out of the way to fit a merge.
There is a conflict. Conflicts with the base in: file, file. This is where the escape button shows up — see below.
There is nothing to merge. Nothing to merge: no commits beyond the base. Or the session is on the base branch itself, and then there is nothing to do.

​
Strategy

The core accepts a custom message, but the dialog has no field for it. Today the message is always the automatic one.

​
Confirm

Two clicks. The first arms it (Confirm merge?, the button turns red), the second executes. And what executes is not git merge:
The tree already came from merge-tree. The commit is created directly and the base moves forward by fast-forward. If the base changed between the preview and the click, --ff-only fails and you see The base branch moved during the merge — nothing changed, try again.
The base is never left half-merged. Either the fast-forward goes through, or nothing happened. There is no intermediate state for you to clean up.

​
Materialize: when there is a conflict

With the merge locked by a conflict, the dialog offers Resolve with agent. It does the thing backwards — and on purpose: materialize brings the base into the session’s worktree and lets the merge stop at the conflict. The conflicted files stay there, with markers, and TYBA sends the resolution prompt to that session’s agent. Your checkout is not touched at any point. Once the conflict is resolved in the session, the local merge runs clean.
Materialize requires the session’s worktree to be clean: The session worktree has uncommitted changes — commit or discard them before materializing the conflict.

​
After the merge

The dialog gives way to Delivered — what about the worktree?:
  • Keep — the worktree stays, the session stays.
  • Remove worktree and close session — two clicks, and it’s gone.
Removing is worktree remove --force plus git branch -D: the worktree goes away and so does the local branch. If uncommitted work was left behind, the warning appears before the second click — did NOT go into the PR/merge — removing will discard it permanently.

​
What does not exist

​
See also

Pull requests

The other way out — the one that goes through the forge.

Worktrees

Where the base was pinned, and what’s left after removing.