Companion

Companion reflète votre canevas MadoHub sur l'application iOS via votre Wi-Fi local. Éloignez-vous de votre bureau et gardez un œil sur vos agents depuis votre téléphone ; envoyez une frappe rapide ou lancez un flow sans revenir au clavier.

C'est un miroir LAN, pas un relais cloud. Rien de ce qui concerne votre canevas, vos agents ou la sortie de votre terminal ne transite par un serveur MadoHub. Le Mac exécute un petit serveur sur votre réseau local et votre téléphone s'y connecte directement, en restant synchronisé tant que les deux partagent le même Wi-Fi.

Ce que vous pouvez faire

• Consulter votre canevas depuis votre téléphone — chaque cadre, tile, état d'agent, ligne d'activité et une queue récente de la sortie du terminal, en lecture seule.
• Ouvrir un tile pour lire le détail complet de son terminal — le téléphone affiche les mêmes états de tile que le bureau (inactif, en cours, en attente, arrêté, terminé, échoué, quitté).
• Envoyer des frappes à un tile — texte libre, plus escape, ctrl-c et enter comme touches spéciales, délivrées comme si vous les aviez saisies localement.
• Créer un terminal ou un cadre depuis le téléphone — lancez un nouveau terminal au centre du viewport du bureau, ou ouvrez un cadre d'espace de travail par chemin.
• Lancer un flow à distance — instanciez un Flow depuis le téléphone avec un prompt de tâche, et le bureau le déclenche.
• Réinitialiser le jeton de jumelage — invalidez immédiatement tous les appareils jumelés depuis les Paramètres si un téléphone est perdu ou pour repartir de zéro.

Comment l'utiliser

1. Ouvrez Paramètres → Général sur le Mac et activez Companion.
2. Le panneau des paramètres affiche l'IP locale et le port de votre Mac (par exemple 192.168.1.23:9280), un jeton de jumelage et un lien madohub://companion?… que vous pouvez copier sur le téléphone.
3. Ouvrez le lien sur votre téléphone (ou saisissez l'adresse et le jeton manuellement dans l'application iOS).
4. Le téléphone se jumelle et commence à refléter le canevas. Les Paramètres indiquent combien d'appareils sont actuellement connectés.
5. Depuis le téléphone, touchez un tile pour lire son détail, envoyez une entrée à un tile, ou utilisez le menu pour créer un terminal, ouvrir un cadre ou lancer un flow.

Pour tout déjumeler, cliquez sur reset token dans les Paramètres. Chaque appareil jumelé est immédiatement invalidé ; si le serveur tourne, il redémarre sous le nouveau jeton.

Cas d'usage courants

• « Surveiller un agent long à exécuter depuis le canapé. » — ouvrez le téléphone, regardez l'état du tile et la sortie récente, envoyez ctrl-c s'il déraille.
• « Lancer un flow de peer review sans retourner au bureau. » — depuis le téléphone, lancez le flow Peer review avec un prompt de tâche.
• « Approuver une demande de permission depuis l'autre bout de la pièce. » — touchez le tile, envoyez y ou enter pour débloquer l'agent.

Conseils et bonnes pratiques

• Les deux appareils doivent être sur le même Wi-Fi. Companion ne fonctionne pas sur internet ni entre sous-réseaux.
• Le miroir du canevas est en lecture seule — vous pouvez consulter les tiles et envoyer des entrées, mais pas déplacer les tiles ni recâbler les connexions depuis le téléphone.
• Réinitialisez le jeton si un téléphone jumelé est perdu ou si vous changez de réseau. Le nouveau jeton invalide immédiatement tous les jumelages précédents.
• Le serveur essaie d'abord le port 9280 et monte jusqu'à 9299 s'il est pris ; le port exact peut donc différer d'une machine à l'autre — copiez le lien depuis les Paramètres plutôt que de deviner.

Sécurité et confidentialité

• LAN uniquement, pas de relais cloud. Votre canevas, vos agents et la sortie du terminal restent sur votre réseau local ; rien ne transite par un serveur MadoHub.
• Le jumelage utilise un jeton + défi-réponse, pas un jeton bearer sur chaque requête. Le jeton lui-même ne traverse jamais le réseau ; seule une réponse salée à un défi frais par connexion le fait, donc une réponse capturée ne peut être rejouée contre une connexion ultérieure.
• Personne ne peut écrire sans le jeton. Un observateur passif sur le même Wi-Fi peut lire le trafic reflété (il n'y a pas encore de TLS), mais il ne peut pas ouvrir sa propre session authentifiée ni injecter d'entrées sans le jeton.
• Le serveur se borne face à un LAN hostile — au plus 64 connexions simultanées, et un client authentifié qui se tait pendant 60 secondes est déconnecté afin de ne pas occuper indéfiniment un slot de connexion.

Fonctionnalités associées

• Flows — lancez un flow à distance depuis le téléphone.
• Paramètres — où activer Companion et réinitialiser le jeton.
• Collaboration en équipe — pour surveiller les membres de l'équipe plutôt que votre propre canevas.

Limitations

• Companion nécessite que les deux appareils partagent le même Wi-Fi local. L'usage hors LAN (via internet) n'est pas encore pris en charge.
• Il n'y a pas de TLS sur la connexion. Un observateur passif sur le même LAN peut lire le trafic reflété ; les attaques actives de type man-in-the-middle ne sont pas encore traitées.
• Le miroir du canevas est en lecture seule — vous ne pouvez pas déplacer les tiles ni recâbler les connexions depuis le téléphone.
• Companion nécessite actuellement un hôte Mac. Pas encore de prise en charge d'hôte Windows.