Workspaces
A workspace gives an agent its own checkout and branch while your Home Repo stays available for normal work.
Choose who creates workspaces
Section titled “Choose who creates workspaces”Open Dock > Launch behavior > Workspaces and choose:
- back2vibing — this method creates the workspace for you and starts your preferred agent in the terminal workflow configured below.
- Conductor — Conductor creates the workspace and starts its configured agent. back2vibing passes it the repository and optional first prompt.
- Herdr — Herdr creates the Git worktree and opens it as its own Herdr workspace, then starts your preferred agent in it. This is the recommended workflow: the Space is named after the task you typed, additional agents open as tabs or panes in that same Space, and focus lands on the exact pane.
Set this once. The Session Dock uses that choice for new workspaces.
A new workspace branches from your repository’s default branch, whatever it is called. The name you type names the workspace; the folder and branch use a short slug shown in the dialog preview.
Herdr workflow
Section titled “Herdr workflow”With the Herdr workflow selected:
- Worktrees you create from Herdr’s own sidebar are adopted as soon as an agent registers in them, and an extra session opens in the Space that already holds that checkout.
- Renaming, closing, or removing a workspace in Herdr is reflected in the dock, and renaming a session in the dock renames it in Herdr.
- Agents that Herdr recognises report working, waiting, or done even when they have no back2vibing hook installed.
Create a workspace
Section titled “Create a workspace”- Open the Session Dock.
- Open the Workspaces section.
- Choose New workspace.
- Select the Home Repo and optionally enter the first prompt.
- Review the destination, then create the workspace.
Use New workspace for a separate coding lane. Use + Agent inside an existing workspace group to add another agent to that workspace.
Sync & Test from the Session Dock
Section titled “Sync & Test from the Session Dock”Use this when your tests or local services are configured in the Home Repo:
- Open the Session Dock.
- Open Workspaces.
- Find the workspace group you want to test.
- Choose Sync & Test.
- Run your normal tests from the Home Repo.
- Choose Stop Sync & Test when finished.
back2vibing saves the Home Repo state, mirrors the selected workspace into it, and restores the saved state when you stop. If another workspace is active, Switch Sync & Test restores the current target before mirroring the new one.
Resolve any blocker shown by back2vibing before continuing. An in-progress merge or rebase, detached branch, or unsupported untracked path can prevent a safe mirror.
Finish a workspace
Section titled “Finish a workspace”After a squash merge from the dock’s pull-request actions, choose the cleanup action to remove the local checkout. back2vibing removes it through Herdr when Herdr owns the worktree, closes that Space, and never deletes the branch. If the checkout still has uncommitted work, back2vibing says so and asks again before forcing the removal.
Try the workspace flow
Section titled “Try the workspace flow”This focused demo walks through creating a workspace and using Sync & Test.
Launch isolated workspace, mirror it into the Home Repo, and run your normal tests.
See Sessions for live and historical session controls.