getpaseo/paseo
GitHub: getpaseo/paseo
一个自托管的多提供商编码智能体编排平台,支持在桌面和移动端跨设备并行运行 Claude Code、Codex、Copilot 等 AI 编码代理。
Stars: 8653 | Forks: 823
Paseo
English ·
简体中文
一个接口集成 Claude Code、Codex、Copilot、OpenCode 和 Pi agents。
在你自己的机器上并行运行 agents。通过手机或桌面端进行交付。
- **自托管:** Agents 在你的机器上运行,拥有完整的开发环境。使用你自己的工具、配置和技能。
- **多提供商:** 通过相同的界面支持 Claude Code、Codex、Copilot、OpenCode 和 Pi。为每项任务选择合适的模型。
- **语音控制:** 在语音模式下口述任务或讨论问题。在需要时解放双手。
- **跨设备:** 支持 iOS、Android、桌面端、网页端和 CLI。在桌面前开始工作,通过手机查看进度,在终端中编写脚本。
- **隐私优先:** Paseo 没有任何遥测、跟踪或强制登录。
## 入门指南
Paseo 会运行一个名为 daemon 的本地服务器来管理你的编码 agents。像桌面应用、移动应用、网页应用和 CLI 这样的客户端会连接到它。
### 前置条件
你需要至少安装并配置好一个 agent CLI 的凭证:
- [Claude Code](https://docs.anthropic.com/en/docs/claude-code)
- [Codex](https://github.com/openai/codex)
- [GitHub Copilot](https://github.com/features/copilot/cli/)
- [OpenCode](https://github.com/anomalyco/opencode)
- [Pi](https://pi.dev)
### 桌面应用(推荐)
从 [paseo.sh/download](https://paseo.sh/download) 或 [GitHub releases 页面](https://github.com/getpaseo/paseo/releases) 下载。打开应用,daemon 将自动启动。无需安装其他任何东西。
要从手机进行连接,请扫描“设置”中显示的二维码。
### CLI / 无头模式
安装 CLI 并启动 Paseo:
```
npm install -g @getpaseo/cli
paseo
```
这会在终端中显示一个二维码。你可以从任何客户端进行连接。此路径适用于服务器和远程机器。
如需完整的设置和配置,请参阅:
- [文档](https://paseo.sh/docs)
- [配置参考](https://paseo.sh/docs/configuration)
## CLI
所有在应用中能完成的操作,都可以在终端中完成。
```
paseo run --provider claude/opus-4.6 "implement user authentication"
paseo run --provider codex/gpt-5.4 --worktree feature-x "implement feature X"
paseo ls # list running agents
paseo attach abc123 # stream live output
paseo send abc123 "also add tests" # follow-up task
# 在远程 daemon 上运行
paseo --host workstation.local:6767 run "run the full test suite"
```
有关更多信息,请参阅[完整 CLI 参考](https://paseo.sh/docs/cli)。
## 技能
技能可以教会你的 agent 使用 Paseo 来编排其他 agents。
```
npx skills add getpaseo/paseo
```
然后即可在任何 agent 对话中使用它们:
- `/paseo-handoff` — 在 agents 之间移交工作。我通常使用它先用 Claude 进行规划,然后移交给 Codex 进行实现。
- `/paseo-loop` — 根据明确的验收标准(即 Ralph 循环)循环运行 agent,可选择搭配一个验证器。
- `/paseo-advisor` — 启动单个 agent 作为顾问以提供第二意见,而不实际委派工作本身。
- `/paseo-committee` — 组建一个由两个风格互补的 agents 组成的委员会,以退一步进行根本原因分析并制定计划。
## 开发
快速 monorepo 包映射:
- `packages/server`:Paseo daemon(agent 进程编排、WebSocket API、MCP 服务器)
- `packages/app`:Expo 客户端(iOS、Android、网页)
- `packages/cli`:用于 daemon 和 agent 工作流的 `paseo` CLI
- `packages/desktop`:Electron 桌面应用
- `packages/relay`:用于远程连接的 Relay 包
- `packages/website`:营销网站和文档(`paseo.sh`)
常用命令:
```
# 运行所有本地 dev services
npm run dev
# 运行单个 surfaces
npm run dev:server
npm run dev:app
npm run dev:desktop
npm run dev:website
# 构建 server stack
npm run build:server
# repo 范围检查
npm run typecheck
```
## 许可证
AGPL-3.0
标签:AI智能体, MITM代理, SOC Prime, 代码助手, 工作流编排, 开发工具, 自动化攻击, 自托管, 跨平台开发