Repolode
提交项目
Xpropel

Xpropel/Pi-Remote

为 pi 终端编程代理提供远程控制：在浏览器或手机上实时查看会话，并通过自托管中继发送消息和命令。

在 GitHub 查看
Star
307
Fork
10
未关闭 Issue
0
最近提交
前天

这是什么？

Pi-Remote 通过 pi 官方扩展 API 挂载到正在运行的终端会话上，不修改 pi 源码，也不接管终端。会话始终留在本地 pi 进程中，浏览器则实时镜像显示该会话，并可以发送消息，切换模型和思考级别，手动压缩上下文，创建或分叉会话，以及浏览会话树。

系统由三部分组成：运行在 pi 内的同步扩展、负责鉴权与转发的 Node 中继服务，以及由中继提供的网页界面。多台机器可以连接同一个中继，设备只有在其 attach 窗口开启时才可访问。无服务器模式可以把中继跑在自己的电脑上，手机通过同一 Wi-Fi 连接，外出时可临时开启 Cloudflare Tunnel。

项目面向个人单用户场景。远程 bash 默认关闭，扩展与网页查看使用不同的令牌。除非手动开启，对话内容默认不会持久化。

核心功能

  • 01将 pi 终端的输出、工具调用和状态实时同步到浏览器
  • 02pi 忙碌时可排队或插入远程消息，并确认送达
  • 03远程切换模型和思考级别、手动压缩上下文、浏览会话树
  • 04支持扫码绑定设备，并可连接多台机器
  • 05无服务器局域网模式，可选按需开启 Cloudflare Tunnel
  • 06桌面端与移动端分别布局，提供多种界面主题

适用场景

  • 在手机上查看长时间运行的编程代理任务进度
  • 离开电脑时在手机上回复 pi 提出的问题
  • 通过一个浏览器面板管理多台机器上的 pi 会话

快速上手

  1. 1

    安装 pi 终端编程代理（需要 Node 22.18 或更高版本）

    npm install -g @earendil-works/pi-coding-agent
  2. 2

    在项目目录中安装 Pi-Remote 依赖

    npm install
  3. 3

    在本机启动中继服务（网页界面使用 7002 端口）

    npm run relay

使用前须知

  • 需要另外安装 pi 编程代理，Pi-Remote 不包含 pi 本身。
  • 通过中继实现多设备使用需要你自行管理的服务器，本地回环模式除外。
  • 面向个人单用户使用，没有多用户权限系统。
  • 任何持有查看令牌的人都可以向 pi 发送消息和命令，因此必须妥善保管该令牌。

收录于专题

开源 AI Agent 框架与应用AI 编程助手与编码 Agent自托管应用

标签

#ai-agent#coding-agent#remote-control#web-terminal#websocket#self-hosted#typescript#nodejs#developer-tools#pi

常见问题

Pi-Remote 是什么？
为 pi 终端编程代理提供远程控制：在浏览器或手机上实时查看会话，并通过自托管中继发送消息和命令。 Pi-Remote 通过 pi 官方扩展 API 挂载到正在运行的终端会话上，不修改 pi 源码，也不接管终端。会话始终留在本地 pi 进程中，浏览器则实时镜像显示该会话，并可以发送消息，切换模型和思考级别，手动压缩上下文，创建或分叉会话，以及浏览会话树。
Pi-Remote 可以免费使用吗？用的什么许可证？
Pi-Remote 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
Pi-Remote 还在维护吗？
活跃维护中。Pi-Remote 最近一次提交是在 2026年11月5日。
Pi-Remote 适合用来做什么？
在手机上查看长时间运行的编程代理任务进度 离开电脑时在手机上回复 pi 提出的问题 通过一个浏览器面板管理多台机器上的 pi 会话
Pi-Remote 怎么安装和运行？
安装 pi 终端编程代理（需要 Node 22.18 或更高版本）: npm install -g @earendil-works/pi-coding-agent 在项目目录中安装 Pi-Remote 依赖: npm install 在本机启动中继服务（网页界面使用 7002 端口）: npm run relay
在哪里获取 Pi-Remote？
源代码和安装说明在 GitHub 上：https://github.com/Xpropel/Pi-Remote

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目