先说结论
截至 2026-11-03 核对，Pi（Earendil 维护的开源 coding agent，npm 包 @earendil-works/pi-coding-agent）官方只提供终端里的交互界面，以及给脚本和程序用的 print / JSON、RPC 和 SDK 四种用法，没有官方的 iOS 或 Android app，也没有官方的网页端。所以在手机上用 Pi，常见的办法是 SSH 回电脑、装一款社区做的客户端，或者用 BotBus 这类通用工具：它在电脑上只读 Pi 的会话文件，经端到端加密的中转同步到手机和 Apple Watch，在手机上看对话、续聊、新建任务和停掉手机发起的那一轮。
下面先把 Pi 自己的情况和几条现成的路说清楚，再讲 BotBus 具体能做什么、做不到什么。
Pi 官方现在有哪些端
以下是 2026-11-03 在 pi.dev 和官方 GitHub 仓库里核对到的情况：
- 交互界面（TUI）：在终端里运行
pi，这是最主要的用法。安装可以用官网的一行脚本，也可以npm install -g @earendil-works/pi-coding-agent，Windows 有 PowerShell 安装脚本。 - print / JSON：
pi -p "…"跑一次就退出，适合脚本；--mode json把整轮输出成事件流。 - RPC：经 stdin / stdout 走 JSON 协议，给不用 Node 的程序集成。
- SDK：把 Pi 嵌进自己的应用。
- 手机和网页：官方没有。仓库里的包是 LLM 接口、agent 运行时、终端 UI 库和 coding agent 命令行本身，没有手机客户端。
Pi 还有两个特点会直接影响“在手机上用”这件事。一是没有内置的权限确认：官网明说没有权限弹窗，想要确认流程得自己用扩展写，所以 Pi 的会话不会停下来等你批准。二是会话是一棵树：/tree 可以回到前面任何一步换个方向接着聊，所有分支都存在同一个文件里。
几条现成的路，各适合谁
SSH + tmux。 在电脑上用 tmux 开着 Pi，手机用 SSH 客户端经 Tailscale 之类连回去，tmux attach 就能看到原来那个界面。好处是完全免费、看到的就是电脑上的 Pi，扩展、/tree、切模型都在。它卡在手机屏幕上：TUI 在小屏上读长输出、选文字、打长句子都不顺手；手机切到后台连接常会断；Pi 跑完了也不会通知你，得自己隔一阵连上去看一眼。适合偶尔需要、本来就习惯终端的人。
社区客户端。 因为 Pi 有 RPC 和 SDK，社区做了不少手机端。比如 App Store 上的 Pi in Pocket（独立开发者发布，商店页没有说明与 Pi 官方的关系），需要在 Mac 上跑配套的 pi-bridge，经局域网或 Tailscale 连接；商店页列出的功能有实时看 agent 输出、一轮跑到一半插话调整方向、切换模型和思考强度、压缩上下文、任务结束推送等。GitHub 上也有经 Tailscale 连 pi-rpc 的 Android 客户端和适配手机屏幕的网页端。这类客户端专做 Pi，对 Pi 的功能覆盖往往比通用工具深，如果你只用 Pi、电脑是 Mac、愿意自己维护 Tailscale，它们值得先试。要留意的是它们大多要另跑一个桥接服务，入口的安全由你自己负责，换电脑或换 agent 时也要另找工具。
BotBus。 适合的情况是：除了 Pi 你还在用 Codex、Claude Code 之类，想在一个列表里管；有不止一台电脑；想用 Apple Watch；或者不想自己开 Tailscale 或隧道。代价是它对 Pi 只做通用的那几件事，Pi 特有的功能（中途插话、切模型、/tree 换分支）在手机上没有。
BotBus 怎么接 Pi
前提先说清楚：Pi 装在跑 BotBus 的那台电脑上，并已经在 Pi 里配好了模型的 API key 或登录；电脑要开着、联网。BotBus 电脑端有 Mac 版（菜单栏应用，需要 macOS 26 或更新）、Linux 版（见安装说明）和 Windows 版，装最新版即可。
Pi 是 BotBus 内置支持的 agent，不用写配置。它分两部分工作：
- 看见：BotBus 只读地扫 Pi 的会话目录
~/.pi/agent/sessions，列出最近 7 天写过的会话（最多 200 条），按会话记录里的工作目录归到项目下。会话是树的时候，BotBus 只取当前分支，也就是从最后一条沿着上一条往回走的那条路，被你/tree丢下的分支不算这个会话的现状。电脑上终端里开的 Pi 会话也会出现，不需要换一个命令启动。 - 动手：手机上新建或续聊时，BotBus 在电脑上起一个
pi --mode json子进程跑这一轮，续聊用--session指向原来的会话文件，跑完进程就退出，结果写回同一个文件。电脑上找不到pi命令时只能只读展示。
在手机上能做什么
看会话和对话记录。 Pi 的会话和别的 agent 的任务一起按电脑、项目排好，点进去读完整对话。电脑上那些会话没有“正在跑”的标记，状态是推断出来的：最后一条还在等模型回应、而且文件两分钟内被写过，才算“运行中”；停在那里超过两分钟没动静，多半是进程没了，记成“已中断”。所以状态会有几秒到两分钟的滞后。
收推送。 任务跑完或者失败时手机会收到通知（前提是手机开了通知权限）。Pi 没有审批，所以不会有“等你批准”这一类推送。推送的整体机制见agent 推送通知。
续聊。 一轮结束后想补一句，在手机上打开会话直接发，BotBus 在会话原来的工作目录里接着跑。续聊的通用做法见手机续聊 agent 会话。
新建任务。 在手机上选电脑、项目和 Pi，写一句需求就开工。BotBus 会经 --append-system-prompt 把 botbus 命令行工具的用法交给这一轮的 Pi，方便它把截图、文件和链接发回手机；它会不会用，取决于 Pi 和你选的模型。
中断。 手机发起的那一轮跑偏了，在手机上点停止，BotBus 给子进程发中断信号，这一轮记成“已中断”。各 agent 中断的差异见远程停止 AI agent。
回到电脑接着做（Mac 版）。 菜单栏里 Pi 那一行会列出从手机发起的会话，点“继续聊”会打开“终端”，先进入会话的工作目录，再用 pi --session <记录文件> 接上，你就回到了熟悉的 TUI。这一轮还在跑时按钮不可用，免得两个进程同时写一个文件。详见手机上开的会话回到电脑接着做。
限制与边界
- 没有审批。 Pi 本身没有权限确认，手机上不会出现 Pi 的审批卡片，工具调用会直接执行。你在 Pi 里用扩展做的确认流程，BotBus 也接不到。手机发起的任务一样不经确认就跑，所以写需求时把范围说清楚，别在重要目录里让它随便动手。
- 电脑上正在跑的会话管不了。 你在终端里开着、正在跑的 Pi 会话，手机上不能续聊，因为再起一个进程会和它抢着写同一个文件；也不能中断，因为那不是 BotBus 起的进程，只能在电脑上停。等它停下再续聊。
- 同一个会话不能并行。 手机发起的那一轮还在跑时，再发续聊会被拒绝，等这一轮结束再发。
- Pi 特有的功能手机上没有。 不能一轮跑到一半插话，不能在手机上换模型或思考强度，不能开自动批准，不能删会话，也不能在树上切分支；这些在电脑的 TUI 里做。
- 手机发图不支持。 带图的消息会直接报“这个 Agent 暂不支持发图”，不会只把文字发过去。
- 只列最近 7 天。 更早的会话不在手机上出现。
- 电脑睡了就停。 电脑睡着或断网时，手机上能看已经同步过的会话，但续聊、新建和中断都要等电脑回来。
- 内容加密，元数据不加密。 对话、命令和结果在设备上加密后才经过中转服务器，服务器看不到内容，但看得到设备编号、在线状态、更新时间和数据大小；开发预览不在端到端加密范围内。详见端到端加密说明。
- 手机端。 iPhone 和 Apple Watch 版已在 App Store 上架，需要 iOS 26 / watchOS 26 或更新；Android 版需要 Android 8.0 或更新，在官网下载区下载安装包。
常见问题
Pi coding agent 有官方手机 app 吗？
截至 2026-11-03 核对没有。官方提供终端里的交互界面和 print / JSON、RPC、SDK 几种集成方式；能找到的手机客户端都是社区项目，要连你自己电脑上跑的 Pi。
已经在用 Pi in Pocket 之类的社区客户端，还需要 BotBus 吗？
不一定。只用 Pi、需要中途插话或在手机上切模型的，专做 Pi 的客户端更合适。BotBus 适合你同时还在用别的 agent、有多台电脑、想用手表，或者不想自己维护 Tailscale。两者可以一起装，BotBus 只读会话文件，不影响别的客户端。
Pi 没有审批，手机上发任务安全吗？
Pi 在手机发起的任务里和在电脑上一样，工具调用不会停下来等确认，这是 Pi 自己的设计。BotBus 不会替它加一道审批。需要确认流程的话，按 Pi 官方的扩展示例在 Pi 里做，或者把需要审批的活交给支持审批的 agent。
手机上开的 Pi 会话，回到电脑能接着用 TUI 吗？
能。会话就写在 Pi 自己的会话目录里，Mac 版菜单栏的“继续聊”会用 pi --session 在终端里打开它；Linux 和 Windows 上也可以自己在会话的工作目录里用同样的参数接上。
怎么开始？
在电脑上装好并配好 Pi，再到下载区装 BotBus 电脑端，用手机扫配对二维码即可。Pi 会自动出现在 agent 列表里。