Scale Intelligence■ Docs
Docs / Start here / The desktop app for Mac and Windows

The desktop app for Mac and Windows.

The desktop app shows the same surfaces as the web app. It adds a long-lived session, files and a terminal, and it bundles the platform's local server at the app's version.

Figure 1Desktop app and local serverspecified
INSTALLERmacOS or Windowssignedupdates with rollbackDESKTOP APPthe web app's surfacessessionfilesterminalLOCAL SERVERat the app's versionon your machineOne image of the platform serves the web app. The desktop app carries its own local server.flows forwardthe result
The installer puts the desktop app and its local server on your machine, at one version.The desktop app and its local server always share one version.

The desktop app shows the web app’s surfaces in a native window. It adds what a browser lacks: a session that lasts across restarts, a workspace of files, a terminal, and the local server beside the app.

Installers#

platform installer behaviour
macOS a signed and notarised package installs the app and its local server, and updates through the app’s own channel with a rollback
Windows a signed installer installs the app and its local server, and updates the same way

The team releases the app with the platform, under one version and one receipt. The changelog lists each release. An update changes the local server’s version only together with the app’s version.

Local processes#

The local server starts with the app. It runs these parts:

The acquisition system runs beside the local server as a second process. Pages that you read and files that you drop therefore enter the record from your machine. The page on the local server describes each part.

Files and the terminal#

The files in the workspace belong to the app. The app reads and writes them through the files routes, and the platform does not reach them on its own. The terminal runs the named procedures that the app knows. Each procedure runs as a task, and the app’s journal records its steps.

Claims#

claimstateroute or tool
The files routes, /v1/files/list among them, reach the desktop app's files and workspace.target/v1/files/list