← Back to Launcher

🛡️ Watchr Agent Setup

One-time install. Paste a single command into Terminal or CMD.

Checking for agent...
🍎 macOS
🪟 Windows
🐧 Linux
1
Open Terminal
Press ⌘ + Space, type Terminal, press Enter.
2
Paste this command
Click the Copy button, then paste into Terminal with ⌘V and press Enter.
Terminal
3
Done
The agent starts immediately and registers the watchr-agent:// protocol. Next time, just click 🚀 Launch Agent on the launcher page.
What this does: Downloads agent.js from this server, saves it to ~/.watchr-agent/, creates a WatchrAgent.app that handles the watchr-agent:// protocol, registers it with macOS Launch Services, and starts the agent. No sudo required.
1
Open PowerShell
Press Win + X, then click Windows PowerShell or Terminal.
2
Paste this command
Click Copy, then right-click in PowerShell to paste, press Enter.
PowerShell
3
Done
The agent starts and watchr-agent:// is registered. Next time, click 🚀 Launch Agent on the launcher page.
What this does: Downloads agent.js, saves to %LOCALAPPDATA%\WatchrAgent\, registers the watchr-agent:// protocol in the Windows registry (current user, no admin needed), and starts the agent.
1
Open a terminal
Ctrl+Alt+T on most Linux desktops.
2
Paste this command
bash
3
Done
Agent starts and the URI handler is registered for GNOME/KDE.