Repository navigation
Releases
Pi Desktop 0.15.0
Fixes
- Retry resends a failed prompt. When a send fails, Retry on the error row sends the same prompt again (with its images) instead of only reopening the chat. A new prompt clears an old error row.
- The context ring stays current. It updates after every turn of a long run and as soon as a chat opens, not only when the run ends. The same goes for the percent and stats on Pi Remote.
- Diffs show everything:
- files inside new folders;
- untracked binary or very large files, as "Binary file" or "File too large to show";
- pure renames, as renamed with no content changes;
- paths with spaces, accents or emoji, shown as they are. These also open on the phone.
- Sessions: empty or broken session files no longer show up as untitled chats, and a chat whose name is only spaces is titled "Untitled".
- Missing folders: a chat whose project folder was deleted says "This folder no longer exists on the computer" instead of a raw error.
- Clearer errors everywhere, without the internal "Error invoking remote method" prefix, and a specific reason for a branch name git rejects.
- Remote control: a phone that just disconnected shows the right "last seen" time.
Versions
- Pi Desktop 0.15.0 (Mac:
mac-arm64for Apple Silicon,mac-x64for Intel; signed with a Developer ID and notarized by Apple). - Pi Remote 0.5.0 for Android (
Pi-Remote-0.5.0.apk). Install it over 0.4.x; it is signed with the same key. - pi-remote 0.15.0 (
pi-remote-host-0.15.0.tgz). Update withpi-remote update.
Pi Desktop 0.14.0
Branches and worktrees
- Branch menu: the branch chip in the chat header (desktop) and "Branches and worktrees" in a chat's or project's menu (Pi Remote) list the repository's branches (ahead/behind, last commit), remote branches and worktrees, including ones made outside the app. Typing searches every branch on the computer.
- Switch this folder to a branch; a remote one (
origin/x) gets a local tracking branch. A branch checked out in another worktree takes you to that worktree's chat instead. - Create a branch from the current one and switch to it, or open a new worktree chat on a new branch with the name you typed, or on any existing branch.
- Safe by default: no branch switch while a chat in that checkout is running, running a command or waiting on you, whether you ask from the window or a phone. Git's own refusal names the files in the way.
- Removing a worktree can delete its branch too, only when it is merged; the message says how to bring it back. Chats that were open there are closed first. A forced removal moves the folder, uncommitted files and all, to the trash.
- Every window and phone rereads its branch as soon as one changes.
Pi Remote 0.4.0 (Android)
The branch and worktree sheet above, from a chat's menu and from a project's, plus "Remove worktree and its branch…". Install Pi-Remote-0.4.0.apk over 0.3.x; it is signed with the same key. It needs Pi Desktop or pi-remote 0.14.0 for the branch sheet.
pi-remote 0.14.0
The same branch and worktree handling for phones paired with a server. Update with pi-remote update, or npm install -g ./pi-remote-host-0.14.0.tgz.
Install
- Mac:
mac-arm64for Apple Silicon,mac-x64for Intel. Signed with a Developer ID and notarized by Apple. - Android:
Pi-Remote-0.4.0.apk.
Pi Desktop 0.13.0
Review together
- Pick the reviewer: Review on the diff now asks which model to use: the chat's own, or any other model pi offers, so a second model can check what the first one wrote. On the desktop and on your phone.
- Shared comments: your line comments and pi's review remarks are kept by the computer per project. The window and every paired phone show the same list as it changes, and nothing is lost when a screen closes. A commit clears them, discarding a file clears that file's, and handing them to pi removes them.
- Post to the pull request: "PR" in the diff toolbar (desktop) and "Post to PR" (Pi Remote) post the comments to the branch's pull request as one GitHub review signed pi-bot. A comment whose line is in the PR goes on that line; comments on lines you have not pushed yet are listed in the review's summary. Posted comments leave the list.
Posting as a bot account
By default the review is posted as the account gh uses. To post as a separate bot account:
- Sign it in to gh as well (
gh auth login). gh makes a newly signed-in account the active one, so switch back to yours afterwards:gh auth switch --hostname github.com --user <your account>. - Pi Desktop: Settings → General → PR comments account. pi-remote:
"github": {"commentAccount": "<bot>"}in~/.config/pi-remote-host/settings.json, then restart it.
The bot's token is handed to gh's own process only; the app never stores or logs it.
Pi Remote 0.3.0 (Android)
- Choose the model for a review; comments shared with the computer's window and other phones; Post to PR.
- Settings → About shows the right version.
Install Pi-Remote-0.3.0.apk over 0.2.x; it is signed with the same key. Shared comments and Post to PR need Pi Desktop or pi-remote 0.13.0; with an older computer, comments stay on the phone's screen as before.
pi-remote 0.13.0
- Shared comments and posting to pull requests, as in Pi Desktop.
- Update:
pi-remote update, ornpm install -g ./pi-remote-host-0.13.0.tgz.
Pi Desktop 0.13.0
- Everything above. The diff toolbar's buttons wrap onto a second row in a narrow panel instead of running out of it.
Install
- Mac:
mac-arm64for Apple Silicon,mac-x64for Intel (both are back in this release). Signed with a Developer ID and notarized by Apple. - Android:
Pi-Remote-0.3.0.apk.
Pi Desktop 0.12.0 · Pi Remote 0.2.0 · pi-remote 0.12.0
Images for you
- Ask pi to show you something and it does. The new
show_imagetool puts an image file (a screenshot it saved, a chart it drew, a rendered page) in front of you with a caption, on the desktop and on your phone. It works in Pi Desktop and in pi-remote alike. - Screenshots stay visible under folded steps and work groups, so you no longer have to open each step to find them.
Pi Remote 0.2.0 (Android)
- Several computers: your Mac, a VPS, a home server. Switch from Settings, or tap the computer's name at the top. Your existing pairing carries over.
- Images: full screen, actual size, share or save.
- Attachments: send any file up to 20 MB (pi reads it on the computer) or paste an image from the clipboard.
- Files: syntax highlighting in the file viewer and previews for project images.
localhostlinks open at the computer's address. - Long chats: load page by page as you scroll up. Opening a chat shows loading and retry states.
- Chat tools:
/treeshows the session's branches; share a chat as a web page; Retry under the last reply. - Pull requests: the PR number and its checks appear in the chat header and tell you when they finish.
- Computer use: turn it on or off from the composer.
Install Pi-Remote-0.2.0.apk over 0.1.x; it is signed with the same key.
pi-remote 0.12.0
- New commands:
pi-remote doctorchecks the whole setup and says what to fix.pi-remote logs -f,pi-remote updateandpi-remote service uninstall. - Installing or updating:
npm install -g ./pi-remote-host-0.12.0.tgz, or runpi-remote updateon an existing install. Requires Node.js 22.19 or newer.
Pi Desktop 0.12.0
show_imageand screenshots under folded steps./treeindents only where the session branches.- Computer use toggled from a paired phone shows up in the window right away.
Only the Apple Silicon (arm64) build is attached to this release. The Intel build could not be notarized tonight and will follow.
Pi Desktop 0.11.1 · pi-remote · Pi Remote 0.1.1
Pi Desktop 0.11.1
- Computer use fixes. A chat could fail every browser and computer tool with "Invalid bridge token" after the warm spare was replaced. Bridge tokens now belong to pi processes.
- Reset permissions. If Accessibility or Screen Recording is switched on but still not granted (the entry belongs to an older build), use Settings → Computer use → Reset permissions and grant both again.
- A recycled computer-use helper no longer cancels the requests of its replacement.
pi-remote (new)
Remote control without the desktop app, for a VPS or a home server. Install pi-remote-host-0.11.1.tgz with npm install -g (Node 22.19+). Then run pi-remote service install --host <address>, systemctl --user enable --now pi-remote and pi-remote pair. Guide: docs/pi-remote.md.
Pi Remote 0.1.1 (Android)
- Several computers. Pair Pi Desktop on your Mac and pi-remote on your servers, then switch between them in Settings. Your existing pairing carries over.
- The app tells you whether the host is Pi Desktop or pi-remote.
Install Pi-Remote-0.1.1.apk over 0.1.0; it is signed with the same key.
Pi Desktop 0.11.0
New
- Remote control. Pair your phone with a QR code (Settings → Remote control → Show pairing code) and drive Pi Desktop from Pi Remote, the new Android companion app: follow and steer chats, answer pi's questions, review, commit and push changes, manage automations. The phone connects straight to your computer over your network (the same Wi-Fi, or a VPN such as Tailscale); there is no account and no relay, and everything between the two is end-to-end encrypted. Remote control is off until you turn it on. How it works
- Pi Remote 0.1.0 for Android (
Pi-Remote-0.1.0.apkbelow). Streaming chats with tool steps, diffs and screenshots;@files,/commands,!shellruns and photos in the composer; model and thinking effort; fork, retry and restore files; side chat; changes with line comments, pi's review, commit and push; pull requests; projects and worktrees; automations; usage. With notifications on, it stays connected while pi works and tells you when a chat finishes or pi needs you, also with the app in the background. More - One chat, two screens. A chat open on the computer and on the phone is the same chat: both see the same stream, and a question answered on one closes on the other.
Notes
- A paired phone can do what the window can with a chat, including running shell commands in your projects through pi. Pair only your own devices, and remove a lost phone under Settings → Remote control.
- Pi Remote was built and exercised on an Android emulator against Pi Desktop (pairing, streaming, changes, side chat, reconnecting after losing the network, background notifications). It has not been through wide testing on physical phones yet; treat 0.1.0 as an early release and report what breaks.
- Background notifications cover runs that start while the app is on screen; there is no push server, so nothing arrives after the app is swiped away.
Install
- Mac: download the DMG for your Mac:
mac-arm64for Apple Silicon,mac-x64for Intel. Builds are signed with a Developer ID and notarized by Apple. - Android: download
Pi-Remote-0.1.0.apkand open it on the phone (Android asks once to allow installing from that source). It needs Pi Desktop 0.11.0.
Pi Desktop 0.10.1
Changed
- The hint row under the home screen's composer ("/ commands · @ files · ⌘K palette · ⌃
terminal") is gone. The composer's placeholder already names/and@`.
Install
Download the DMG for your Mac: mac-arm64 for Apple Silicon, mac-x64 for Intel. Builds are signed with a Developer ID and notarized by Apple.
Pi Desktop 0.10.0
New
- Checkpoints. In a git project, Pi Desktop snapshots the files before every prompt. Hover a prompt and choose "Restore the files" to put the project back to how it was before it; files created since go to the Trash, and the restore itself can be undone. Nothing is committed or staged and your index is never touched. The conversation is not rewound: "Edit & resend" still does that.
- Review. "Review" in the diff toolbar has pi read your uncommitted changes in a separate process and pin its remarks to the lines they are about. They sit beside your own comments (pi's have a blue edge) and go to the composer with them as one prompt.
- Side chat. ⌘; or
/btw <question>asks a question in a side-panel tab. pi answers with the chat's context, and nothing asked there is added to the chat.
Notes
- All three were tested against a real pi: a checkpoint restored an overwritten file, the side chat recalled something said in the main chat, and the review flagged a planted bug on the right line.
- The review and the side chat use the chat's model and cost tokens like any other prompt.
Install
Download the DMG for your Mac: mac-arm64 for Apple Silicon, mac-x64 for Intel. Builds are signed with a Developer ID and notarized by Apple.
Pi Desktop 0.9.0
New
- Automations. Give pi a prompt, a project and a schedule: daily at a time (optionally weekdays only) or every N minutes or hours. Open them from the sidebar or ⌘K. Each run is an ordinary chat that starts in the background, shows under Active on the home screen and notifies you when it is done. Automations run while Pi Desktop is open; a run missed while it was closed happens once when it opens.
- Pull requests. When the project's branch has a pull request, the chat header shows its number and the state of its checks. The popover lists the checks and "Ask pi to fix" drafts a prompt with the failing checks and the end of the failed job's log. "Fix failing checks automatically" sends that prompt itself, once per commit, while the chat is on screen. This uses your own GitHub CLI (
gh); without it, or without a pull request, nothing is shown. - Pull request tab. "Open in panel" (or the panel's new-tab page, or ⌘K) keeps the pull request in the side panel: every check, a link to each, and the log of a failed GitHub Actions job unfolded in place.
Notes
- Checks are re-read when a run settles, when the window regains focus, and once a minute only while some are still running.
- The queue strip and
!commandfrom 0.8.0 have now been tested against a real pi.
Install
Download the DMG for your Mac: mac-arm64 for Apple Silicon, mac-x64 for Intel. Builds are signed with a Developer ID and notarized by Apple.
Pi Desktop 0.8.0
New
- Worktree chats. "New Chat in a Worktree" (project menu or ⌘K) gives a chat its own git worktree on a fresh
pi/…branch, so several chats can change the same project in parallel without touching each other's files. Remove a worktree from its project menu; the branch and the chat history stay. - Review on the diff. Hover a diff line and press
+to comment. "N comments" puts them in the composer as one prompt, each with its file, line and the quoted line. Per file you can open it or discard its changes (untracked files go to the Trash). Commit everything and push from the diff toolbar. - File viewer. Open a file from any read / edit / write step, or from the diff, in a read-only, syntax-highlighted panel tab.
- Usage. Settings → Usage shows the last 30 days of cost, requests and tokens by day, model and project.
!command. Start a line with!to run a shell command in pi; the output streams into the chat and joins the next prompt.- Queue strip. Messages sent while pi is working wait above the composer ("Steer" lands after the current tool call, "Next" when the run ends). "Edit" pulls them back.
- Search inside conversations. ⌘K searches the text of every chat and lands on the match.
- Project at a glance. The chat header shows the git branch and the working tree's changes, and opens the project in Finder, a terminal or an installed editor.
- Active chats on the home screen: the ones working, waiting for you, or with an unread reply.
Chat
- Edits render as a unified diff: removed and added lines interleaved with context. New files show as added lines.
- Each turn shows its output tokens and cost. A compaction notice unfolds its summary.
- Images in messages and tool results open in a full-window viewer.
- The composer keeps an unsent draft per chat (it used to carry its text into the next chat) and recalls earlier prompts with ↑ / ↓.
- Esc twice stops a run. ⌃Tab cycles the open chats, ⌥↑ / ⌥↓ steps through prompts.
- "Copy chat as Markdown" in ⌘K.
Notes
- 0.7.0 was merged but never released; this release contains it.
- The queue strip and
!commandwere tested against a synthetic pi only. Please report anything odd with a real one.
Install
Download the DMG for your Mac: mac-arm64 for Apple Silicon, mac-x64 for Intel. Builds are signed with a Developer ID and notarized by Apple.