Installing Zenborg on macOS

Follow this guide to install, activate, and configure Zenborg on your Mac.

Zenborg runs locally on macOS 12 (Monterey) and later. It supports both Apple Silicon (M1/M2/M3/M4) and Intel processors.

1. Download and Get Your Beta Key

Visit zenborg.com.
Enter your work email address to receive the download link and beta license key.
Check your inbox for an email containing:
- The macOS disk image download (Zenborg.dmg).
- Your beta license key starting with the prefix ZB1….

2. Install Zenborg

Double-click the downloaded Zenborg.dmg file to mount it.
Drag the Zenborg application icon into your Applications folder.
Eject the disk image from Finder.
Open your Applications folder and double-click Zenborg.

Handling macOS Gatekeeper

If macOS displays a security prompt stating the application cannot be opened:

Open System Settings (or System Preferences).
Navigate to Privacy & Security.
Scroll down to the Security section.
Click Open Anyway next to the notification for Zenborg.
Confirm by clicking Open in the dialog.

3. First Launch and Beta Activation

When you launch Zenborg for the first time, the desktop interface opens. To activate your Pro features during the beta period:

Click the gear icon or open Settings to display the Settings dialog (#settingsDialog).
Locate the Licence section.
In the input field with the placeholder "ZB1…", paste your license key.
Click the button labeled "Enter licence key".
The status badge updates to show an active license.

Beta Validity Period

The public beta grants full Pro capabilities to all verified beta keys. In the codebase, this expiration date is defined by BETA_END:

Beta End Date: 2026-11-30T23:59:59.000Z (November 30, 2026).

Until this timestamp, your beta key unlocks unlimited projects, multiple concurrent loops, higher Agent Power settings, and multiple browser tabs. When the beta period closes, installations fall back to the Free tier unless upgraded.

4. macOS-Specific Features

System Autostart

You can configure Zenborg to launch automatically when you sign in to macOS:

Open the Settings dialog (#settingsDialog).
Under Start systemu, locate the checkbox labeled "Start Zenborg at system login".
Toggle the checkbox on.
Zenborg installs a user LaunchAgent in ~/Library/LaunchAgents/com.zenborg.desktop.plist.

[!NOTE] Below this toggle, the interface notes: “Autostart is available only on macOS.” This background service is disabled on Windows.

Secure Credential Storage

On macOS, Zenborg stores sensitive tokens and provider credentials inside the native macOS Keychain Services. Keys are never saved in unencrypted plain text files on disk.

Next Steps

Now that Zenborg is installed, connect your CLI agents:

Proceed to Connect Your Agents.