Host Helper 快速安装 + 纯终端兼容模式
安装 Moshline Host Helper,再扫描一个二维码。
稳定的 GitHub quick-setup 地址会安装带版本号并经过 SHA-256 校验的 Host Helper,同时配置 SSH、Mosh、后台常驻服务和受支持的编程 Agent Hook;Inbox、审批与 Usages 都依赖这条本地链路。
Mac 设置
安装脚本和版本化 Host Helper 包均由 GitHub 的 NomadShell/Scripts 仓库分发。
- 运行 quick setup,自动安装 SSH/Mosh 依赖与校验过的 Moshline Host Helper。
- SSH 公钥注入继续兼容 NOMAD_PUBKEY_B64,无需修改现有自动化。
- 扫描 Host Helper 二维码,然后运行 moshline-host doctor 检查后台服务和 Agent Hook。
- 在可信网络中保持 SSH 与 Host Helper 的 24000 端口可达,并为 Mosh 放行 UDP 60000-61000。
- 旧的纯终端二维码流程可用 MOSHLINE_TERMINAL_ONLY=1;该模式不提供 Inbox 和 Usages。
$
curl -fsSL https://raw.githubusercontent.com/NomadShell/Scripts/main/quick-setup.sh | bash$
NOMAD_PUBKEY_B64='<base64-authorized-key-line>' bash -c "$(curl -fsSL https://raw.githubusercontent.com/NomadShell/Scripts/main/quick-setup.sh)"$
MOSHLINE_TERMINAL_ONLY=1 bash -c "$(curl -fsSL https://raw.githubusercontent.com/NomadShell/Scripts/main/quick-setup.sh)"iOS 设置
先配对 Host Helper,再连接并验证所需的 Agent 功能。
- 打开 Moshline,从 Add Server 扫描 Host Helper 二维码。
- 选择认证方式:安全隔区 SSH 密钥(推荐)或密码。
- 运行受支持的编程 Agent 后打开 Inbox,确认能收到启动、审批和完成事件。
- 只有 Codex 上报可信 Usage 数据后 Usages 才会显示;单纯建立终端连接无法推算用量。
- 若功能缺失,先在已配对主机运行 moshline-host doctor,再重新连接。
Host Helper 已配对只代表连接正常;Codex 尚未上报可信用量时,Usages 会明确显示为不可用,其他 Provider 在当前版本保持为空。
完成编程智能体闭环
信任 Codex Hook
Host Helper 安装完成后,交互式启动 Codex,运行 /hooks,检查 Moshline 命令并信任当前定义。Codex 会跳过尚未信任或内容已变化的非托管 Hook。
验证推送送达
扫描 Host Helper 二维码并允许通知,然后在 Moshline 中打开“设置 → Agent Setup”,发送 Test Webhook。配对会把这台 iPhone 的私有 Webhook 目标连接到 Host。
仅显示 Codex 上报的用量
Moshline 只读取 Codex transcript 中经过验证的 token 与 rate-limit 数据,不会根据终端活动估算;其他 Provider 或过期数据会保持为空。