Paseo 是什么:一句话定义

Paseo 是一个开源的 agentic development environment(代理化开发环境),覆盖桌面、移动、Web 和 CLI 四端,用途是在一个窗口里同时编排多个编码代理:agent 在各自的 worktree 里干活,你在同一界面审 diff、跑终端、开 Pull Request、用内置浏览器验证。项目按 Apache-2.0 协议开源(版权声明 2025-present Mohamed Boudra),TypeScript monorepo,GitHub star 约 2 万(2026-10 查询为 20,755),官网 paseo.sh。它解决的具体问题:多个 CLI 编码代理同时干活时,任务状态散落各终端没人记账,Paseo 把现场收拢进一个界面,手机上也能看。

agentic development environment 指什么

核心区别一句话讲完:agent 在这里是第一等公民,编辑器、终端、diff、PR 全部围绕 agent 会话组织,这既不同于 IDE,也不同于聊天客户端。

IDE 的组织中心是文件树和编辑区,人是第一执行者,Copilot 在 VS Code 里也只是编辑器插件。聊天客户端的组织中心是对话流,产出文字。Paseo 把组织中心换成 agent:官方 README 描述一个窗口里并列着 agents、编辑器、终端、diff 审查、Pull Request、内置浏览器——注意排序,agents 排在编辑器前面。

工程上这意味着两件事:打开窗口的第一动作是检查各 agent 干到哪一步了,编辑器降级为人工介入的入口;diff 审查和开 PR 在原生界面完成,从产出到合入不用切去 GitHub 网页。链路成立的前提是系统替你持有会话状态——这正是下一节 daemon 的职责。

八项核心能力地图

README 把能力写成八项清单,对应到日常开发流程如下:

能力README 描述对应的开发环节
Parallel agents多 agent 并行,各自在独立 worktree多任务同时推进
Built-in orchestrationagent 可创建 worktree、启动其他 agent 并与之对话,跨 provider任务拆分与交接
Complete development workflow编辑文件、审 diff、开 PR、跑终端,分屏布局自由排布日常编码全流程
Self-hostedagent 跑在你自己的机器上,用完整环境、配置和 skills环境与数据归属
Multi-provider七个 agent CLI 走同一界面按任务挑模型
Voice control语音口述任务、语音讨论问题免手输入
Cross-deviceiOS、Android、桌面、Web、CLI,移动端为完整功能原生 app随时查看与介入
Privacy-first无遥测、无跟踪、无强制登录数据合规

前两行分量最重:并行加编排把”同时开几个任务”的成本从人肉管理降到界面管理,命令级用法在并行开发实战篇拆解。

daemon 架构:四端为什么是同一个产品

架构分两层:本地 server 叫 daemon,负责管理编码代理;桌面、移动、Web、CLI 都是连接它的客户端。四端是同一个产品,因为 agent 进程与会话状态只存在 daemon 一侧。

前置条件只有一条:装好至少一个 agent CLI 并配好凭据(Claude Code、Codex、Copilot、OpenCode、Pi、Antigravity、Muse Code 任一)。桌面 app 从 paseo.sh/download 下载,打开即自动启动 daemon;手机走 Settings → your host → Pair Device 配对。服务器环境一行命令起服务端:npm install -g @getpaseo/cli && paseo,启动时询问是否启用端到端加密 relay 做设备配对,选否则直连 TCP、Tailscale 或其他 VPN。官方分布式 relay 是独立项目 getpaseo/paseo-relay,Elixir 写的。

分层带来的直接体验:agent 跑着的时候合上笔记本,路上手机连上去看到的是同一个现场,状态全在 daemon 侧。代码结构对得上这个分层:

包职责
packages/serverdaemon:agent 进程编排、WebSocket API、MCP server
appExpo 客户端,一套代码覆盖 iOS / Android / Web
desktopElectron 桌面端
cli命令行客户端
relaydaemon 与客户端共用的中继传输与加密
website官网

插件系统:写一次,手机上就有

插件跑在 daemon 上,装好后自动出现在所有已连接客户端——桌面、Web、iOS、Android 共用同一套 UI,README 的概括是”写一次插件,手机上就有”。

