Work merge

Home › Reference › Commands › Work › Merge

work merge - Merge workspace changes back to main (squash by default)

Merges the current workspace branch back into the target branch (default: main) using squash merge to create a single, well-documented commit.

By default, this command: 1. Validates workspace is clean and up to date 2. Switches to target branch and updates it 3. Squash merges all workspace commits into a single commit 4. Uses commit to generate a comprehensive commit message 5. Removes the workspace after successful merge

Flags

Flag	Description
--target (default: main)	Target branch to merge into
--no-squash (default: false)	Use regular merge instead of squash merge
--keep-worktree (default: false)	Keep workspace after merge (don't remove)
-d, --debug (default: false)	Enable debug mode (pass through to commit)

Notes

Expected Output:

• Squash merge commit on target branch
• Workspace removed (unless --keep-worktree)

Examples

work merge
work merge --target=develop
work merge --no-squash
work merge --keep-worktree

See Also

• create squash-message
• work remove
• work Commands

---

Tutorials | How-to Guides | Explanation | Reference

You are here: Reference — information-oriented technical descriptions of the system.