guide

Prime Agent on Windows and WSL: caveated guidance

Prime Intellect's primary installer targets macOS and Linux; Windows runs best inside WSL2 with a Linux filesystem and Node.js available. Path separators, shell behavior, and kernel bootstrap differ from native Windows, and some daemon lifecycle issues remain open. Follow the upstream Windows notes for current limitations.

v v0.7.1reviewed 2026-08-09evidence officialsources S023, S005, S003cutoff 2026-08-09

S023 S005 S003

Home →

First-party announcement, documentation, release, or installer.

Official platform scope

macOS and Linux are the primary install targets. Windows support is caveated because shell behavior, path semantics, and daemon life-cycle differ under native Windows.

WSL2 install path

# inside WSL2
node --version
prime-agent --version

Filesystem caveats

Prefer a Linux filesystem inside WSL2. Native Windows paths, terminal emulators, and line-ending conversions can break session or skill resolution.

Kernel and daemon notes

Kernel recovery and daemon restart behavior are less battle-tested on Windows than on macOS/Linux. Verify the simple cases before you depend on background work.

Upstream Windows notes

Use the upstream Windows notes to check the current state of support. Because this is a 0.x release line, the details can move quickly.