Connect a repo

Connect a repository so agents have real code to work against. It becomes the source for workspaces, branch names, setup scripts, terminals, previews, and review.

Add a repository

Open Add repository, then pick the folder you want. Link a local repo and Add a local repo do the same thing — take whichever label matches how you think about the repo — and register the folder as soon as you pick it.

Adding a repo confirms with Repository added and a Customize defaults shortcut.

Proliferate works with any git checkout on your machine. Pull requests still go through your git host, so an org admin may want the GitHub App installed for richer review status; see org settings.

One repo, several running copies

One repository backs as many workspaces as you want, from two sources:

• Local checkout — the folder you linked.
• Local worktrees — a branch and working tree per workspace, created from that checkout.

You pick the target when you create a workspace, not when you connect the repo. See Isolated workspaces.

Configure the repo

Set the default branch, setup script, and run command before you create your first workspace.