文档 · 专题
配置主机
配置主机 把主机上编程智能体的生命周期 hooks 接到 Moshpit,让手机读到每个智能体的实时状态,并在智能体等你拍板或跑完一轮时收到加密推送。
运行主机配置
Section titled “运行主机配置”Moshpit 不会悄悄改动主机上的任何文件。第一次连上主机时,它会先询问再安装,之后你随时可以查看、测试、更新或卸载:
- 先在 Moshpit 里连上目标主机。
- 打开 设置 › 配置主机,点那台已连接的主机。
- 在 智能体状态 下选好智能体,点 安装(或 更新 / 重新安装)。打开一个 tmux 窗格后点下方的测试项,可以验证状态脚本是否生效。
- 在 推送 下点 配对(或 重新配对),保持 Moshpit 在前台,点 发一条测试通知 验证整条链路。
发送推送要求主机装有 openssl 和 curl。jq 是可选的,装上后「已完成」通知会附带智能体刚回答的那句提示词。
主机上会写入什么
Section titled “主机上会写入什么”Moshpit 自己的文件都放在 ~/.moshpit 下,默认只给主机上已经装了的智能体写配置(想提前给未安装的智能体写配置时,App 会先弹窗确认):
| 路径 | 用途 |
|---|---|
~/.moshpit/moshpit-stamp.sh |
由智能体的 hooks 调用,在 tmux 窗格上标记 @moshpit_* 状态,并在「在等你」和「已完成」时触发推送。 |
~/.moshpit/moshpit-push.sh |
在主机本地加密状态内容,把密文发给推送服务。 |
~/.moshpit/manifest.json |
记录已安装脚本的 SHA-256 摘要,用来判断脚本是否需要更新。 |
~/.moshpit/push.d/<connection-id>.conf |
这台手机的配对密钥与发送令牌,权限固定为 0600。 |
<config>.moshpit.orig |
Moshpit 首次修改某个智能体配置文件前留下的原始备份。 |
按主机上实际安装的智能体,Moshpit 会把配置合并进 ~/.claude/settings.json、~/.codex/config.toml、~/.gemini/settings.json、~/.qwen/settings.json、~/.qoder/settings.json、~/.factory/settings.json(若已有 ~/.factory/hooks.json 则写入该文件)以及 ~/.codebuddy/settings.json,文件里的其他原有设置原样保留。
Codex 的 /hooks 信任步骤
Section titled “Codex 的 /hooks 信任步骤”Codex 默认不会运行新写入的脚本,需要在主机上手动信任一次:
- 在主机的终端里启动
codex。 - 输入并运行
/hooks。 - 把 Moshpit 的四条记录设为信任。
完成这一步之前,Codex 不会在 tmux 里更新状态,也不会发出推送。
撤销与完整移除
Section titled “撤销与完整移除”连着主机时打开 设置 › 配置主机:
- 只撤某一个智能体:在 智能体状态 里选中它,点 删除。
- 只停掉这台手机的推送:在 推送 下点 解除配对,删除这台手机对应的配对文件。
- 全部移除:滑到底部点 从这台主机移除 Moshpit 并确认。每个智能体配置里的 Moshpit 条目都会删干净(其他配置不动),这台手机的配对也会删除。如果没有别的手机还和这台主机配对,
~/.moshpit目录会一并删掉。