collie

环境要求

• 在宿主机（电脑/服务器）上执行安装，不要在手机上运行
• 需要 curl、tar 和一个 sha256 校验工具
• 无需编译器工具链，也无需 sudo 权限
• 宿主机上已安装 Herdr、tmux 或 zellij 之一（多路复用器）
• 手机需能通过网络访问宿主机（Collie 仅绑定 loopback，通常配合 Tailscale）

安装与启动步骤

1. 1在宿主机安装

   在电脑或服务器上执行官方安装脚本，它会下载对应平台的最新 release、校验 sha256 并把 collie 写入 PATH。

   curl -fsSL https://colliepwa.dev/install.sh | sh

   复制

2. 2按提示初始化配置

   安装脚本结束时会打印后续手动步骤，第一步是 seed a config（生成初始配置）。README 未给出该命令原文，请照脚本输出执行。

3. 3启动 collie

   首次运行会探测宿主机的 Herdr、tmux、zellij 并提示你选择多路复用器，无需事先指定。

   collie start

   复制

4. 4手机浏览器访问

   用手机打开 collie 提供的地址，即可查看哪个 agent 正在等待输入，并用移动端键盘直接回复。端口与访问地址以启动时输出为准。

5. 5（可选）先在线体验

   不想先安装可以打开官方 demo，它在网页里运行一份真实的 Collie 构建，但对接的是伪造数据。

如何确认成功

启动后终端无报错，用手机浏览器打开 Collie 地址能看到状态面板与各 agent 窗格，即为成功。

常见问题

注意事项

• Collie 只绑定 loopback，远程访问必须自己在前端加一层（如 Tailscale），部署变体见 docs/deployment.md。
• 语音输入默认关闭，需要显式配置后才启用，详见 docs/voice-and-push.md。
• 手动从源码构建、Herdr 路由、需求表以及首次运行写入主机的文件清单见 docs/install.md。
• 早期项目，功能聚焦移动端管理，README 未给出具体端口与配置文件路径，以安装/启动时的实际输出为准。