Skip to content

Worktrees Sync

Why This Matters

Section titled “Why This Matters”

Worktrees keep each agent session isolated so your main local repo stays clean and easy to review.

Step-by-Step Flow

Section titled “Step-by-Step Flow”
  1. Start an agent via b2v <agent>.
  2. Let back2vibing create and track the session worktree.
  3. Finish your edits in that isolated workspace.
  4. Open the app’s Sessions tab and click Sync to Local Repo.
  5. Review changes locally and commit.

Sync Modes

Section titled “Sync Modes”
  • Apply (recommended): safest day-to-day mode.
  • Overwrite: use only when you intentionally want force alignment.

Direction Guide

Section titled “Direction Guide”
  • Worktree -> Local Repo: use when agent work is done and ready to review.
  • Local Repo -> Worktree: use when you need baseline local changes inside the session workspace.

You can sync from either the app’s Sessions tab or from terminal:

Terminal window
b2v sync --mode apply

After syncing, continue in Sessions or commit from your local repo.