Skip to main content
Turn a repository folder into an Aiola workspace, then chat with its files, branches, agents, tasks, and product records in one project context.

​
Ways to add a workspace

​
Open a local folder

1

Open the project picker

Go to Open and select Local project → Browse files.
2

Choose the root folder

Select the repository or new-project folder.
3

Continue setup

Aiola resumes a completed workspace or opens the setup-choice screen.

​
Choose a setup path

​
Clone from GitHub, GitLab, or URL

The Clone from Git card has GitHub, GitLab, and URL tabs. GitLab and URL accept a clone URL and ask for a destination folder next. GitHub repository browsing depends on GitHub CLI. If it is missing, the screen points to github.com/cli/cli; if authentication is missing, it instructs you to run:
In either case, select Use a Git URL instead to continue without repository browsing.

​
Adopt a cloud project

The Your projects card lists existing cloud projects and marks available analytics, logs, feedback, and API-key data. Select Open and choose the local folder to associate with that project. Rename and permanent-delete actions are available from the same list. GUI Lifetime hides cloud-project adoption.

​
Import from the terminal

On macOS:
On Windows:

​
Organize the workspace rail

Use the dashed + button at the bottom of the workspace rail and select New folder. Rename folders, assign folder logos, reorder rail items, and drag workspaces into or out of folders. See Workspaces.