PiNomad

PiNomad

基于 Pi Durable 的自托管 coding agent。agent 跑在你自己的机器上，Mac App、Web 和 iPhone App 连的是同一批运行中的任务。

打开 Web 版 开始使用 GitHub

状态：还在早期，迭代很快。Pi Durable 本身也是实验性的；宿主和客户端的协议主版本号必须一致。

同一个 PiNomad 任务并排显示在三个客户端上：左边是 Mac App，中间是 iPhone，右边是 Web。
一个任务，三个客户端：左边是 Mac App，中间是 iPhone（用 iPhone 镜像投到 Mac 上），右边是 Web。宿主是同一个 tailnet 里的一台 Linux 机器。

设计思路

你的 agent，跑在你的机器上，哪块屏幕都能看

  • 活在你自己的机器上干

    宿主可以跑在 Mac mini、Linux 主机或 VPS 上，agent 直接用那台机器的 shell 和代码仓库。

  • 崩溃、重启都不丢进度

    Pi Durable 会给每次模型调用和工具调用存检查点，宿主重启后从断掉的地方接着跑。

  • 客户端只是窗口

    在电脑前开个任务，出门用手机看进度、插话调整方向。设备扫一次性二维码配对，和宿主之间走端到端加密的通道：局域网或 tailnet 直连都行，也可以经过只能看到密文的中继。

快速上手

三条命令跑起来

宿主需要 Node 25+，支持 macOS 和 Linux。

还没配过 pi？pinomad host --faux "hi" 会用一个脚本化的假模型跑起来，可以先点点看。

终端 
npm i -g pinomad
pinomad host   # 用你在 pi 里配好的模型和认证（~/.pi/agent）
pinomad link   # 另开一个终端：打印 Web 客户端的浏览器链接

客户端

同一个任务，在哪都能接着看

  • Web

    打开 app.pinomad.si，或者用宿主自己提供的 Web 客户端（pinomad link）。现代浏览器都能用。

  • macOS

    GitHub Releases 上签名过的 DMG，会自动更新。

    Apple 芯片

  • iOS

    扫一次性二维码和宿主配对。

    目前只在 TestFlight 内部测试

  • Linux、Windows

    用 Web 客户端。

功能

agent 能做什么

工具和 pi 一样是 read、bash、edit、write 四个，另外还有：

项目和 worktree
Git 仓库里每个对话在自己的 worktree 和分支上干活，你的检出不会被动到。
Fork
从某条消息分出去，两条线各自往下聊。
子代理
把自成一体的任务交给子代理，多个子代理并行执行。
具名 Agent
可复用的角色，用 @名字 提及就能派给它，可选锁定模型和思考等级。
提问代替审批
工具执行前不弹审批；方向拿不准时，agent 会提 1–4 个选择题。
codemode
模型写一段 JavaScript，在 QuickJS 沙箱里调用其他工具，只有脚本的输出进入上下文。
MCP
在 ~/.agents/mcp.json 里配置 server，格式就是常见的 mcpServers。
图片
Web / 桌面端输入框可粘贴、拖入或选图，一条消息最多 4 张。
AGENTS.md 和 skills
每次请求都会读 ~/.agents 和项目里的 AGENTS.md / CLAUDE.md 与 skills。