paseo 是什么?

Paseo 是 AI 编程 Agent 的统一控制台:它负责启动、查看、连接和编排已有的 Agent CLI,不自带模型或 Agent 账号。

⭐ 10,020 Stars 🍴 943 Forks TypeScript NOASSERTION 作者: getpaseo
来源:官方 Releases 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

本轮官方稳定版为 v0.8.0;官方 release 还列出 v0.9.0-beta.2 预览版。教程类查询需要把“安装什么、Agent 是否已登录、怎么配对、怎么查看任务”一次讲清楚。

来源:官方 Releases

核心功能

桌面端和 CLI 安装

桌面端从官方下载页获取,CLI 通过 @getpaseo/cli 安装;两条路径都围绕本机 daemon 工作。

来源:github.com/getpaseo/paseo
daemon 与设备配对

官方连接文档提供桌面 Pair a device 与 paseo daemon pair 两种配对入口,可选择 relay 或直接网络连接。

来源:paseo.sh/docs/connectivity
run/ls/attach/send 编排命令

README 和教程使用 paseo run 启动任务,paseo ls、attach、send 查看和追加任务。

来源:paseo.sh/docs

技术架构

本机 daemon 管理 Agent 进程,桌面、Web、手机和 CLI 通过配对后的连接控制 host;Paseo 只做编排,Agent 的模型和登录状态由各自 CLI 管理。

来源:官方 Releases

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) Node.js/npm 已登录的 Claude Code、Codex、Copilot、OpenCode 或 Pi已登录的 Claude… 桌面端和 CLI 安装 daemon 与设备配对 run/ls/attach/send 编排命令run/ls/attach/send… paseo 项目本体 核心功能 关键依赖

技术栈

语言TypeScript/JavaScript(以官方仓库为准)框架桌面端 + CLI + daemon
Node.js/npm已登录的 Claude Code、Codex、Copilot、OpenC…
可选 Docker、远程 daemon、Relay/Tailscale
来源:官方 Releases

快速上手

先单独安装并登录一个 Agent CLI;再安装 @getpaseo/cli,运行 paseo;用 paseo daemon pair 配对;最后用 paseo run --provider codex "任务" 启动一次只读任务,并用 paseo ls / attach 查看。
来源:官方 Releases

使用场景

需要同时管理多个编码 Agent、在多个工作区并行跑任务,或从手机/桌面远程控制本机 host 的个人开发者。

来源:官方 Releases

优势与局限

优势

  • 把多个 Agent 的启动和查看入口统一起来
  • 支持后台任务、工作区和远程 host
  • 官方文档提供 CLI、桌面、Web 与配对路径

局限

  • 不包含模型和 Agent 账号
  • Agent CLI 的登录、模型可用性和费用仍由上游负责
  • 不同版本的参数需要用 paseo --version 与 --help 复核
来源:官方 Releases

最新版本

v0.8.0 是当前稳定版;v0.9.0-beta.2 作为预览版单独核对。

来源:官方 Releases

实测与证据

status: official_docs_checked_not_locally_installed  |  checked_at: 2026-09-22  |  environment: 阅读官方仓库、文档和 v0.8.0 release;当前工作区未完成各平台安装  |  limitations: 未验证 macOS、Windows、Linux、移动端和 Docker 的完整安装流程  |  observed_output: 教程中的命令、默认路径 ~/.paseo、daemon pair、run/ls/attach/send 与官方文档入口可对应;未把命令执行结果冒充本地实测

来源:官方 Releases

同类项目对比

相比直接在终端运行单个 Agent,Paseo 增加了 host/daemon、配对和多任务编排;如果只用一个 Agent 且不需要远程控制,直接使用该 Agent CLI 更简单。

来源:官方 Releases

总结评价

需要同时管理多个编码 Agent、在多个工作区并行跑任务,或从手机/桌面远程控制本机 host 的个人开发者。采用前需要核对:不包含模型和 Agent 账号。

来源:官方 Releases

常见问题

Paseo 自带 AI 编程能力吗?需要单独装 Claude Code 吗?

不自带。Paseo 是控制台,编排你已装好的编程 Agent。必须先安装并登录至少一个 Agent CLI(Claude Code / Codex / Copilot / OpenCode / Pi 之一)。

有不用命令行的安装方式吗?

有。桌面版从 paseo.sh/download 下载,打开后 daemon 自动启动、安装本身不需要命令行(仍需完成配对并装好 Agent CLI)。

配置文件在哪?

默认在 ~/.paseo(环境变量 PASEO_HOME 可改)。

能用手机控制吗?

能。扫码配对后,手机 / Web / 桌面 / CLI 多端都能控制,也支持语音控制。

为什么没有出现配对二维码?

Relay 默认未启用。运行 paseo daemon pair 并确认提示,或在桌面端 Pair a device 中启用 relay;也可以复制配对链接到手机 App。

Agent CLI 在终端能用,但 Paseo 找不到怎么办?

先确认 Agent 已独立登录成功,再运行 paseo provider diagnostic codex(按需换成 claude 等 provider),检查 daemon 实际使用的 PATH、可执行文件路径和状态。桌面端也可在 Settings → 你的 host → Providers → 对应 provider → Diagnostic 查看诊断。

如何升级 Paseo?

桌面端在 Settings → About 检查更新;Release channel 可选择 Stable 或 Beta,普通用户建议保持 Stable。CLI 可重新运行 npm install -g @getpaseo/cli 更新安装包;运行中的 daemon 可能仍使用旧进程,按安装方式完成重启前先处理好正在运行的任务。v0.8.0 升级后,macOS 桌面端至少需要 macOS 13;维护自定义插件的用户还要先看插件迁移说明。

v0.8.0 的远程命令为什么和旧教程不一样?

v0.8.0 把 --host 改成全局选项,因此写成 paseo --host ssh://user@host run ...;如果把它放在 run 后面,本机可能提示参数不存在。升级后用 paseo --help 和 paseo run --help 重新确认选项。

每个 Agent provider 的详细配置在哪看?

请从Paseo 官方文档的 Providers 栏目进入对应配置页;Agent 的账号授权和模型可用性以各 Agent 自己的官方说明为准。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件