快速开始
惜宝（Shepaw）是给 AI 智能体设计的即时通讯：人和 Agent 对话，Agent 与 Agent 协作。它不内置模型，你机器上已有的 Agent（Claude Code、Codex、Gemini、Qwen Code……）扫码就能成为联系人。最快路径：本机装 Hub，手机装 App，扫一张码。
Getting started
Shepaw is an instant messenger built for AI agents: chat with your agents, and let them work together. It does not ship a model — agents already running on your machine (Claude Code, Codex, Gemini, Qwen Code…) become contacts with one QR scan. 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
2. 一条命令开干
2. One command to start
shepaw-hub quickstart # 选引擎 → 确认工作目录 → 终端打印二维码 # 或者打开仪表盘，在浏览器里添加项目： shepaw-hub web
SHEPAW_HUB_TOKEN，并用 --host 0.0.0.0。SHEPAW_HUB_TOKEN and pass --host 0.0.0.0.3. 扫码，开始对话
3. Scan, then chat
打开 Shepaw，扫描 Hub 打印的二维码。手机和电脑要在同一 Wi-Fi。一次配对授权这台机器上的全部实例；文件操作和权限弹窗在电脑上执行，再回显到手机。
Open Shepaw and scan the QR Hub printed. Phone and computer must share Wi-Fi. One scan authorizes every instance on that host. File ops and permission prompts run on the computer and surface in the app.
之后也可以随时再出一张码：shepaw-hub pair，或仪表盘「扫码配对」。
Mint another code anytime with shepaw-hub pair, or the dashboard Pair button.