Skip to main content

GUI Desktop App

The desktop app provides a visual way to record and replay automations.

Installation​

cd Clients/GUIApp
npm install
npm run dev    # or npm run build && npm run preview for production

We recommend packaging with a codesigned binary before distributing to other teammates.

Sign in & Licensing​

Sign in with the same credentials you use for the web portal. The first successful login activates a device license. If you hit the device limit, visit Account → Licenses in the portal to deactivate a previous machine.

Key features​

  • Record automations via the toolbar. Capture selectors and annotate steps.
  • Play back saved automations from the sidebar.
  • Inspect UI state to debug selectors while recording.
  • Manage scripts: duplicate, export, or share flows with teammates.

Troubleshooting​

  • Keychain prompts: sign the packaged app with a stable certificate and approve access once.
  • Device limit exceeded: deactivate unused devices in the portal. Trial licenses allow one device, yearly plans allow three.
  • App cannot control UI: ensure the app is listed in System Settings → Privacy & Security → Accessibility.