How Projects Work
A project represents a single codebase. All workspaces created from the same repository (or a fork with the same remote origin) belong to the same project. This gives you a high-level view of all the work happening across your repo.| Field | Description |
|---|---|
| Name | Derived from the repository name, editable |
| Remote origin | The Git remote URL that identifies the project |
| Workspaces | All workspaces linked to this project |
Project-Level Settings
Projects can have their own configuration that applies to all workspaces within:- Setup script — runs automatically when a new workspace is created in this project
- Run script — executes before each agent run
- Archive script — runs when a workspace in this project is archived
- Commit instructions — template for commit messages
- PR instructions — template for pull request descriptions
Managing Projects
Projects are created automatically but can be managed from Settings:- Rename — update the project name
- Archive — hide the project and all its workspaces from the sidebar
- Delete — permanently remove the project and unlink its workspaces
