ドキュメント · トピック
ホストを設定
ホストを設定 は、コーディングエージェントのライフサイクルフックを Moshpit に接続し、iPhone 上でエージェントの状態を確認できるようにするとともに、要対応やターン完了時の暗号化プッシュ通知を有効にします。
ホスト設定を実行する
Section titled “ホスト設定を実行する”Moshpit がホスト側を無断で変更することはありません。初回接続時に確認のうえ導入を提案し、その後もいつでも確認・テスト・修復・削除ができます:
- Moshpit でホストに接続します。
- 設定 › このホストを設定(ホストを設定)を開き、接続中のホストをタップします。
- エージェント状態 でエージェントを選び、インストール(または 更新 / 再インストール)をタップします。開いている tmux ペイン上で直下のテスト行をタップすると、スクリプトの動作を検証できます。
- プッシュ で ペアリング(または 再ペアリング)をタップし、Moshpit を画面に表示したまま テスト通知を送信 をタップして往復到達を確認します。
プッシュ通知にはホスト側に openssl と curl が必要です。jq は任意ですが、入っていると完了通知にエージェントが回答したプロンプト内容も含められます。
ホストに書き込まれるファイル
Section titled “ホストに書き込まれるファイル”Moshpit 関連のファイルはすべて ~/.moshpit 配下に置かれ、明示的に確認しない限り、そのホスト上で検出されたエージェントにのみフックが追加されます:
| パス | 役割 |
|---|---|
~/.moshpit/moshpit-stamp.sh |
エージェントフックから呼ばれ、tmux ペインに @moshpit_* オプションを記録し、「要対応」「完了」のプッシュを起動します。 |
~/.moshpit/moshpit-push.sh |
ホスト上で状態ペイロードを暗号化し、暗号文をプッシュリレーへ送信します。 |
~/.moshpit/manifest.json |
導入済みファイルの SHA-256 ダイジェスト。スクリプトが古くなったか判定するために使います。 |
~/.moshpit/push.d/<connection-id>.conf |
この端末固有の 256 ビットペアリング秘密鍵と送信トークン(パーミッション 0600)。 |
<config>.moshpit.orig |
エージェント設定ファイルを初回編集する前に保存する 1 回限りのバックアップ。 |
ホストに存在するエージェントに応じて、~/.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 でフックを信頼する
Section titled “Codex でフックを信頼する”Codex は新しく追加されたフックをホスト側で承認するまで実行しません:
- ホストのシェルで
codexを起動します。 /hooksを実行します。- Moshpit の 4 つのエントリを信頼済みとしてマークします。
この手順を終えるまで、Codex は tmux 上の状態報告やプッシュ送信を行いません。
元に戻す・削除する
Section titled “元に戻す・削除する”ホストに接続した状態で 設定 › このホストを設定 を開きます:
- 特定のエージェントだけ外す:エージェント状態 で該当エージェントを選び、削除 をタップします。
- この端末のプッシュだけ止める:プッシュ で ペアリング解除 をタップすると、この端末のペアリングファイルが削除され通知が止まります。
- すべて削除する:このホストから Moshpit を削除 をタップして確定します。すべてのエージェント設定から Moshpit のフック項目だけを取り除き(他の設定はそのまま保持)、この端末のペアリングを削除し、他にペアリング済みの端末がなければ
~/.moshpit自体も削除します。