Connect a Repo

Add a repository so Proliferate can create workspaces, branches, and reviewable diffs.

Connect a repository when you want agents to work against real code.

The repository becomes the source for workspace creation, branch naming, setup scripts, terminals, browser previews, and review.

Add a repository

Open Add repository and pick one of three options:

  • Link a local repo: point Proliferate at an existing Git checkout on your machine.
  • Add a cloud repo: pick a GitHub repository to run in your cloud sandbox. Proliferate authorizes against GitHub through its GitHub App, then lists the repositories you can access so you can search and add one (or paste an owner/repo value directly).
  • Add a local repo: register a repository folder on your machine, with the option to also mirror it to a cloud environment.

Add a repository dialog

Entry step listing the three options: Link a local repo, Add a cloud repo, Add a local repo, each with a one-line description and a number key shortcut.

Add a cloud repo picker

Search field over a list of GitHub repositories with owner avatar, default branch, and an Add/Enable/Use button per row; a manual owner/repo entry field sits below the list.

Confirming a local folder shows the resolved path and, if you have a cloud organization, a toggle to also create a matching cloud environment for that repository. Adding a cloud repository authorizes, lists, and registers it in one flow.

Start the first workspace

Create a workspace with a small, bounded task. For example:

  • Add a focused test.
  • Fix a single bug.
  • Update one integration.
  • Ask for a plan before implementation.
Info:

Small first tasks make it easier to confirm repository access, scripts, agent credentials, and review flow before you scale up.

Next: set up action scripts.

On this page