Mohamed Boudra
3dbbbb535e
* feat(website): rework sponsorship with homepage sponsor spots The founder note now states how the project is funded (sponsorship and Paseo Hub) instead of describing the product, and the same note and backing links render on the homepage and /sponsor from one module so the two cannot drift. Companies can sponsor one of four homepage logo spots at $500 a month through Stripe rather than GitHub Sponsors, because they need invoices and a vendor relationship. The spots render as placeholders until sold; approving a sponsor is an entry in src/data/sponsors.ts. The checkout URL is a placeholder until the Stripe Payment Link exists. * feat(website): point sponsor spot checkout at the Stripe payment link * docs(readme): add a sponsors section * docs(readme): add the sponsors section to the translated READMEs * docs(website): document the sponsor approval and Stripe cap workflow
6.8 KiB
Paseo
Claude Code、Codex、Copilot、OpenCode 和 Pi agents 的统一界面。
Note
我是独立维护者，不一定每天都能及时处理 GitHub Issues。 如果问题很紧急或阻塞了你，Discord 是最快联系到我的地方。
在你自己的机器上并行运行 agents。无论在手机上还是桌前，都能推进交付。
- 自托管： Agents 在你的机器上运行，使用完整的本地开发环境、工具、配置和技能。
- 多提供商： 通过同一个界面使用 Claude Code、Codex、Copilot、OpenCode 和 Pi。为每个任务选择合适的模型。
- 语音控制： 在语音模式下口述任务或讨论问题。需要免手操作时很方便。
- 跨设备： 支持 iOS、Android、桌面端、Web 和 CLI。在桌前开始工作，用手机查看进度，也可以从终端脚本化操作。
- 隐私优先： Paseo 没有遥测、追踪，也不会强制登录。
快速开始
Paseo 会运行一个名为 daemon 的本地服务，用来管理你的 coding agents。桌面 app、移动 app、Web app 和 CLI 等客户端都会连接到它。
前置条件
你至少需要安装一个 agent CLI，并用你的凭据完成配置：
桌面 app（推荐）
从 paseo.sh/download 或 GitHub releases 页面下载。打开 app 后 daemon 会自动启动，不需要再安装其他东西。
如果要从手机连接，在 Settings 中扫描显示的二维码。
CLI / 无头模式
安装 CLI 并启动 Paseo：
npm install -g @getpaseo/cli
paseo
终端中会显示一个二维码。你可以从任意客户端连接。这个方式适合服务器和远程机器。
完整安装和配置见：
CLI
你能在 app 中完成的事情，也都可以在终端中完成。
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 # 列出正在运行的 agents
paseo attach abc123 # 实时流式查看输出
paseo send abc123 "also add tests" # 发送后续任务
# 在远程 daemon 上运行
paseo --host workstation.local:6767 run "run the full test suite"
更多内容见完整 CLI 参考。
Skills
Skills 会教你的 agent 使用 Paseo 来编排其他 agents。
npx skills add getpaseo/paseo
然后在任意 agent 对话中使用：
/paseo-handoff— 在 agents 之间交接工作。我会用它先和 Claude 规划，再交给 Codex 实现。/paseo-advisor— 启动单个 agent 作为 advisor，提供第二意见，但不把工作委托出去。/paseo-committee— 组建两个风格互补的 agents，让它们后退一步做根因分析并产出计划。
开发
Monorepo 包结构速览：
packages/server：Paseo daemon（agent 进程编排、WebSocket API、MCP server）packages/app：Expo 客户端（iOS、Android、Web）packages/cli：用于 daemon 和 agent 工作流的paseoCLIpackages/desktop：Electron 桌面 apppackages/relay：用于远程连接的 relay 包packages/website：营销站点和文档（paseo.sh）
常用命令：
# 运行所有本地开发服务
npm run dev
# 单独运行某个界面
npm run dev:server
npm run dev:app
npm run dev:desktop
npm run dev:website
# 构建 server stack
npm run build:server
# 全仓库检查
npm run typecheck
赞助
Paseo 由一个人开发，靠使用它的人来资助。你可以通过 GitHub Sponsors 支持这项工作，或者以每月 500 美元赞助一个展示位，把贵公司的 logo 放在这里和 paseo.sh 首页上。
相关项目
- getpaseo/paseo-relay — 官方分布式 relay，使用 Elixir 编写
- paseo-vscode — VS Code 扩展
自托管 relay TLS
自托管 relay 默认使用 ws://，除非显式启用 TLS。对于 nginx 后面、监听 443 的 relay，可以这样启动 daemon：
PASEO_RELAY_ENDPOINT=127.0.0.1:8080 \
PASEO_RELAY_PUBLIC_ENDPOINT=relay.example.com:443 \
PASEO_RELAY_USE_TLS=true \
paseo daemon start
等价配置：
{
"daemon": {
"relay": {
"enabled": true,
"endpoint": "127.0.0.1:8080",
"publicEndpoint": "relay.example.com:443",
"useTls": true
}
}
}
最小 nginx WebSocket 代理配置：
server {
listen 443 ssl;
server_name relay.example.com;
ssl_certificate /etc/letsencrypt/live/relay.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/relay.example.com/privkey.pem;
location /ws {
proxy_pass http://127.0.0.1:8080;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
}
}
License
Apache-2.0