Desktop app
The macOS and Windows app. Register your computer as a device and tasks can run on it directly.
The desktop app is the same ClawsGO with one addition: it can register your computer as a device. Tasks can then run on this computer, reading and writing local files and running local commands. It is available for macOS and Windows (x64).
Install
Download
Visit the download page. On a Mac, choose the build for your chip, Apple silicon or Intel, then open the dmg and drag ClawsGO into Applications. On Windows, run the downloaded exe; setup finishes on its own and opens the app. If Windows shows "Windows protected your PC", choose More info, then Run anyway.
Sign in
The app never shows a sign-in form. Click "Sign in with your browser", sign in to the global edition there, and the app picks it up. If it does not switch back on its own, paste the sign-in code shown in the browser into the app. Codes are valid for 3 minutes.
Register the device
After you sign in, the app registers this computer as a device on its own: the device is named after your computer and the workspace folder is ~/ClawsGO (project files for your tasks live there). A "This computer is connected" notice appears in the corner when it is done. The device credential is stored in ~/.clawsgo on this computer, readable by your user only.
If automatic registration fails you will see a notice; open the Hosts page in your personal space and click "Connect this computer" in the sidebar to register by hand. To use a different workspace folder, click "Disconnect this computer" first, then register manually and pick the folder.
Once registered, the app runs a background service. Its state shows on the "Local connection" row in the device's Settings on the Hosts page, with a "Restart" button when it is not running.
Running tasks on this computer
In the desktop app, new tasks run on this computer by default, and new projects are created on it too. To switch to the cloud host, use the host selector above the composer; your choice is remembered. How tasks on a local device differ from tasks on a cloud host:
| Cloud host | Local device | |
|---|---|---|
| Keeps running | Even when your computer is off | Only while this computer is on and online |
| Desktop view | Viewable and controllable from the Host tab | Cannot be viewed remotely |
| Desktop automation | Yes | No |
| File menu | Adds "Reveal in folder" and "Open in VS Code" |
Using this computer in a shared team
A device belongs to your personal space. To run a shared team's tasks on it, open that team's Hosts page and click "Add local device" in the sidebar.
Disconnecting and switching computers
- Disconnect this computer: in the device's Settings on the Hosts page. The credential is revoked and the device is removed from all teams along with its projects and tasks. This cannot be undone.
- New computer: install and sign in there and it registers itself. Disconnect the old device whenever you like. A computer you have disconnected is not registered again automatically; connect it by hand when needed.
- "The device configuration saved on this computer is no longer valid": the device was removed or its credential revoked elsewhere. "Clear local configuration" lets you register again.
- "This computer is connected elsewhere, this process has exited": the same device credential was started somewhere else. Check whether the app is installed twice.
Automatic updates
The app checks for updates on launch and every 4 hours after that, downloading in the background. When a download finishes the app shows a prompt; click "Restart to update" to install right away. On Mac, if you leave it, the update installs the next time you quit the app. On Windows the update installs only after you click it. It takes two to three minutes, shows an install window, and reopens the app when done. The background service updates with it.
If the app won't open after a Windows update was interrupted (for example by a shutdown), reinstall it from the download page. Your sign-in and local settings are kept.
If you see "Desktop app is out of date, update and restart", click "Restart to update" in the app. If no prompt shows, quit and reopen the app.
When the server requires a newer minimum version (a protocol change or an important fix), the app shows an update dialog that cannot be dismissed and downloads the update in the background. Click "Restart to update" once the download finishes to continue, or download and install manually from the link above.