The Desktop Application#

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

Screenshot of the three main views in the Desktop App: Main Locations, Single Location, and Project.

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#