Moon CLI se pilote depuis Code, sur chat.realmoon.ai, dans un navigateur ou un téléphone, de deux façons : moon rc lance une session dans un dossier de votre ordinateur, et /rc rend pilotable la conversation déjà ouverte dans le terminal. L’agent tourne toujours sur votre ordinateur ; la page envoie vos demandes et affiche ses réponses, ses autorisations et ses modifications. Code est ouvert aux forfaits qui incluent Moon CLI ; passez-y avec l’interrupteur en haut de la barre latérale.
Lancer une session avec moon rcLien vers la section Lancer une session avec moon rc
cd mon-projet
moon rc- Moon CLI se connecte à Moon AI et affiche l’adresse de la page, puis « En attente d’une page… (Ctrl+C pour arrêter) ».
- Ouvrez cette adresse, connecté au même compte Moon AI que Moon CLI. La machine apparaît aussi dans Code, dans la barre latérale.
- Le terminal affiche « Piloté depuis le web. » (ou « Piloté depuis le web par … »). Chaque autorisation demandée par l’agent s’affiche dans le terminal et dans la page. Répondez dans la page : « Autoriser une fois », « Toujours autoriser » ou « Refuser » pour une modification de fichier ou une commande ; « Autoriser une fois » ou « Refuser » pour une action d’un connecteur de Moon AI.
- CtrlC arrête la session.
Si Moon CLI n’est pas connecté, moon rc demande d’abord la connexion : voir Se connecter.
Depuis une conversation ouverte : /rcLien vers la section Depuis une conversation ouverte : /rc
Dans l’interface de Moon CLI (lancée par moon), tapez /rc : la conversation en cours devient pilotable depuis la page Code, sans quitter le terminal. Il faut Moon CLI 0.4.0 ou plus récent (moon update).
- Moon CLI dit d’abord ce que la page verra : « La page verra toute cette conversation, fichiers joints et sorties d’outils compris, ainsi que les autres sessions de ce dossier, qu’elle pourra renommer, archiver ou supprimer. Ce contenu passe par Moon AI sans Moon Blur. »
- Si Moon Blur n’est pas coupé dans ce terminal, Moon CLI demande votre accord avant d’activer, « Activer le contrôle à distance ? » : « Annuler » est choisi par défaut et Échap annule ; rien ne part tant que vous n’avez pas choisi « Activer ».
- L’adresse de la page et un QR code s’affichent, et la page s’ouvre dans votre navigateur ; sur un téléphone, scannez le QR code. Utilisez le même compte Moon AI que Moon CLI. Un bandeau « Contrôle à distance actif » reste visible dans le terminal tant que la page peut piloter la conversation.
- Les messages envoyés depuis la page sont marqués « depuis le web » dans le terminal. Une autorisation s’affiche des deux côtés : répondez au clavier ou sur la page, la première réponse compte. Répondue au clavier, elle quitte la page, qui garde la ligne « Répondu sur l’ordinateur ».
/rc stop, ou/rcune seconde fois, arrête le contrôle à distance ; les réponses lancées depuis la page s’arrêtent d’abord. Fermer Moon CLI l’arrête aussi.
Pendant /rc, Moon CLI repasse en mode Demander, et la page y reste : voir Dans la page.
Ce que voit la pageLien vers la section Ce que voit la page
Avec moon rc comme avec /rc :
- La page reçoit la conversation entière, y compris le contenu des fichiers joints et les sorties des outils et des commandes (avec
/rc, l’historique de la conversation est rejoué à l’ouverture), ainsi que les sessions de ce dossier, archivées comprises. - Ce contenu passe par le serveur de Moon AI sans Moon Blur : Moon Blur masque ce qui part vers le modèle, pas ce qui s’affiche dans la page. Si une conversation contient des données que vous ne voulez pas voir passer par Moon AI en clair, ne la rendez pas pilotable.
- La page ne reçoit pas l’écran du terminal, seulement les messages de l’agent. Le jeton de votre compte reste dans Moon CLI.
- La page ne voit que les sessions du dossier où Moon CLI travaille, jamais celles d’un autre dossier.
Dans la pageLien vers la section Dans la page
- Mode d’autorisation : avec
moon rc, Demander à chaque fois (par défaut), Accepter les modifications ou Autonome. Pendant/rc, la page reste en mode Demander à chaque fois : les autres choix sont grisés avec « Changez le mode d’autorisation dans le terminal. », et « Toujours autoriser » n’est pas proposé. Les fichiers qui s’exécutent tout seuls (crochets git,package.json, tâches de l’éditeur) et tout ce qui sort du dossier demandent toujours votre accord. - Modes : depuis la page, avec
moon rccomme avec/rc, seuls les modes Construire et Planifier se choisissent. Les autres modes, par exemple un agent que vous avez écrit, se changent dans le terminal. Demandés depuis la page, ils sont refusés : « Changez de mode dans le terminal. » - Connecteurs : les connecteurs de Moon AI (GitHub, Notion, Gmail…) se choisissent dans la page. Chaque écriture d’un connecteur demande votre accord, « Autoriser une fois » ou « Refuser », quel que soit votre réglage.
- Fichiers et commandes :
@joint un fichier du dossier ; les commandes de Moon CLI (état de la session, Moon Blur, Moon Guard, diagnostic, annuler et rétablir le dernier tour, compacter la conversation) sont disponibles dans la page ; les modèles qui en proposent ont leurs niveaux de réflexion.
Gérer les sessionsLien vers la section Gérer les sessions
Dans la barre latérale de Code, sur le web comme dans Moon Desktop, chaque session du dossier a un menu « … » : « Renommer », « Archiver » (ou « Désarchiver »), « Sélectionner plusieurs » et « Supprimer ». Ces actions demandent Moon CLI 0.4.0 ou plus récent sur l’ordinateur ; avec une version plus ancienne, elles sont grisées avec « Mettez Moon CLI à jour (0.4.0) ». Lancez moon update, puis relancez moon rc ou /rc.
- Renommer : le nom se modifie en place, 120 caractères au plus. Entrée le garde, Échap annule.
- Archiver : la session quitte la liste et rejoint « Archivées », repliée en bas de la liste avec le nombre de sessions archivées. « Désarchiver » la remet dans la liste. L’archivage est enregistré sur l’ordinateur : il vaut aussi dans le terminal et dans Moon Desktop.
- Sélectionner plusieurs : chaque ligne reçoit une case à cocher, et une barre propose « Tout sélectionner », « Archiver » (ou « Désarchiver »), « Supprimer » et « Annuler la sélection ». Échap quitte la sélection.
- Supprimer : une fenêtre demande toujours une confirmation, avec le nom de la session ou le nombre de sessions choisies : « La conversation et son historique seront supprimés de cet ordinateur. Les fichiers modifiés par Moon restent tels quels. » Confirmez avec « Supprimer la session » (ou « Supprimer les sessions »), ou choisissez « Annuler ». Une session supprimée ne se récupère pas.
- Pendant que Moon travaille : une session dont un tour est en cours ne peut pas être supprimée. La fenêtre le dit (« Moon travaille dans cette session. Arrêtez d’abord le tour, puis supprimez-la. ») et propose « Arrêter ». Si Moon CLI trouve un tour en cours au moment de supprimer, il refuse, et la page affiche « Arrêtez d’abord le tour de Moon. »
Seules les sessions du dossier où Moon CLI travaille sont concernées, et chaque demande est notée par Moon CLI. Si vous archivez ou supprimez la session ouverte, Code la ferme et ouvre une nouvelle session.
Si la page ne se branche pasLien vers la section Si la page ne se branche pas
« En attente d’une page… » ne change pasLien vers la section « En attente d’une page… » ne change pas
- Ouvrez bien l’adresse affichée par le terminal, ou la machine dans Code, avec le même compte que Moon CLI (
moon whoamile montre). Avec un autre compte, la page est refusée sans indiquer que la session existe. - « Page fermée : en attente d’une page… » : la page a été fermée ou rechargée ; rouvrez-la.
- Dans la page, « Machine déconnectée » : le terminal a perdu la connexion ; elle reprend d’elle-même dès son retour.
« Connexion perdue … nouvelle tentative dans N s »Lien vers la section « Connexion perdue … nouvelle tentative dans N s »
Moon CLI réessaie seul après 1, 2, 4, 8, 15 puis 30 secondes, et garde la session de l’agent pendant la coupure. Si le message revient sans fin, votre réseau bloque sans doute la connexion permanente (WebSocket) vers wss:// :
- derrière un proxy d’entreprise, définissez
HTTPS_PROXY(voir Réseau et proxy) et demandez au service informatique d’autoriser les connexions WebSocket verschat.realmoon.ai; - sinon, utilisez Moon CLI dans le terminal (
moon), sans la page.
Le workspace impose Moon BlurLien vers la section Le workspace impose Moon Blur
Dans un workspace où Moon Blur est obligatoire, le contrôle à distance n’est pas proposé : moon rc refuse de démarrer, et /rc aussi. Le contenu de la session (sorties des commandes, fichiers lus, modifications) passerait par le serveur de Moon AI sans être masqué pour s’afficher dans la page. Si le workspace se met à imposer Moon Blur pendant /rc, le contrôle à distance s’arrête. Utilisez Moon CLI dans le terminal (moon).
Si Moon AI ne dit pas tout de suite si votre workspace impose Moon Blur, Moon CLI réessaie deux fois (« Moon AI n’a pas encore dit si votre workspace impose Moon Blur : nouvelle tentative… »), puis s’arrête : « Le contrôle à distance ne démarre pas : Moon AI n’a pas dit si votre workspace impose Moon Blur. Réessayez dans un instant (« moon rc »), ou lancez « moon doctor ». » Relancez moon rc un peu plus tard ; si cela se répète, moon doctor vérifie la connexion à Moon AI.
/rc ne démarre pasLien vers la section /rc ne démarre pas
| Message | Que faire |
|---|---|
| « Le contrôle à distance n’est disponible que dans Moon CLI lancé par « moon » (0.4.0 ou plus récent). » | Ouvrez Moon CLI avec la commande moon, sur l’ordinateur où se trouve le dossier, après moon update si besoin. |
| « Le contrôle à distance demande le lanceur Moon CLI 0.4.0 ou plus récent (moon update). » | Lancez moon update, puis rouvrez Moon CLI. |
| « Contrôle à distance non activé. » | Vous avez choisi « Annuler » (ou Échap) : rien n’est parti. Tapez /rc à nouveau pour activer. |
| « Le contrôle à distance n’est pas actif. » | /rc stop n’a rien à arrêter. |
Les autres refus (workspace, forfait, Moon Blur imposé) sont les mêmes qu’avec moon rc : voir Codes de refus et Dépannage.
Codes de refusLien vers la section Codes de refus
| Code | Ce qu’il veut dire | Message du terminal | Que faire |
|---|---|---|---|
| 4401 | Session de Moon CLI absente, expirée ou révoquée. | « Moon AI refuse cette session (expirée ou révoquée). Lancez : moon login » | moon login, puis relancez moon rc. |
| 4403 | Refusé : Code fermé pour votre compte, forfait sans Moon CLI sur le workspace de la session, ou page d’une autre personne. | « Moon AI refuse le contrôle à distance : … » | Vérifiez le workspace (moon ) et votre forfait. moon rc ne réessaie pas. |
| 4429 | Trop de sessions, de connexions ou de messages : 5 sessions de contrôle à distance à la fois au plus par personne. | « Connexion perdue (…) : nouvelle tentative dans 30 s. » | Arrêtez une autre session moon rc (CtrlC, ou « Arrêter le contrôle à distance » dans Code) ; Moon CLI réessaie après 30 secondes. |
| 4409 | La session a été reprise ailleurs. | « Cette session de contrôle à distance a été reprise ailleurs. » | Relancez moon rc si besoin. |
| 4410 | La session a été arrêtée depuis la page. | « Contrôle à distance arrêté depuis le web. » | Rien : relancez moon rc pour une nouvelle session. |
Une coupure du réseau ou un redémarrage du serveur n’arrête pas la session : Moon CLI se reconnecte et la page la retrouve.