用途:让任意主机在 Moshi 远程编码中易于使用,适用于全新设置或验证已有设置。Moshi 将 Herdr、tmux、Zellij 视为一等多路复用器;Herdr 支持自 iOS 3.1 起,相关工作流需 3.10 或更高版本。
主要能力与规则:先检查再修改;优先直接编辑配置而非平台专用脚本;每次改动后验证;不要安装旧的 moshi shell helper 或别名。编码智能体会话优先用 Herdr,但仍保留 tmux,因为打包的 moshi DIR 启动器和 Recent-directories 一键流程仍创建 tmux 会话。Herdr 主机上 moshi-hook 必须已配对并运行过 moshi-hook install,Herdr 没有屏幕抓取回退,钩子是唯一提示来源。
主机就绪:优先 Easy Pair(moshi-hook host setup 或 moshi host setup),让用户扫描 Moshi 中的二维码;注意安全边界,二维码过期前被他人扫描即可获得 SSH 访问。目标为 Mosh 加多路复用器,回退为 SSH(或 Pro 的 Eternal Terminal)加多路复用器;mosh-server 需安装;二进制需在当前 shell 与登录 shell 非交互模式下可解析;至少存在一个多路复用器会话。
Herdr:安装可用 curl -fsSL https://herdr.dev/install.sh | sh、brew install herdr 或 mise use -g herdr。建议单会话、每项目一个工作区,标签用于主智能体、审查、测试、服务器等。非标准安装可设 MOSHI_HERDR_PATH。
tmux 回退:默认建议 history-limit 100000、mouse on、set-titles on、base-index 1、pane-base-index 1、renumber-windows on。moshi . 或 moshi ~/projects/app 会以目录名创建 tmux 会话。注意部分 RHEL/Alma/Rocky 10 的 tmux 3.3a-12 至 3.3a-14 RPM 在 capture-pane 时可能损坏服务器,Moshi 会自动禁用相关功能,建议改用 Herdr 或升级 tmux 3.5a+。
MOSHI_CLIENT:可选环境变量,在应用设置中开启(需 Pro),用于 rc 文件与 tmux 配置检测 Moshi 会话。
moshi-hook:便携 Go 守护进程,支持 Claude Code、Codex CLI、OpenCode、Gemini CLI、Antigravity、Cursor、Kimi、Qwen Code、Grok Build、OMP、Pi、Hermes Agent 等。安装后执行 moshi-hook pair --token <YOUR_TOKEN> 与 moshi-hook install,并用 brew services start moshi-hook 或 moshi-hook service install 保持运行。macOS 默认用 Keychain,无头主机可用 --store file(会明文存于 ~/.config/moshi/secrets.json,0600 权限)。
验证:moshi-hook status、moshi-hook logs -f,并运行真实智能体任务确认推送与审批回传。限制:部分功能依赖 Pro;Herdr 上钩子为必需;资料未提供价格与更多平台细节。