快速开始
Shepaw 调度的是你机器上已经在跑的编码 Agent，自己不内置模型。最快路径：本机装 Hub，手机装 App，扫一张码。
Getting started
Shepaw drives coding agents that already run on your machine. It does not ship a model. Fastest path: Hub on the computer, app on the phone, one QR.
你需要准备
Prerequisites
- 一台能跑 Agent CLI 的电脑（macOS / Linux / Windows）
- Node.js ≥ 18.17
- 至少一个引擎：Claude Code、Codex、Cursor、Gemini、Copilot、Qwen Code 等，完整列表
- Shepaw App（iOS / Android / 桌面）
- A computer that can run an agent CLI (macOS / Linux / Windows)
- Node.js ≥ 18.17
- At least one engine: Claude Code, Codex, Cursor, Gemini, Copilot, Qwen Code, and more — full list
- The Shepaw app (iOS / Android / desktop)
1. 安装 Agent Hub
1. Install Agent Hub
curl -fsSL https://raw.githubusercontent.com/shepaw/agent-bridge/main/scripts/install.sh | bash # 或 npm install -g shepaw-agent-hub
只要单 Agent、不要仪表盘，可以改装 shepaw-acp-proxy-gateway。
For a single agent without the dashboard, install shepaw-acp-proxy-gateway instead.
2. 启动并添加项目
2. Start and add a project
shepaw-hub quickstart # 选引擎 → 确认工作目录 → 终端打印二维码 # 或者分步： shepaw-hub web # 浏览器打开 :4000，添加实例（引擎 + cwd）
SHEPAW_HUB_TOKEN，并用 --host 0.0.0.0。SHEPAW_HUB_TOKEN and pass --host 0.0.0.0.3. 手机扫码
3. Scan from the phone
打开 Shepaw → Device Pairing / Scan to Connect，扫描 Hub 生成的 shepaw://peer 二维码。手机和电脑要在同一 Wi-Fi。这不是「添加远端 Agent」里的 shepaw://pair。
In Shepaw open Device Pairing / Scan to Connect and scan the hub’s shepaw://peer QR. Phone and computer must share Wi-Fi. This is not the shepaw://pair flow under Add Agent.
4. 开始对话
4. Chat
配对成功后，Peer 通道可以访问这台机器上已授权的全部实例。文件操作和权限弹窗在网关主机执行，再回显到手机。
After pairing, the Peer channel can reach every authorized instance on that host. File ops and permission prompts run on the gateway machine and surface in the app.