Workspaces and projects

Open the Code tab. Until you have a workspace, the middle says No workspaces yet.

Click New workspace. If all you need is a terminal, pick Open a terminal in your home folder.

Everything is created in one sheet. At the top, pick what you need: New, Existing folder, Clone from GitHub, Empty workspace or Chat.

Empty workspace fits when you only want terminals: a folder and agents are optional there. Its button is Create workspace.

On New, give the project a name and a description. The Create on GitHub switch creates the repository on GitHub right away.

Under Terminals, Agents and Layout choose how many terminals to open, which agents to start and how to lay out the panes. Then click Create project.

Pick Existing folder and, under Project folder, click Choose… or My projects…. Then Open project.

To take a repository from GitHub, pick Clone from GitHub and click Clone and open.

Projects with a folder, new, existing or cloned, sit under Projects. Workspaces without a folder sit under Workspaces. The plus next to each header opens the same sheet.

Under each workspace you see its panes and their state: Working, Ready, Asleep. A hand next to a row means an agent is waiting for you.

The three dots at the top right open the Workspace menu. It holds Rename, Duplicate, Sessions… (⌘Y) and Sleep workspace.

You close a workspace or a project from there too.