Projects
A project is a repository or folder inside a group. Sessions, boards, notes and automations are filed under it. A project has a name, which is stored with your account, and a linked folder, which is specific to each computer. You link the folder on every computer where you want to run sessions.
Where projects come from
| Group type | How a project gets there |
|---|---|
| Private group | You create it with New project |
| Organization group | Your organization adds it. You only link a folder to it |
Create a project in a private group
- Open a private group and choose New project.
- Under Folder, select Browse and pick the folder. For a git repository, the dialog shows its remote and branch. For any other folder it notes that sessions there edit the folder directly, with no branch.
- Enter a Name.
- Confirm to create the project.
If the folder is already linked to another project, the dialog tells you and offers Open it. A folder belongs to one project at a time.
Link a folder to an existing project
A project with no folder on this computer shows local only on its overview page. Sessions and code actions on boards need a linked folder.
- Open the project. On the overview page select Choose folder…, or choose Link folder… from the New menu.
- Pick the folder that holds your clone of the repository.
When the folder matches, it is linked and the project shows linked.
When the folder does not match
For a project that has a repository, the git remote of the folder must match the project's repository. If it does not, nothing is linked and the Link folder dialog shows the folder you picked, its remote and the expected remote. From there you can:
- Pick another folder
- Link to selected project, when the folder matches a different project in the same organization group
- Add the folder as a new project, when you are in a private group
A folder that is one of your organization's repositories can be linked only to its own project.
Set up all projects of an organization group
- Open the organization group's overview page.
- In the Projects section, choose the folder where this group's repositories live on this computer.
- Clauge links the projects it finds in that folder. For the others, select Clone.
If you do not have the repository yet, the project overview page shows its URL to clone.
Edit, move or delete a project
Right-click a project in the Workspace tree:
| Item | What it does |
|---|---|
| Edit | Change the name, or use Unlink and Link folder… to change the folder |
| Move to group… | Moves the project to another of your groups |
| Reveal in Finder | Opens the linked folder |
| Copy path | Copies the path of the linked folder |
| Delete project | Deletes the project after you confirm. This cannot be undone |
Projects in an organization group are managed by your organization, so you cannot rename, move or delete them.