Docs · Sujet
Configurer un hôte
Configurer un hôte relie les hooks de cycle de vie de vos agents de codage à Moshpit afin que votre iPhone voie l’état de chaque agent et reçoive des notifications push chiffrées lorsqu’un agent vous attend ou termine un tour.
Lancer la configuration de l’hôte
Section titled “Lancer la configuration de l’hôte”Moshpit ne modifie jamais rien sur un hôte en silence. Il demande votre accord avant sa première installation lors de la connexion, et vous pouvez inspecter, tester, réparer ou retirer cette configuration à tout moment :
- Connectez-vous à l’hôte dans Moshpit.
- Ouvrez Réglages › Configurer cet hôte et touchez l’hôte connecté.
- Sous ÉTAT DE L’AGENT, choisissez un agent et touchez Installer (ou Mettre à jour / Réinstaller). Touchez la ligne Tester les hooks ci-dessous dans un panneau tmux ouvert pour vérifier que le script s’exécute.
- Sous NOTIFICATIONS PUSH, touchez Jumeler (ou Rejumeler), puis touchez Envoyer une notification de test tout en gardant Moshpit affiché au premier plan pour confirmer la réception.
Les notifications push nécessitent openssl et curl sur l’hôte. Installer jq est facultatif et permet aux notifications « Terminé » d’inclure le prompt auquel l’agent a répondu.
Ce qui est écrit sur l’hôte
Section titled “Ce qui est écrit sur l’hôte”Tous les fichiers de Moshpit vivent dans ~/.moshpit, et seuls les agents détectés sur cet hôte reçoivent des entrées de hooks, sauf si vous confirmez explicitement l’installation pour un autre agent :
| Chemin | Rôle |
|---|---|
~/.moshpit/moshpit-stamp.sh |
Appelé par les hooks d’agent ; inscrit les options @moshpit_* sur le panneau tmux et déclenche les notifications « vous attend » et « terminé ». |
~/.moshpit/moshpit-push.sh |
Chiffre l’état sur l’hôte et envoie le texte chiffré au relais push. |
~/.moshpit/manifest.json |
Empreintes SHA-256 des fichiers installés pour que Moshpit sache quand les scripts sont obsolètes. |
~/.moshpit/push.d/<connection-id>.conf |
Secret de jumelage 256 bits et jeton d’envoi de cet iPhone, écrits avec les droits 0600. |
<config>.moshpit.orig |
Sauvegarde unique enregistrée avant que Moshpit ne modifie un fichier de configuration d’agent pour la première fois. |
Selon les agents présents sur l’hôte, Moshpit fusionne ses hooks dans ~/.claude/settings.json, ~/.codex/config.toml, ~/.gemini/settings.json, ~/.qwen/settings.json, ~/.qoder/settings.json, ~/.factory/settings.json (ou ~/.factory/hooks.json) et ~/.codebuddy/settings.json. Les réglages déjà présents dans ces fichiers sont préservés.
Approuver les hooks dans Codex
Section titled “Approuver les hooks dans Codex”Codex n’exécute pas les hooks nouvellement ajoutés tant que vous ne les avez pas approuvés sur l’hôte :
- Lancez
codexdans un shell sur votre hôte. - Exécutez
/hooks. - Approuvez les quatre entrées de Moshpit.
Tant que cette étape n’est pas effectuée, Codex ne signale pas son état dans tmux et n’envoie pas de notifications push.
Annuler ou retirer
Section titled “Annuler ou retirer”Ouvrez Réglages › Configurer cet hôte en étant connecté à l’hôte :
- Un seul agent : choisissez l’agent sous ÉTAT DE L’AGENT et touchez Retirer.
- Les notifications push sur cet iPhone : touchez Dissocier sous NOTIFICATIONS PUSH pour supprimer le fichier de jumelage de cet iPhone et arrêter les envois depuis cet hôte.
- Tout retirer : touchez Retirer Moshpit de cet hôte et confirmez. Moshpit supprime ses hooks de chaque configuration d’agent (sans toucher au reste du fichier), retire le jumelage de cet iPhone et supprime
~/.moshpitsi aucun autre iPhone n’est encore jumelé à l’hôte.