Alpha prerelease. PI Desktop is a GUI frontend for the PI coding agent — install PI first.
Highlights
-
Fix app data folder consistency across Linux, macOS, and Windows. The app now uses a single canonical data folder per platform instead of several divergent ones:
- Linux:
~/.config/pi-desktop - macOS:
~/Library/Application Support/pi-desktop - Windows:
%APPDATA%\pi-desktop
Existing settings/sessions/tags are migrated automatically (no overwrite). Old folders (e.g.
~/.pi-desktop-gui,~/.config/PI Desktop) are left in place — you can delete them manually once you've confirmed the new folder has your data. - Linux:
Downloads
| Platform | File | Notes |
|---|---|---|
| Linux | PI-Desktop-0.0.4-alpha-linux-x86_64.AppImage
| chmod +x then run
|
| Windows | PI-Desktop-0.0.4-alpha-win-x64-setup.exe
| Installer (recommended) |
| Windows | PI-Desktop-0.0.4-alpha-win-x64.exe
| Portable, no install |
| macOS | PI-Desktop-0.0.4-alpha-mac-arm64.dmg
| Apple Silicon only |
| macOS | PI-Desktop-0.0.4-alpha-mac-arm64.zip
| Zipped .app (alternative to dmg)
|
⚠️ macOS — required steps to run
These builds are not signed or notarized, so macOS Gatekeeper blocks them on first launch ("Apple could not verify… is free of malware").
- Apple Silicon only — no Intel (x64) build yet.
- To allow the app:
- Open the
.dmg, drag PI Desktop to Applications, try to open it once — macOS blocks it, click Done. - Open System Settings → Privacy & Security.
- Scroll to the Security section → "PI Desktop was blocked…" → click Open Anyway → confirm with Touch ID / password.
- Open the app again. One time only.
- Open the
- If the
.zipsays the app is "damaged and can't be opened," clear the quarantine flag:xattr -dr com.apple.quarantine "/Applications/PI Desktop.app"
⚠️ Windows — required steps to run
These builds are unsigned.
- SmartScreen may warn on launch — click More info → Run anyway.
- Controlled Folder Access (Ransomware protection): if file edits/saves fail with permission errors, Windows is blocking writes to protected folders. Either keep code projects out of
Documents/Desktop(e.g.C:\dev), or allow the app via Windows Security → Virus & threat protection → Ransomware protection → Allow an app through Controlled folder access. - Prefer the installer over portable if you rely on the allow-list — portable re-extracts to a temp folder each launch, so an allowance won't stick.
Linux
chmod +x PI-Desktop-0.0.4-alpha-linux-x86_64.AppImage
./PI-Desktop-0.0.4-alpha-linux-x86_64.AppImageFound a bug? Please open an issue.