rimba merge

Merge a worktree’s branch into main or another worktree. When merging into main, the source worktree and branch are auto-deleted unless --keep is set. When merging between worktrees, the source is kept unless --delete is set.

Synopsis 

rimba merge <task> [flags]

Examples 

rimba merge auth                           # Merge into main, delete source
rimba merge auth --keep                    # Merge into main, keep source
rimba merge auth --into dashboard          # Merge into worktree, keep source
rimba merge auth --into dashboard --delete # Merge into worktree, delete source
rimba merge auth --no-ff                   # Force merge commit
rimba merge auth --dry-run                 # Preview without making changes

Common workflows

Standard merge to main and clean up

rimba merge my-feature
# Merges feature/my-feature → main, removes worktree and branch

Merge to main but keep the branch for tagging or reference

rimba merge my-feature --keep

Cross-worktree merge (e.g. integrate a shared utility)

rimba merge shared-utils --into my-feature
# Merges shared-utils' branch into my-feature's worktree; both are kept

Preview before merging

rimba merge my-feature --dry-run

--keep and --delete are mutually exclusive. Merging to main deletes the source by default; merging to another worktree keeps it by default.

Flags

Flag Description
--into Target worktree task to merge into (default: main/repo root)
--no-ff Force a merge commit (no fast-forward)
--keep Keep source worktree after merging into main
--delete Delete source worktree after merging into another worktree
--dry-run Preview what would be merged/cleaned up without making changes
This site uses Just the Docs, a documentation theme for Jekyll.