Installing Zenborg on Windows

Follow this guide to install, activate, and configure Zenborg on Microsoft Windows.

Zenborg supports Windows 10 (version 21H2 or later) and Windows 11 on x64 systems.

---

1. Download and Installation

You can install Zenborg using either the Microsoft Store or the standalone Windows installer.

Method A: Microsoft Store (Recommended)

1. Open the Microsoft Store app on Windows.
2. Search for Zenborg.
3. Click Get or Install.
4. The Store downloads and installs Zenborg with automated background updates.

Method B: Standalone Installer

1. Visit zenborg.com and submit your work email address.
2. Download the Zenborg-Setup.exe installer from the link in your email.
3. Run the installer and follow the setup wizard.

Handling Windows SmartScreen

If Windows SmartScreen shows a prompt stating “Windows protected your PC”:

1. Click the text link More info.
2. Click the button Run anyway.
3. Allow the installer to complete setup.

---

2. Beta Activation

1. Launch Zenborg from your Start Menu.
2. Open the Settings dialog (#settingsDialog) using the gear icon.
3. Scroll to the Licence section.
4. Paste your beta key starting with ZB1… into the key input field.
5. Click the button labeled "Enter licence key".
6. Your install activates Pro features valid through 2026-11-30T23:59:59.000Z (BETA_END).

---

3. Windows Architecture and Runtime Specifics

Windows handles processes, resources, and credentials differently from POSIX systems. Zenborg adapts to these differences automatically.

Process Lifecycle and Tree Cleanup

When stopping or cancelling a loop stage on Windows, child processes (such as Node.js test runners, Git commands, and compiler daemons) cannot be stopped with standard POSIX signals.

Zenborg terminates process trees cleanly on Windows using:

taskkill /T /F /PID <pid>

This command stops the parent agent process and all child workers, preventing orphaned processes from consuming CPU or RAM in the background.

System Load-Gating on Windows

On macOS and Linux, Zenborg monitors 1-minute, 5-minute, and 15-minute system load averages using os.loadavg().

On Windows, os.loadavg() always returns [0, 0, 0]. To protect your computer from overload:

• Zenborg bypasses CPU load checks on Windows.
• The engine relies strictly on system free memory percentages.
• The default limit is MIN_SYSTEM_FREE_PERCENT = 8. If available RAM drops below 8%, Zenborg pauses queue dispatching until memory frees up.

Credential Storage

On Windows systems without hardware keyring integration, Zenborg saves encrypted credentials in the user profile directory using restricted file permissions (mode 0600), accessible only by the current Windows user account.

---

Next Steps

Now that Zenborg is installed, connect your CLI agents:

• Proceed to Connect Your Agents.