Paseo — 手机远程操控编程 Agent 的统一界面
> 一句话版本:一个让你在手机、桌面和终端上统一管理 Claude Code、Codex、OpenCode 等 AI 编程助手的应用。在手机上发起任务,在电脑上跑,躺在床上也能写代码。
| 项目 | 信息 | |
|---|---|---|
| 来源 | https://github.com/getpaseo/paseo | |
| 作者 | moboudra | |
| 创建时间 | 2025-10-13 | |
| 语言 | TypeScript | |
| Stars | 1,116 | Forks 86 |
| 许可证 | AGPL-3.0 | |
| 安装 | `npm install -g @getpaseo/cli` |
核心内容
Paseo 解决一个具体痛点:AI 编程 Agent(Claude Code、Codex、OpenCode)都只能在终端里用,离开电脑就没办法了。Paseo 给它们加了一个统一的远程控制界面。
架构
手机 / 桌面 / Web / CLI
│
▼
Paseo Daemon(本地服务器)
│
├── Claude Code
├── Codex
└── OpenCode
Daemon 跑在你的开发机上,客户端通过 WebSocket 连接。手机扫码配对,秒连。
五大特性
1. 多 Agent 统一管理
- 一个界面操控 Claude Code、Codex、OpenCode
- 按任务选模型(规划用 Claude,实现用 Codex)
- 并行跑多个 Agent
2. 跨设备
- iOS、Android、桌面(Electron)、Web、CLI
- 在工位发起任务,手机上检查进度,终端里写脚本
- 扫码配对,无需复杂配置
3. 语音控制
- 语音描述任务或讨论问题
- 解放双手
4. Agent 协作技能
/paseo-handoff:和 Claude 讨论方案,然后 handoff 给 Codex 实现/paseo-loop:让 Agent 循环迭代直到满足验收标准(类似 Ralph loops)/paseo-orchestrator:创建 Agent 团队,聊天室式协调
5. 隐私优先
- 无遥测、无追踪、无强制登录
- Agent 跑在你自己的机器上
CLI 用法
paseo run --provider claude/opus-4.6 "implement user authentication"
paseo run --provider codex/gpt-5.4 --worktree feature-x "implement feature X"
paseo ls # 列出运行中的 Agent
paseo attach abc123 # 实时查看输出
paseo send abc123 "also add tests" # 追加任务
paseo --host workstation.local:6767 run "run the full test suite" # 远程执行
技术栈
| 组件 | 技术 |
|---|---|
| Daemon | Node.js, WebSocket, MCP Server |
| 移动端 | Expo(iOS + Android + Web) |
| 桌面 | Electron |
| CLI | Node.js |
| 连接 | WebSocket + Relay(远程穿透) |
网络连接与 Relay
不需要公网 IP,不需要端口转发。
局域网内(同一 WiFi)→ 直连。跨网络(手机 4G 连家里电脑)→ 两种方式:
1. Paseo Relay(默认):Paseo 团队托管的云端中继服务器。Daemon 和手机都主动出站连接 Relay,流量通过 Relay 转发:
`
电脑(Daemon)──出站──► Paseo Relay(云端)◄──手机
`
两边都是主动连出,无需公网 IP。
2. 自建 Relay:packages/relay 完全开源(AGPL-3.0),可以自己部署,不依赖 Paseo 团队。
3. 直连:有内网穿透方案(Tailscale、FRP、Cloudflare Tunnel)时,CLI 支持:
`bash
paseo --host workstation.local:6767 run "run tests"
`
注意:默认走 Paseo 托管 Relay 时,流量经过他们的服务器。AGPL 源码可审计,但隐私敏感场景建议自建 Relay。
分析
优势:
- 解决真实痛点:AI 编程 Agent 的移动端控制是个被忽视的场景
- 多 Agent 统一界面:不用在不同 CLI 之间切换
- Handoff/Loop/Orchestrator 技能实用:规划用 Claude、实现用 Codex 是真实工作流
- 隐私优先:自托管,无遥测
- 跨平台覆盖全:iOS/Android/Desktop/Web/CLI 五端
风险:
- AGPL-3.0 许可证,商用有传染性限制
- 依赖 Claude Code/Codex/OpenCode CLI,自身不是 Agent
- 1.1k stars,社区规模小
- Electron 桌面端(安装包大)
- Relay 远程穿透的安全性未详述
- 作者个人项目,可持续性不确定
与 OpenClaw 对比:
| Paseo | OpenClaw | |
|---|---|---|
| 定位 | 编程 Agent 远程控制界面 | AI Agent 框架/网关 |
| Agent | Claude Code / Codex / OpenCode | 任何 LLM + 工具 |
| 跨设备 | ✅ 手机/桌面/Web/CLI | ✅ Discord/Telegram/Signal 等 |
| 多 Agent | ✅ 并行 + handoff | ✅ Sub-agent + ACP |
| 非 coding 场景 | ❌ 只做编程 | ✅ 通用 |
| 自托管 | ✅ | ✅ |
| 语音 | ✅ | ❌ 无原生语音 |
与 Jay 的关联:
- Jay 用 OpenClaw ACP 路由 Claude Code/Codex,Paseo 的 handoff 技能思路可以借鉴
- 手机远程操控 Agent 对 Jay 有实际价值(出门时也能给 Agent 派活)
- Paseo 的 loop 技能(迭代到验收通过)适合 code review 场景
- 但 OpenClaw 已经覆盖了大部分能力,Paseo 更像是 OpenClaw 的"编程 Agent 专用前端"
评分
| 维度 | 评分 (1-10) | 说明 |
|---|---|---|
| 创新性 | 7 | 手机控制编程 Agent 是好想法,但非首创 |
| 实用性 | 8 | 解决真实痛点,CLI + 多端覆盖好 |
| 代码质量 | 7 | TypeScript monorepo,结构清晰 |
| 文档 | 7 | paseo.sh 文档站,有 CLI 参考 |
| 生态 | 5 | 1.1k stars,个人项目 |
| 可维护性 | 5 | AGPL + 个人维护,长期存疑 |
| **总分** | **6.5** | 编程 Agent 的移动遥控器,思路好但生态弱 |