Pi Agent Desktop icon Pi Agent Desktop
English
简体中文EnglishFrançaisDeutschEspañol日本語한국어繁體中文

Download Pi Agent Desktop

Pi Coding Agent 1.2.0 and Herdr v0.8.2 are included. You do not need to install Pi CLI, Node.js, or npm separately—just configure a model provider.

Windows

Windows 10 / 11 · 64-bit (x64)
Unsigned Beta · No 32-bit or ARM64 build

Download unsigned Beta
NSIS installer (.exe) · Unsigned
v0.4.1 · x64

Linux

64-bit Linux (x64)
AppImage · ARM64 is not yet available

Download AppImage
Make the file executable after downloading
v0.4.1 · x64 · AppImage

On Windows, open Settings → General → Default Agent shell and choose PowerShell or Bash. New sessions default to PowerShell; this setting only affects newly created sessions.

Learn how to use it

Install on macOS

  • Open the DMG and drag Pi Agent Desktop to Applications
  • Release builds are Apple-signed and can be opened directly
  • You can also extract the ZIP archive and move the app to Applications
  • A verified Herdr v0.8.2 runtime is bundled, so Managed mode needs no separate download

Install on Windows

  • The Windows installer is an unsigned Beta without Authenticode code signing
  • Windows may show an Unknown Publisher or SmartScreen warning
  • Confirm the installer came from GitHub Releases, then choose Run anyway
  • Managed background processes require Windows 11 x64; other desktop features remain available on Windows 10
  • Windows x64 now bundles Herdr v0.8.2 with Fleet, Agent control, and Job Object-contained terminals

Install on Linux

  • Download the x64 AppImage
  • Run chmod +x Pi-Agent-Desktop-*.AppImage to make it executable
  • Updates are currently manual; download the new version here and replace the old file
  • A verified Herdr v0.8.2 runtime is bundled, so Managed mode needs no separate download

Updating

  • macOS: check for stable updates automatically or manually in the app
  • Windows: check, download, and install stable updates in the app
  • Linux: AppImage updates are currently manual

Looking for older versions, blockmaps, update metadata, the Windows SBOM, or third-party notices? Visit GitHub Releases.