扩展点分三类:UI 侧可加 screen、侧栏项、工作区面板、Command Center 项、斜杠命令、composer pills、附件源、时间线项、主题;agent 生命周期侧可在运行中改配置、环境变量、MCP 服务器,代答权限请求,turn 结束后自动跟进;第三类最特殊,把其他编码 agent 直接加为 provider。

安装一条命令:paseo plugin add owner/slug,也支持从 Git 仓库或本地目录装。安全边界 README 原话值得引用:插件能访问你的 daemon 机器与已连接客户端,只装信任的代码。插件权限即宿主权限,和浏览器扩展、MCP 服务器是同一类风险,来源不明的先看源码。

多 provider:七个编码 CLI 走同一个界面

README 的 multi-provider 一项:七个 agent CLI 走同一个界面,按任务挑模型。

工程价值在切换成本趋近于零:审查丢给一个 provider,批量实现丢给另一个,还能被同一编排流程调度——内置编排明确写着跨 provider 生效。有多家订阅的人,界面收敛本身够构成迁移理由。

隐私立场:无遥测、无跟踪、无强制登录

README 把 privacy-first 列进能力清单:无遥测、无跟踪、无强制登录。配合 self-hosted——agent 跑在你自己的机器上,用你完整的环境、配置和 skills——直连模式下流量不出你的网络,走 relay 也是端到端加密。

对选型敏感的团队,这三条是硬指标:不少同类工具默认上报使用数据,审计排查成本高;Paseo 把无遥测写成产品立场,协议 Apache-2.0 源码可审,极端情况可 fork 自维护。

一个人开发、两万星、数万日活

Paseo 由独立开发者 Mohamed Boudra 一人开发,README 自述 “built by one person and funded by the people who use it”,靠用户赞助,GitHub Sponsors 可支持,并称每天数万开发者使用。版权声明 2025-present,2026-10 star 约 2 万。

一个人的项目有两面:决策链短、产品形状不妥协——四端共用一个 daemon 的架构在委员会式流程里很难活下来;风险是 bus factor 为 1,长期维护看作者投入节奏。缓解因素:Apache-2.0 可 fork 自建,monorepo 包边界清晰。社区在 Discord 和 r/PaseoAI,作者推特 @moboudra。

和 Omnigent、LiveAgent、AgentDock 的定位差异

四个项目都围绕 agent 编排,切入点不同:

项目一句话定位
Paseo完整开发环境 + 移动原生,agent 一等公民
Omnigentharness 之上的编排治理层
LiveAgent本地优先的桌面客户端,工具在本机执行
AgentDock服务端网关,多设备接入

选型跟着需求走:要”手机看 agent 干活、从审 diff 到开 PR 不出窗口”的完整体验,Paseo 最完整;只要编排治理,Omnigent 更轻;要桌面本地工具执行,看 LiveAgent;服务端网关形态参考 AgentDock。与 Omnigent 的正面对比见这篇。

适合谁用

  • 同时开多个 agent 任务、受够了终端切换的开发者
  • 外出时想在手机上查看、介入 agent 现场的人
  • 数据敏感、要求无遥测可自托管的团队
  • 有多家 provider 订阅、想按任务挑模型的人

桌面端从 paseo.sh/download 下载即用;服务端、Docker 与手机配对的完整步骤见安装部署教程。

常见问题

Paseo 和 VS Code 加 Copilot 有什么区别?

组织中心不同:VS Code 围绕编辑器,AI 是插件;Paseo 围绕 agent,编辑器、终端、diff、PR、内置浏览器都是 agent 工作流的配套界面。

前者假设人在写代码、AI 补全,后者假设 agent 在写代码、人负责审查;所以多 agent 并行、各自 worktree、手机远程查看在 Paseo 里是原生能力,插件体系里要自己拼工具链。

Paseo 支持哪些编码代理?

README 列出七个:Claude Code、Codex、Copilot、OpenCode、Pi、Antigravity、Muse Code,全部走同一界面,按任务挑模型。

七个共用同一套编排与审查流程,换 provider 不改工作流;插件系统还能把其他编码 agent 加为 provider。

Paseo 怎么上手?

先装好至少一个 agent CLI 并配好凭据,桌面端从 paseo.sh/download 下载、打开自动启动 daemon,手机在 Settings → Pair Device 配对。

服务器场景用 npm 装 CLI 直接跑 daemon,Docker 一条 docker run 也能起;完整步骤见站内安装部署篇。