moshterm

~ moshterm-hook

Le Companion

moshterm-hook est un petit programme qui tourne sur l’ordinateur utilisé par vos agents. C’est lui qui transforme un terminal en un outil qui sait quand un agent attend.

Obtenir l’app mobile

moshterm pour Android est disponible sur Google Play, et l’app pour iPhone et iPad le sera bientôt. Le terminal et les fonctions du Companion sont gratuits ; moshterm Pro ajoute les aperçus en direct.

App Store bientôt disponible Disponible sur Google Play

Ce qu’il ajoute

  • Approbations : la demande d’autorisation d’un agent arrive sur votre téléphone, et votre réponse lui est renvoyée.
  • Inbox et notifications : quelles sessions vous attendent, lesquelles sont en cours et lesquelles sont terminées.
  • Vue chat : la transcription de l’agent, lue sur votre ordinateur et affichée comme une conversation.
  • Jump To et la liste des sessions tmux, Zellij et Herdr dans le sélecteur.
  • Diffs et navigation dans les fichiers du dossier courant du terminal.

Sans lui, moshterm reste un terminal complet pour Mosh, Eternal Terminal et SSH.

La méthode simple

Connectez-vous à l’ordinateur depuis l’app. Si le Companion n’est pas présent, moshterm propose de l’installer par cette même connexion ; acceptez et il s’occupe du reste. Plus tard, l’app met à jour un Companion plus ancien de la même façon lorsque vous vous connectez.

À la main

Sur macOS, Linux ou WSL :

# installe dans ~/.local/bin et démarre le service en arrière-plancurl -fsSL https://mickmosh-relay.mick-fb5.workers.dev/install.sh | sh

L’installeur vérifie le téléchargement à l’aide des sommes de contrôle publiées si votre système dispose d’un outil SHA-256. Ajoutez ensuite les hooks de vos agents :

# écrit uniquement les entrées de moshterm ; les vôtres restent intactesmoshterm-hook install

Agents avec hooks gérés : Claude Code, Codex, OpenCode, Cursor, Grok Build, Kimi Code, Hermes, Pi et OMP. moshterm-hook uninstall supprime uniquement ce que install a écrit.

Association

Il n’y a rien à copier. À la première connexion SSH, le téléphone demande son jeton au Companion dans cette même session, puis communique avec lui via la connexion SSH. Pour ajouter un ordinateur par code QR au lieu de saisir son adresse, lancez moshterm-hook pair --qr et scannez-le depuis l’app.

Où il vit

  • Il s’exécute sous votre utilisateur et n’écoute que sur 127.0.0.1. Sur une machine partagée entre plusieurs comptes, le téléphone vérifie qu’il s’adresse bien à votre Companion, et non à celui d’un autre utilisateur, avant d’envoyer quoi que ce soit.
  • Son état est enregistré dans ~/.moshterm/, lisible uniquement par vous.
  • C’est un binaire statique unique, compilé pour macOS et Linux sur ARM et x86.

Mosh et tmux sur l’hôte

Pour les sessions itinérantes, l’ordinateur a besoin de mosh-server ; pour les sessions qui survivent à une déconnexion, d’un multiplexeur. Eternal Terminal est facultatif.

# macOSbrew install mosh tmux
# Debian, Ubuntu, WSLsudo apt install mosh tmux

En cas de souci

moshterm-hook doctor affiche ce que voit le Companion en cours d’exécution : son adresse, les outils détectés, l’état des hooks de chaque agent et s’il est associé. La commande fonctionne en SSH, vous pouvez donc la lancer depuis votre téléphone.

Toujours bloqué ? La page Assistance (en anglais) indique l’adresse où nous écrire.