Desktop app
The desktop app is an Electron window around the local service, in
apps/desktop. It holds no Mob logic of its own: the window shows the same web
UI the service serves to a browser.
Install
Section titled “Install”Download an installer from the
releases page (mob is bundled
inside, so no separate CLI or Node.js installation is needed):
- macOS (
arm64andx64): openmob-desktop-VERSION-mac-ARCH.dmg(or extract the.zip) and drag Mob into/Applications. - Windows (
x64): runmob-desktop-VERSION-win-x64.exe. - Linux (
x64andarm64): installmob-desktop-VERSION-linux-amd64.debor-arm64.deb(sudo apt install ./mob-desktop-VERSION-linux-amd64.deb), or markmob-desktop-VERSION-linux-x86_64.AppImageor-arm64.AppImageexecutable (chmod +x) and run it.
Packages are not signed or notarized yet, so macOS and Windows block the first launch:
- macOS: try opening Mob once and click Done, then open
System Settings → Privacy & Security and click Open Anyway next to
Mob (or clear the quarantine attribute with
xattr -cr /Applications/Mob.app). - Windows: in the SmartScreen prompt, click More info, then Run anyway.
Installers are listed in SHA256SUMS and attested for gh attestation verify
(see Install).
To upgrade, run mob stop (or stop the running service) before launching the
new version so the background service restarts with the updated bundled mob
binary.
How it connects
Section titled “How it connects”- On launch the app runs
mob connection. That command starts the background service when it is not running (the same asmob start) and prints its loopback URL and access token as JSON. The window then loads that URL. - The service outlives the window, so closing Mob leaves channels, schedules and
coding agent tasks running.
mob stopstops it. - The page reaches Node only through
window.mobDesktop.connection(), which runsmob connectionagain; a reloaded window followsmob token rotate. The renderer runs with context isolation and the Chromium sandbox, without Node integration. - When the service cannot start, the window shows the reason instead of the workspace.
- Links to other sites open in the system browser; the window only shows Mob.
Window and tray
Section titled “Window and tray”- One instance runs at a time; opening Mob again focuses the window.
- The tray (menu bar on macOS) icon reopens the window. Closing the window hides it while the tray is present; Quit exits the app and leaves the service running.
Which mob it runs
Section titled “Which mob it runs”MOB_BINARY names the binary; otherwise the app uses the one packaged in its
resources (bin/mob), then mob on PATH.
Building
Section titled “Building”bun run desktopbuilds the CLI and opens the window against it.bun run build:desktopcompilesmobintoapps/desktop/bin/<arch>/(or stagesMOB_BINARY, or--x64/--arm64inscripts/stage.ts) and writes the icon, then runs electron-builder: a DMG and zip on macOS, an NSIS installer on Windows, AppImage and deb on Linux, inapps/desktop/release/.- The
desktopjob of the release workflow packages the release’smobbinaries for macOS (x64,arm64), Linux (x64,arm64) and Windows (x64) using the release’s SemVer, attests provenance and attaches them to the GitHub release, andchecksumsadds them toSHA256SUMS. Packages are not signed or notarized yet.