Paseo，手机远程指挥AI Agent工作

夸克网盘

立即下载

UC网盘

立即下载

Paseo 是一个自托管的 AI 编码智能体编排平台，用一套界面统一调度 Claude Code、Codex、GitHub Copilot、OpenCode、Pi 等主流编码 Agent，让它们在你的机器上并行干活，而且能从手机远程指挥。

支持：安卓+Win+mac+linux

给多个 AI 编码 Agent 装一个总指挥台——统一界面下发任务、并行执行、随时查看、跨设备操控。

桌面装了个 Claude Code，终端里跑着 Codex，IDE 里挂着 Copilot——三个工具三个界面，各聊各的，没有一个统一的地方看”现在到底有几件事在做、做得怎么样”。
想让两个 Agent 并行干两件事（一个改后端、一个写前端）？手动开两个终端窗口，自己盯着，谁先干完谁后干完全凭记忆。
人离开电脑了，任务跑完了也不知道；想远程看一眼进度、追加一句”再加点测试”，只能干瞪眼。

Paseo 就是冲着这几个痛点去的。

它凭什么是”总指挥台”

这是全篇最值得看的部分。Paseo 的架构设计有个关键决策，决定了它跟一堆”AI 编程套壳工具”的本质区别：

核心架构：daemon 模式

Paseo 是一个 TypeScript monorepo，核心是一个常驻后台的 daemon（守护进程）。所有东西都围着它转：

桌面 App / 手机 App / Web / CLI
              │  WebSocket API (默认 ws://127.0.0.1:6767/ws)
              ▼
        ┌─────────────┐
        │ Paseo daemon │  ← 真正的编排核心，跑在你机器上
        └─────────────┘
              │  在隔离的 Git worktree 中拉起各 CLI
              ▼
   Claude Code │ Codex │ Copilot │ OpenCode │ Pi

关键点：

daemon 负责编排，客户端只是遥控器。 桌面端是 Electron，移动端是 Expo（iOS/Android），Web 端是浏览器，CLI 是 npm 包——但它们都不直接干活，全都通过 WebSocket 连到 daemon 发指令、收状态。
daemon 可以无头跑在远程服务器上。 这是它区别于普通桌面工具的地方：把 daemon 部署到一台工作站/服务器上，你在哪都能连上去干活。

包装官方 CLI，而不是重新发明

这是 Paseo 最聪明、也最省事的一招：

它不直接调大模型的推理 API，而是原样包装各家官方 CLI（Claude Code、Codex 等）。

Git worktree 是隐藏主角

多 Agent 并行最大的坑是互相踩文件。Paseo 的解法是 Git worktree：

每个 Agent 被分配一个独立的 Git worktree，相当于同一个仓库的多个隔离工作副本，各自改各自的，互不干扰。
Git 流程内建：分支、PR、合并都在界面里操作，干活干完直接走提交流程。
daemon 层还有 Git 进程限流，防止并发 git 操作把资源耗尽。

远程访问：端到端加密中继

手机在外面怎么连家里的机器？两种方式：

直连：手机和机器在同一网络，QR 码配对直接连。
中继：不在同一网络时，走官方开源的 paseo-relay（Elixir 写的端到端加密中继），传输全程加密，代码仍然只在你的机器上跑，中继只转发密文。

功能特点盘点

多提供商，一套界面

官方号称支持 30+ 种 Agent。同一个任务，你可以指定用哪个提供商跑——比如”重构用 Claude，跑测试用 Codex”，按任务选模型。

跨设备，功能对等

桌面 App（macOS/Windows/Linux）：主战场。
手机 App（iOS/Android）：不是阉割版”看进度”App，宣称与桌面功能对等——能看到 Agent 实时输出、能追加指令。
Web 端：浏览器直接连 daemon。
CLI：paseo run "..." 一行命令，方便脚本化。

语音控制，免提指挥

内置语音模式，语音转文字/文字转语音都在设备本地完成（不是上传云端识别）。人躺在床上，对着手机说”让 Claude 把那个 bug 修了”，它就去了。

隐私优先

无遥测、无追踪、无强制登录、不要求云账号。你自带各家的订阅或 API Key，Paseo 不碰你的密钥、不碰你的代码。

工作区界面

分屏/标签页布局：Agent 会话、终端、浏览器预览、diff 并排显示；自动处理端口冲突（URL 自动路由），不会出现”两个 Agent 同时抢 3000 端口”的惨剧。

编排技能（Skills）

不止是仪表盘，还带编排原语：handoff（交接）、advisor（顾问）、committee（委员会）、loop（循环）等技能，让 Agent 之间可以互相派生、互相协调——一个 Agent 干到一半，可以拉另一个 Agent 进来当顾问。

使用方法

4.1 最省事：桌面 App

去下载对应平台安装包，打开即用（daemon 自动启动）。手机端通过 Settings → your host → Pair Device 扫 QR 码配对。

4.2 CLI（无头模式 / 服务器）

# 安装
npm install -g @getpaseo/cli

# 基本使用
paseo run --provider claude/opus-4.6 "implement user authentication"
paseo run --provider codex/gpt-5.5 --worktree feature-x "implement feature X"

# 管理运行中的代理
paseo ls# 列出运行中的 agent
paseo attach abc123         # 流式查看实时输出
paseo send abc123 "also add tests"# 给正在跑的 agent 追加任务

# 远程连到另一台机器的 daemon
paseo --host workstation.local:6767 run "run the full test suite"

Docker 自托管

docker run -d --name paseo 
  -p 6767:6767 
  -e PASEO_PASSWORD=change-me 
  -v "$PWD/paseo-home:/home/paseo" 
  -v "$PWD:/workspace" 
  ghcr.io/getpaseo/paseo:latest

TypeScript SDK（编程接入）

import { createPaseoClient } from"@getpaseo/client";

const client = createPaseoClient({ url: "ws://127.0.0.1:6767/ws" });
await client.connect();

const agent = await client.agents.create({
config: { provider: "codex/gpt-5.5" },
cwd: "/Users/me/dev/storefront",
prompt: "Review the current diff and name the riskiest change.",
});

const result = await agent.waitForFinish();
console.log(result.lastMessage);
await client.close();

安装协作 Skills

npx skills add getpaseo/paseo

Paseo 用一套干净的设计——daemon 编排 + WebSocket 遥控 + Git worktree 隔离 + 原样包装官方 CLI——把”多 Agent 并行”这件事从”手动开 N 个终端窗口”升级成了”一个界面、一部手机、随时指挥”。

项目地址：https://github.com/getpaseo/paseo

官网：https://paseo.sh/