The Desktop Agent is the signed Windows/macOS app for running the HookDeploy agent from your system tray (Windows) or menu bar (macOS). Download it from the Download Agent control on the Agents page in the dashboard — the page offers the Windows installer and macOS disk images for Apple Silicon and Intel.
- Run the downloaded installer.
- If Windows shows “Windows protected your PC” — click More info, then Run anyway. Expected for newly-signed software; it fades as more people install it.
- Complete the installer.
- Look for the HookDeploy icon in your system tray, bottom-right — click the ^ arrow if it’s hidden.
- Click it, then Login to connect your organization.
- Open the downloaded .dmg and drag HookDeploy Agent to Applications.
- Open HookDeploy Agent from Applications. macOS will ask if you’re sure you want to open an app downloaded from the internet — click Open. Normal for any downloaded app, not a security warning about this one.
- A window will appear the first time explaining the app lives in your menu bar (top-right) — there’s no Dock icon, so this is the one time it’ll show itself automatically.
- Click the menu bar icon, then Login to connect your organization.
What’s included
The Desktop Agent runs the same underlying agent as the CLI and keeps it connected in the background. You can start taps from the app UI (including picking a local listening port) without typing commands. The CLI binary is still available on the machine for scripting and the full CLI reference.
Next: Using taps.