Pi

pi coding agent 的 Mac 桌面端A Mac app for the pi coding agent

pi,在桌面上pi, on the desktop

多个线程并排跑,每处改动都知道是哪个线程做的,另起一个只读的 pi 审查结果,所有会话都能搜。和终端里的 pi 用同一份会话和配置,随时切回终端。 Run threads side by side, see which thread made each change, have a separate read-only pi review the work, and search every session. It shares sessions and settings with pi in your terminal, so you can switch back any time.

curl -fsSL https://pi.flowsrun.com/install.sh | bash

在终端里运行 · Apple Silicon · macOS 11 及以上 · 再运行一次就是更新 Run it in Terminal · Apple Silicon · macOS 11 or later · run it again to update · 下载 .dmgDownload .dmg

Pi 的主窗口:左侧项目树,中间是一个线程的对话和改动的 diff,右侧改动面板按文件夹列出这次改的文件 Pi's main window: the project tree on the left, a thread's conversation and its diffs in the middle, the changes panel listing the changed files on the right

一个项目一个窗口One window per project

像 JetBrains 一样按项目分窗口,也能合并到一起。标签可以拖到别的窗口,或者拖出来单开,正在跑的 pi 不会中断。Like JetBrains: each project gets its own window, or merge them. Drag a tab to another window or out into a new one; the pi running in it keeps going.

改动归属到线程Changes know their thread

改动面板知道每个文件是哪个线程改的,可以只看当前线程的。两个线程改了同一个文件会标出来。勾选文件,直接提交或回滚。The changes panel knows which thread changed each file and can show just this thread's. Files two threads both changed are flagged. Check files and commit or roll them back.

独立审查Independent review

一轮结束后点 Review,另起一个只读的 pi 审查改动并跑命令取证。它看得到你的要求和 diff,看不到 Agent 的推理过程。你挑好条目再交回。Click Review after a turn: a separate read-only pi audits the changes and runs commands for evidence. It sees your requests and the diff, not the agent's reasoning. You pick what goes back.

搜索所有会话Search every session

⌘⇧F 搜所有项目里的提问和回复,终端里跑过的会话也在内。回车直接打开那个线程,并定位到那条消息。⌘⇧F searches prompts and replies in every project, sessions from the terminal included. Enter opens the thread at that message.

分叉与重发Fork and resend

从任意一次提问分叉出新标签,换个方向试;或者改写这次提问后重发。原来的线程不受影响。Fork any earlier prompt into a new tab to try another direction, or edit it and resend. The original thread stays as it was.

终端里的 pi 也看得见Terminal pi, visible too

终端里运行的 pi 会出现在项目树里:在跑、在等你回答,还是空闲。如果你在桌面端打开同一个会话,它会先提醒你。pi sessions running in a terminal show up in the project tree: working, waiting for you, or idle. Open the same session here and you get a warning first.

不弹窗No pop-ups

工具审批、Agent 的提问、计划确认都在对话里原地处理,不打断你正在看的内容。Tool approvals, the agent's questions and plan sign-off are handled inline in the conversation, so nothing interrupts what you're reading.

保留终端的信息密度Terminal density

工具调用、diff、耗时、token 用量和终端里一样紧凑。深色扁平,没有多余的边框。Tool calls, diffs, timings and token use are as compact as in the terminal. Dark, flat, no extra chrome.

审查结论附带证据Review findings come with evidence

审查者跑过的每条命令都会记下退出码和输出。只有真正复现出来的问题才标“已复现”,只靠读代码推断的标“推测”。第二次审查会逐条核对上次交回的问题有没有修好。Every command the reviewer runs is kept with its exit code and output. An issue is marked "reproduced" only when it was actually reproduced; anything based only on reading the code is "suspected". A second review checks each item sent back last time.

审查报告卡片:一个已复现的问题,附带命令、退出码 1 和报错输出,下面是一条建议和交给 Agent 的按钮 A review report card: one reproduced issue with its command, exit code 1 and error output, then a suggestion and the Send to agent button

上周那次对话,几秒找到Find last week's conversation in seconds

索引在后台建好并保存在本机,重启后只读新增的会话。所有词都要出现才算命中,不区分大小写。工具输出不进索引,结果里只有对话本身。The index is built in the background and kept on your Mac; after a restart only new sessions are read. A hit needs every word, case-insensitive. Tool output isn't indexed, so results are the conversation itself.

⌘⇧F 搜索框:搜“小时”,结果按线程分组,命中的词高亮 The ⌘⇧F search popup: results grouped by thread, with the matching words highlighted

安装Install

一行命令(推荐)One command (recommended)

curl -fsSL https://pi.flowsrun.com/install.sh | bash
  • 从 GitHub 下载最新版,先校验签名,再装到 /Applications。没有管理员权限的话装到 ~/Applications。Downloads the latest release from GitHub, checks its signature, and installs to /Applications (or ~/Applications without admin rights).
  • 如果还没装 pi 命令行,会用 npm 顺带装上,所以需要 Node.js 22.19 或以上。If the pi CLI isn't installed yet, it installs it with npm, so you need Node.js 22.19 or later.
  • 要更新,再运行一次同样的命令。运行前请先退出 Pi。To update, run the same command again. Quit Pi first.
  • 先看看脚本内容Read the script first

手动下载Manual download

下载 Pi-arm64.dmgDownload Pi-arm64.dmg

  • 应用没有经过 Apple 公证,第一次打开会被拦下。先双击打开一次,再到「系统设置 → 隐私与安全性」,点「仍要打开」。The app isn't notarized by Apple, so macOS blocks the first launch. Open it once, then go to System Settings → Privacy & Security and click Open Anyway.
  • pi 命令行需要另外装:Install the pi CLI separately:npm install -g @earendil-works/pi-coding-agent

模型和 API key 沿用 pi 自己的配置(~/.pi/agent),终端里能用,这里就能用。Models and API keys come from pi's own settings (~/.pi/agent): if pi works in your terminal, it works here.