执行中
真实终端镜像
提供完整终端输出而非摘要或文本日志。ColliePWA 保留 ANSI 颜色与原始排版，呈现与本地桌面一致的终端状态。
01/演示
在线试用
这里运行的是真实的 ColliePWA 前端。智能体列表、终端和响应均为浏览器本地回放的模拟数据。无后台进程，不发送任何网络请求。
- 01点击顶部标记为 blocked 的智能体。
- 02查看当前提问。内容来自真实终端镜像。
- 03点击选项提交回答，观察执行流程继续。
- 04点击 Keys 唤出按键栏。提供 Esc、Tab、方向键、Ctrl 等移动端缺失的按键。
02/核心功能
解决两个关键问题，以及 1.0 的更新内容。
等待输入
点击快速响应
权限确认提示自动解析为操作按钮。系统在发送前会校验当前屏幕状态，避免误触已过期的确认项。
1.0 新特性
04显式设备配对
运行 collie pair 生成 8 位配对码，有效期 10 分钟且限尝试 5 次。移动端以此换取单次显示的访问令牌，bridge 端仅存储哈希值。支持按设备名随时吊销凭证。
05语音输入转写
按住录音，音频转写后自动填入输入框。支持任意 OpenAI 兼容接口（包括自建 whisper.cpp 或 parakeet.cpp），也可复用 Codex CLI 现有凭证。依赖 HTTPS，可通过 tailscale serve 启用。
06状态变更推送通知
当 Agent 等待输入或执行完毕时发送 Web Push。点击通知直接打开对应 Agent。依赖 HTTPS，并通过 collie push-keys 配置。
07Worktree 映射为独立 Space
在 Herdr 中打开已有仓库的 git worktree 时，会自动嵌套在主 checkout 下方展示。由 Herdr 直接管理，具备标准 space 的完整行为。
访问入口
09自定义单一接入点
ColliePWA 默认仅监听 loopback 接口，不直接暴露到公网。collie start 支持自动配置 Tailscale。亦可选用其他 Mesh 网络、隧道工具或自建反向代理，文档均提供对应配置说明。
10单入口聚合多节点
每台机器均运行 ColliePWA 即可组成 Pack。手机通过 lead 节点访问全部机器。文件上传、日志、审计记录、更新与故障转移均在单机独立处理，在 tmux 和 zellij 下同样适用。Herdr 保存的机器仅留在 Herdr 自身窗口内。手机看到的列表才是 Pack。
其他特性
- 11全量智能体聚合视图
- 按待处理状态归类所有智能体，等待用户输入的阻塞任务自动置顶。
- 12完整历史回滚
- 直接读取智能体原始会话记录，支持向上滚动查看完整运行过程，不局限于当前屏幕帧。
- 13多 Session 统一管理
- 接入 Herdr 时，直接管理配置目录下的所有命名会话，可在顶部导航直接切换而无需登录主机。
03/适用场景
面向在终端复用器中运行智能体、经常离开座位的开发者。
ColliePWA 专为在单台主机终端窗格中运行多个代码智能体的开发者设计。它不取代现有终端，只是让你能在手机上直接回复处于等待中的智能体，随时随地继续处理手头事务。
- 无缝接入现有工作流
- 直接连接已在运行的终端复用器：Herdr、tmux 或 zellij。无需引入新的会话机制，无需包裹智能体进程。Herdr 在 1.0 中获完整支持，tmux 和 zellij 为实验性支持。
- 无应用商店、无云端服务、无账号绑定
- 通过 tailnet 由本地机器直接分发的 PWA。无应用市场审核、无厂商账号、无云端付费层。唯一的外部依赖取决于你的主动配置：浏览器推送服务，或在非本地引擎方案下选择的云端转录接口。添加到手机主屏幕即可像原生应用一样运行。
- 专为触屏补足缺失按键
- 特殊按键、方向键和修饰键均集成在屏幕键盘中。预设的快捷回复与斜杠命令一触即发。输入框采用标准纯文本设计，可直接使用手机自带的语音输入。在 HTTPS 环境下运行
collie stt setup即可开启内置语音输入支持。 - 智能体等待输入时接收通知
- 可选的 Web Push 推送，在智能体阻塞等待输入或执行完毕时发送提醒。点击通知可直接打开对应窗格。该功能需要 HTTPS 环境并执行
collie push-keys。 - 多机集群，单一入口
- Pack 功能将多台主机聚合在单一访问地址下，支持预先授权并在浏览器端直接触发故障转移。只需单次确认即可在同一界面更新整个集群。
- MIT 协议。欢迎参与贡献。
- 源代码以 MIT 协议托管于 GitHub。欢迎反馈 tmux 与 zellij 环境下的异常问题，也欢迎提交正常运行的配置反馈。
04/运行环境
直接运行在本地，拥有完整 Shell 权限。
ColliePWA 直接以当前用户的权限向活动终端发送输入指令。任何能访问该 URL 的客户端均可查看所有窗格并执行任意命令。该机制属于设计核心，因此系统不提供任何云端托管支持。
- 与智能体同机运行
- 直接部署在目标工作站上，镜像多路复用器状态。1.0 版本对 Herdr 提供完整支持；tmux 和 zellij 支持处于实验阶段，目前仅在单机环境验证过，欢迎提交 issue。无中心服务器，无云端依赖，无需注册账号。
- 回环监听与单入口
- 服务仅绑定本地回环地址，绝不监听 0.0.0.0。对外通信必须经过加固的单一接入点，例如 tailscale serve 或自定义反向代理。严禁使用 Tailscale Funnel 等公网穿透。
- 基于设备信任，无用户鉴权
- 网关仅验证客户端设备证书，不进行身份识别。应用本身不包含密码认证与登录界面，任何已解锁的已授权设备均可直接控制终端。
- 本地多用户隔离限制
- 终端复用器使用本地 socket 文件通信，受文件系统权限保护。ColliePWA 通过 TCP 端口监听，同一主机上的其他用户均可访问该端口。需通过接入层 ACL 控制访问，在 Tailscale 环境下请配置 COLLIE_TRUSTED_USER。
遵循 MIT 开源许可，代码完全透明。更多安全边界与风险说明，请在部署前查阅安全说明文档。
05/安装
单条命令安装，或手动从源码构建。
ColliePWA 直接部署在运行智能体的主机上。安装脚本会自动下载并校验目标平台的预编译文件。无预编译支持的系统可通过 git 和 Bun 从源码构建。两种方式均将 collie 写入 PATH，且不会自动拉起后台服务。
$ curl -fsSL https://colliepwa.dev/install.sh | sh
单页 POSIX sh 脚本。不需要 sudo 权限，不注册后台服务，仅向 ~/.local/share/collie 和 ~/.local/bin 写入文件。它自动拉取适配系统的最新稳定构建，通过官方发布的 sha256 校验包完整性并阻止异常安装。新版本与历史版本并行存放，并将二进制链接至 PATH，最后输出剩余操作。仅依赖 curl、tar 和 sha256 工具，不需要编译工具链。
当前 URL 为镜像分发地址。源码文件位于 ColliePWA 官方仓库中的 scripts/install.sh。建议在执行前审查脚本内容：
$ curl -fsSL https://raw.githubusercontent.com/AltanS/collie/main/scripts/install.sh | less$ curl -fsSL https://raw.githubusercontent.com/AltanS/collie/main/scripts/install.sh | sh
后续可通过 collie update 获取新版本、校验并重启。旧版本文件保留在磁盘上，随时可用 collie update --rollback 回滚。此机制仅适用于预编译安装。源码构建模式会直接更新本地代码库，不保留旧版本快照。
同步自 scripts/install.sh，提交记录 2ded11d，2026-08-31。
最后一步：启动即可。
# one step left. It asks which multiplexer to mirror — herdr, tmux or# zellij — and writes your answer to ~/.config/collie/.env, creating it.$ collie start
配置为可选内容，位于 start 生成的 ~/.config/collie/.env 文件中。若默认值不适用，可在其中配置 COLLIE_TRUSTED_USER 以及端口或入口地址。
使用同一局域网或内网内的手机访问输出的 URL。将其添加至主屏幕后可作为 PWA 应用运行。
需要配置私有网络接入：ColliePWA 默认仅监听本地回环地址，不暴露公网端口。必须通过中继将主机端口安全映射至移动设备。默认推荐 Tailscale：执行 collie start 会调用 tailscale serve 并输出可访问的 MagicDNS 域名。同时支持其他虚拟内网、隧道或反向代理方案，具体配置参见 DEPLOYMENT.md。ColliePWA 仅支持单用户模式，不包含多租户或公网匿名访问机制。