Merge Review UI
Learn how to push and pull changes between an agent’s container and your local Git branch.
What is the Merge Review UI?
The Merge Review UI is the control center for keeping:
The agent’s branch inside its container, and
in sync.
You'll use it to bring agent work into your repo (Pull) or send your local commits into the agent's container (Push).
Mental model:
Pull = get what the agent did
Push = give the agent your latest local changes
Open any agent session and click Merge Changes in the left sidebar.
You’ll see:
Agent branch (in the container)
Local branch (on your machine)
Buttons for Push and Pull
Pulling changes (most common)
Use Pull when the agent has completed work and your local repo hasn’t diverged.
Agent finishes a task and commits in the container.
Git fast‑forwards or clean‑merges the agent’s branch into your local branch.
Pushing changes (send your edits to the agent)
Use Push when you’ve made local commits the agent should know about.
Examples:
You edited code locally while the agent was running
You want the agent to continue from your latest commit
If edits don’t overlap, Git auto‑merges.
If they touch the same lines, you’ll see a conflict.
Handling merge conflicts
If both sides changed the same lines, Git reports a conflict and Sculptor shows an error.
To resolve:
Open the conflicted file in your editor
Resolve manually or ask the agent:
“Resolve the conflict in README.md and keep my version.”
Once resolved:
Click Pull to sync the clean state back locally
When to use Push vs Pull
Use Pull when:
You want to bring the agent’s work into your repo
You haven’t made conflicting edits
The agent just finished a task
Use Push when:
You’ve made local commits the agent should build on
You want to sync histories
You need the agent to resolve conflicts
The Merge Review UI keeps local Git and container Git aligned. It’s meant to:
Make agent changes easy to merge
Let agents build on your commits
For working directly with the agent’s files, see Pairing Mode.
