Paseo：用一套界面在桌面与手机上编排多个编程 Agent
Paseo 是 Apache-2.0 许可的开源多智能体编排工具，通过桌面端、移动端、Web 与 CLI 统一调用 Claude Code、Codex、GitHub Copilot、OpenCode、Pi 等编程 Agent。它在本机运行名为 daemon 的本地服务，Agent 在用户自己的开发环境中并行执行，支持语音控制、跨设备接管、端到端加密中继配对，并提供 TypeScript SDK、插件系统与 Skills 编排命令，无遥测、无跟踪、无强制登录。
社区作者 · zZz
它解决什么问题
Paseo 的核心定位是「一个界面管理 Claude Code、Codex、Copilot、OpenCode 和 Pi agents」，可以在自己的机器上并行运行多个编程 Agent，并从手机或桌面端下发与跟进任务。
主要特性：
- Self-hosted（自托管）：Agent 运行在用户自己的机器上，拥有完整开发环境，可使用自己的工具、配置与 skills。
- Multi-provider（多提供方）：Claude Code、Codex、Copilot、OpenCode、Pi 共用同一界面，可为不同任务选择不同模型。
- Voice control（语音控制）：可通过语音口述任务或在语音模式下讨论问题，需要时实现免手操作。
- Cross-device（跨设备）：支持 iOS、Android、桌面端、Web 与 CLI。可以在办公桌前开始工作，在手机上查看进度，或从终端脚本化调用。
- Privacy-first（隐私优先）：Paseo 不含任何遥测、跟踪或强制登录。
插件系统： 可用可信的 TypeScript 插件添加主题、工作区面板、命令、设置界面和编程 Agent 提供方。安装来源支持 npm、Git 或本地目录，命令为 paseo plugin install <source>，可从 plugin quickstart 入手。插件运行时可以访问 daemon 所在机器以及已连接的客户端，因此只应安装可信代码。
架构与仓库结构： Paseo 运行一个名为 daemon 的本地服务器，用于管理编程 Agent；桌面应用、移动应用、Web 应用和 CLI 等客户端连接到该 daemon。
monorepo 包结构为：packages/server（Paseo daemon，含 agent 进程编排、WebSocket API、MCP server）、packages/app（Expo 客户端，iOS/Android/web）、packages/cli（paseo CLI，用于 daemon 与 agent 工作流）、packages/desktop（Electron 桌面应用）、packages/relay（daemon 与客户端使用的中继传输与加密）、packages/website（营销站点与文档，paseo.
sh）。
相关项目：getpaseo/paseo-relay（Elixir 编写的官方分布式中继）、paseo-vscode（VS Code 扩展）。
许可证：Apache-2.0。
— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
以下步骤整理自来源正文，按官方给出的顺序执行。
一、准备环境（Prerequisites） 需要至少安装并配置好一个 agent CLI，并已填入你的凭证，可选：Claude Code、Codex、GitHub Copilot、OpenCode、Pi。
二、桌面应用（官方推荐路径）
- 从 paseo.sh/download 或 GitHub releases 页面下载桌面应用。
- 打开应用，daemon 会自动启动，无需安装其他东西。
- 如需从手机连接：打开 Settings → 你的主机（your host） → Pair Device 进行设备配对。
三、CLI / headless（无界面 / 服务器路径）
- 安装 CLI 并启动 Paseo：
npm install -g @getpaseo/clipaseo
- Paseo 会在本地启动，然后询问是否启用端到端加密中继（relay）以便进行设备配对。
- 如果拒绝启用中继，则改用 TCP、Tailscale 或其他 VPN 直连。该路径适用于服务器和远程机器。
- 完整配置见文档：Docs、Connectivity guide、Configuration reference。
四、Docker（daemon + 自托管 Web UI） 运行以下命令（注意 $PWD 前后保留空格，属于镜像文档原样写法）：
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
- 启动后打开 http://localhost:6767。
- 需要在基础镜像上扩展你所用到的 agent CLI。
- 通过环境变量或持久化的 /home/paseo 卷提供凭证。
- 完整设置见 Docker 文档。
五、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 # 列出正在运行的 agents paseo attach abc123 # 流式查看实时输出 paseo send abc123 "also add tests" # 追加后续任务
在远程 daemon 上运行；--cwd 是该主机上的路径
paseo run --host workstation.local:6767 --cwd /workspace "run the full test suite" 完整命令见 CLI reference。
六、TypeScript SDK 使用 @getpaseo/client 构建 issue 集成、仪表盘和编排服务： 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(); 参见 SDK quickstart、recipes 与 API reference。
七、Skills（用 Agent 编排 Agent）
步骤 1 · 安装：
npx skills add getpaseo/paseo/paseo-handoff — 在 agent 之间交接工作（例如先用 Claude 规划，再交接给 Codex 实现）。 /paseo-advisor — 拉起单个 agent 作为顾问提供第二意见，不真正委派工作。 /paseo-committee — 由两个风格对立的 agent 组成委员会，退一步做根因分析并产出计划。
- 在任意 agent 对话中使用：
八、插件 安装命令：paseo plugin install <source>，来源可以是 npm、Git 或本地目录。建议从 plugin quickstart 开始。
九、开发（本地源码运行）
npm run dev # 运行所有本地开发服务npm run dev:server # 仅 servernpm run dev:app # 仅 Expo 客户端npm run dev:desktop # 仅桌面端npm run dev:website # 仅官网npm run build:server # 构建 server 栈npm run typecheck # 仓库级检查十、常见问题与注意事项
- 启动前必须至少有一个 agent CLI 已安装且凭证已配置好，否则无可用提供方。
- 手机连接需要先在桌面端 Settings → 你的主机 → Pair Device 完成配对；若不启用端到端加密中继，则要通过 TCP、Tailscale 或其他 VPN 直连。
Docker 方式需要自行在基础镜像中扩展 agent CLI，并通过环境变量或持久化的 /home/paseo 卷提供凭证。
- 插件可访问 daemon 机器与已连接客户端，只安装可信代码。
- Paseo 无遥测、无跟踪、无强制登录。
