Help Center · Getting started

Install the agent

Download the WorkMonitor agent for your computer, sign in, and grant the permissions it needs so your work starts being tracked.

Who this is for

Anyone getting a machine tracking for the first time. The download screen itself has no permission gate. Any signed-in member can reach it and enroll their own device.

Before you start

You'll need to already be signed in to WorkMonitor. The download screen lives inside your dashboard. macOS is in Private beta; Windows and Linux are still In development. If no build is published for your system yet, the screen says so.

All three desktop apps sign in through your browser now — Mac, Windows and Linux — and the screen says so under Signing in for whichever build you've selected. Email and password, and an enrollment token, are still there under Other ways to connect.

Steps

Open Settings, then select Get the agent under Monitoring.
WorkMonitor detects your machine and shows a Detected badge next to it. If it's wrong, or you want a different build, select a chip under Install on another OS: macOS · Apple silicon, macOS · Intel, Windows, or Linux.
Select Download for your OS (for example, Download for macOS · Apple silicon). The version, file format, size, and whether the build is Code-signed show underneath the button.
Open the downloaded installer and follow the numbered steps on the screen, which describe the build you were actually given. The last one signs the machine in: select Sign in with your browser, finish on the page that opens, and confirm the name the app shows you when the browser hands it back. It registers this machine to you automatically — there's nothing to copy across. A machine you reach over SSH takes the same sign-in with a typed code; see Connect a server over SSH.
Under Grant permissions, follow the guide for your OS. On macOS, enable Screen Recording and Accessibility for WorkMonitor in System Settings → Privacy & Security, then quit and relaunch the agent.
Optionally, under Browser extension, add it from your browser's store — Add to Chrome, Add to Edge or Get it for Firefox. It reports the active site (bare domain only) that the desktop agent can't see, and enrolls as its own device under your account.
Scroll to Your devices and confirm your machine shows Connected.

What happens next

Your device appears in Your devices as soon as it is registered — the moment you generate an install token, or the moment you choose Connect in your browser — showing Awaiting install, and flips to Connected as soon as the agent or extension enrolls and phones home. Through the browser those two moments are seconds apart, so you may never see Awaiting install at all. Despite its heading, Your devices isn't limited to your own machines. It shows every device enrolled anywhere in your workspace, so you'll see your teammates' devices there too.

The page can't read your machine's OS permission state directly. It only shows whether a build has connected, not whether Screen Recording or Accessibility are actually granted. Use the permission guides on the page as the source of truth for what to check.

If it doesn't work

If the installer for your OS isn't published to this workspace yet, the download button is replaced by a note saying so.
If Your devices won't load, you'll see "Couldn't load your devices right now."
Before anything is installed, Your devices reads "No devices yet. Download the agent above and connect it. It appears here the moment it connects."
On Windows, expect a SmartScreen warning on first launch since the beta build isn't code-signed yet. Choose More info → Run anyway.

Sign in with your browser
Connect a server over SSH
Install the browser extension
What WorkMonitor does (overview)
Set up your workspace