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#
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