Overview
How Projects connect Proliferate to your repositories.
A project is a GitHub repository you've connected to Proliferate.
Connecting a repository doesn't just give agents read access to code. It creates a place to hold everything specific to that repo: its default branch, its setup and run scripts, its cloud environment variables, and every workspace anyone has opened against it.
What a project gives you
Once a repo is connected, it shows up in the sidebar as its own group, and you can:
- Create local, worktree, or cloud workspaces from it, each starting from the repo's configured default branch.
- Set a setup script and run command once, instead of repeating them in every prompt.
- Store environment variables and secret files that sync into cloud workspaces automatically.
- See every open workspace for the repo, with its branch, git status, and pull request state, at a glance.
Sidebar with connected repositories
Sidebar showing multiple connected repos as collapsible groups, each listing its local, worktree, and cloud workspaces.
Local and cloud, side by side
Every project has a Local side and a Cloud side. They're configured separately (see Configuration), and you choose which one a given workspace uses when you create it. That keeps a repo's local setup, which knows about your machine, independent from its cloud setup, which has to work in a fresh remote container every time.