getpaseo/paseo

项目介绍

Paseo 是一个面向桌面、移动端、Web 和命令行的智能体开发环境。它把 Claude Code、Codex、Copilot、OpenCode、Pi、Antigravity、Muse Code 等多个编码智能体 CLI 收进同一套界面，底层由本机运行的服务进程 daemon 负责启动智能体、提供 WebSocket API，并可充当 MCP server。

主要工作流包括：并行运行多个智能体，每个智能体使用独立 worktree；在同一窗口内编辑文件、查看 diff、提交 pull request、运行终端，面板可自由拆分；在桌面开始任务后从手机查看进度，或用 CLI 脚本化操作。客户端覆盖原生 iOS/Android、Electron 桌面端、自托管 Web 和 paseo 命令行。项目声明不做遥测、追踪，也不强制登录。

快速使用

推荐直接使用桌面端：从下载页或 GitHub Releases获取安装包，打开后 daemon 自动启动。使用前需先安装并登录至少一个受支持的智能体 CLI，例如 Claude Code或 Codex。

在没有桌面端的服务器或虚拟机上，安装 CLI 并启动 daemon：

npm install -g @getpaseo/cli
paseo

daemon 启动时会询问是否启用用于设备配对的端到端加密中继；拒绝后可通过 TCP、Tailscale 或其他 VPN 直连。完整安装、连接与配置说明见官方文档。

也可以用 Docker 同时启动 daemon 和自托管 Web UI，端口为 6767：

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。基础镜像需要自行加入所使用的智能体 CLI，并通过环境变量或持久化的 /home/paseo 卷提供凭据，详见 Docker 文档。

在终端中可以直接创建和查看智能体：

paseo run --provider claude/opus-4.6 "implement user authentication"
paseo ls
paseo attach abc123
paseo send abc123 "also add tests"

远程 daemon、worktree 及其他参数见 CLI 参考。

扩展方式

插件运行在 daemon 上，并同步出现在所有已连接的客户端中，桌面、Web、iOS、Android 界面一致。插件可以添加页面、侧边栏项、工作区面板、Command Center 条目、斜杠命令、附件来源、时间线项和主题，也能修改智能体配置、环境变量、MCP server、权限处理以及注册新的 provider。可通过 paseo plugin add owner/slug 从 registry 安装，也支持 Git 仓库或本地目录。插件能访问 daemon 所在机器和已连接的客户端，因此只应安装可信代码，详见插件文档。

Skills 用于让智能体学会调用 Paseo 来编排其他智能体，安装命令为 npx skills add getpaseo/paseo。内置的 /paseo-handoff 用于在智能体之间交接任务，/paseo-advisor 单独启动一个顾问智能体提供第二意见，/paseo-committee 则让两个立场不同的智能体共同做根因分析和计划。

TypeScript SDK @getpaseo/client 通过 WebSocket 暴露 daemon，可用于构建 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 快速开始和 API 参考。

使用约束

Paseo 负责编排智能体 CLI，本身不提供模型凭据。每个 provider 都需要单独安装和登录，示例中的模型名（如 claude/opus-4.6、codex/gpt-5.5）取决于所安装 CLI 实际提供的模型。智能体在 daemon 所在机器上使用完整的本地开发环境运行，因此访问范围和权限取决于该机器的配置。

服务端方式需要 Node.js 和 npm 安装 CLI；Docker 方式需要可用的容器运行时，并通过 PASEO_PASSWORD 设置密码。不启用加密中继时，移动端需要能通过 TCP、Tailscale 等路径访问 daemon。README 标注的许可证为 Apache-2.0，但仓库元数据未识别出许可证，再分发前应核对许可证文件。

HotRepo 点评

该项目在 Hacker News 上有多次 Show HN 记录，其中 2026 年 6 月 2 日的讨论获得 92 分、54 条评论（讨论）。评论里对「从手机操作智能体」看法不一：有用户表示靠它离开工位后仍能跟进任务，也有用户认为在手机上提交代码是一种糟糕的趋势；维护者在回复中解释，移动端的意义是离开桌面后仍能访问工作，而不是把工作时间继续拉长（回复）。另有一条评论称移动端能运行在只有 2GB 内存的 13 年前 Nexus 7 上，这属于个人体验而非性能测试。讨论还质疑帖文标题里的「beautiful」，有回复指出项目自己的宣传材料并未使用该词。从可查的几条讨论看，关注点集中在多端协同工作流以及远程操作智能体的取舍，而不是编排机制本身。