跳转到内容
moshpit

文档 · 专题

配置主机

配置主机 把主机上编程智能体的生命周期 hooks 接到 Moshpit,让手机读到每个智能体的实时状态,并在智能体等你拍板或跑完一轮时收到加密推送。

Moshpit 不会悄悄改动主机上的任何文件。第一次连上主机时,它会先询问再安装,之后你随时可以查看、测试、更新或卸载:

  1. 先在 Moshpit 里连上目标主机。
  2. 打开 设置 › 配置主机,点那台已连接的主机。
  3. 在 智能体状态 下选好智能体,点 安装(或 更新 / 重新安装)。打开一个 tmux 窗格后点下方的测试项,可以验证状态脚本是否生效。
  4. 在 推送 下点 配对(或 重新配对),保持 Moshpit 在前台,点 发一条测试通知 验证整条链路。

发送推送要求主机装有 openssl 和 curl。jq 是可选的,装上后「已完成」通知会附带智能体刚回答的那句提示词。

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 默认不会运行新写入的脚本,需要在主机上手动信任一次:

  1. 在主机的终端里启动 codex。
  2. 输入并运行 /hooks。
  3. 把 Moshpit 的四条记录设为信任。

完成这一步之前,Codex 不会在 tmux 里更新状态,也不会发出推送。

连着主机时打开 设置 › 配置主机:

  • 只撤某一个智能体:在 智能体状态 里选中它,点 删除。
  • 只停掉这台手机的推送:在 推送 下点 解除配对,删除这台手机对应的配对文件。
  • 全部移除:滑到底部点 从这台主机移除 Moshpit 并确认。每个智能体配置里的 Moshpit 条目都会删干净(其他配置不动),这台手机的配对也会删除。如果没有别的手机还和这台主机配对,~/.moshpit 目录会一并删掉。