Paseo — 手机远程操控编程 Agent 的统一界面

> 一句话版本:一个让你在手机、桌面和终端上统一管理 Claude Code、Codex、OpenCode 等 AI 编程助手的应用。在手机上发起任务,在电脑上跑,躺在床上也能写代码。

项目信息
来源https://github.com/getpaseo/paseo
作者moboudra
创建时间2025-10-13
语言TypeScript
Stars1,116Forks 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 统一管理

2. 跨设备

3. 语音控制

4. Agent 协作技能

5. 隐私优先

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"  # 远程执行

技术栈

组件技术
DaemonNode.js, WebSocket, MCP Server
移动端Expo(iOS + Android + Web)
桌面Electron
CLINode.js
连接WebSocket + Relay(远程穿透)

网络连接与 Relay

不需要公网 IP,不需要端口转发。

局域网内(同一 WiFi)→ 直连。跨网络(手机 4G 连家里电脑)→ 两种方式:

1. Paseo Relay(默认):Paseo 团队托管的云端中继服务器。Daemon 和手机都主动出站连接 Relay,流量通过 Relay 转发:

`

电脑(Daemon)──出站──► Paseo Relay(云端)◄──手机

`

两边都是主动连出,无需公网 IP。

2. 自建 Relaypackages/relay 完全开源(AGPL-3.0),可以自己部署,不依赖 Paseo 团队。

3. 直连:有内网穿透方案(Tailscale、FRP、Cloudflare Tunnel)时,CLI 支持:

`bash

paseo --host workstation.local:6767 run "run tests"

`

注意:默认走 Paseo 托管 Relay 时,流量经过他们的服务器。AGPL 源码可审计,但隐私敏感场景建议自建 Relay。

分析

优势

风险

与 OpenClaw 对比

PaseoOpenClaw
定位编程 Agent 远程控制界面AI Agent 框架/网关
AgentClaude Code / Codex / OpenCode任何 LLM + 工具
跨设备✅ 手机/桌面/Web/CLI✅ Discord/Telegram/Signal 等
多 Agent✅ 并行 + handoff✅ Sub-agent + ACP
非 coding 场景❌ 只做编程✅ 通用
自托管
语音❌ 无原生语音

与 Jay 的关联

评分

维度评分 (1-10)说明
创新性7手机控制编程 Agent 是好想法,但非首创
实用性8解决真实痛点,CLI + 多端覆盖好
代码质量7TypeScript monorepo,结构清晰
文档7paseo.sh 文档站,有 CLI 参考
生态51.1k stars,个人项目
可维护性5AGPL + 个人维护,长期存疑
**总分****6.5**编程 Agent 的移动遥控器,思路好但生态弱