The Desktop Application#
The Desktop Application installed on your local system as the primary UI.

Overview of the Desktop App#
Supported Operating Systems:
Available for Windows, macOS, and Ubuntu (22.04 or 24.04).
Not supported on other Linux distributions.
Key Functions:
Manage locations – Includes your local system and any remote locations you connect to.
Manage projects – Includes code, environments, files, and applications within each project.
Views and Tabs:
Main Locations Window – Displays and manages your local and remote locations.
Single Location Window – Shows and manages projects within a selected location.
Project Tab – A dedicated tab in the Single Location Window for managing an individual project.
Example Workflow:
Open the Desktop App to the Main Locations Window.
Select a location to open the Single Location Window.
Choose a project, opening the Project Tab within the Location Window.
Start an application installed in the project.
Manage Locations and Projects Through Views and Tabs#
Managing Locations#
The Main Locations View (window) is where you manage locations. It has only a few actions:
Open an existing Location view by clicking on the location name.
Edit or delete the SSH connection for an existing remote location.
Add a remote location.
The Single Location View (window) is not for managing the location.
It displays the projects in a specific location.
It does not allow any direct actions on the location itself, aside from closing the window.
Note
You can have multiple Main Location and Single Location Windows open simultaneously.
Managing Projects#
The Single Location view lists the projects available in the location and allows you to:
Open a project by clicking on its name.
Delete or share a project by clicking the ⋮ (vertical dots) button on the right side of the project name.
Create a new project by clicking the New Project button.
Clone an existing project by clicking the Clone Project button.
The Project Tab provides a detailed view of a specific project and it is where you:
Start and stop installed applications.
Add and remove applications.
Modify the project environment.
Add, delete, and edit files.
Manage Git version control, including committing, pushing, and pulling changes.
Note
For a full explanation of the Project Tab, see AI Workbench Projects.
FAQs#
Common questions on the Desktop App#
Do I install the Desktop App on the remote system?#
No. The Desktop App is only installed on your local system.
You use the CLI to install Workbench on a remote system.
Do I install the Desktop App on more than one local system?#
Not a great idea. You can do this but it leads to a confusing user experience.
Next Steps#
Do a Quickstart
Learn the Concepts