Moon CLI agit en votre nom avec une session propre au terminal, que vous pouvez voir et révoquer à tout moment. La connexion se fait par le navigateur, ou par un code sur une machine sans navigateur.
Se connecter avec le navigateurLien vers la section Se connecter avec le navigateur
- Placez-vous dans votre projet, puis lancez
moon login. - Le navigateur s’ouvre sur la page « Connecter Moon CLI. » de Moon AI. Connectez-vous à votre compte si besoin. Si rien ne s’ouvre, ouvrez le lien affiché dans le terminal.
- Vérifiez le compte indiqué sous « Connecté en tant que », puis cliquez sur « Autoriser ». « Refuser » annule la demande.
- La page affiche « Moon CLI est connecté ». Dans le terminal, Moon CLI confirme la connexion et l’agent démarre dans le dossier courant.
cd mon-projet
moon login- Pour vous connecter sans lancer l’agent :
moon.login --no-launch - Pour ne pas ouvrir de navigateur sur cette machine :
moonaffiche l’adresse de connexion ; ouvrez-la là où votre compte Moon AI est connecté, dans les 5 minutes.login --no-open - Le terminal attend votre réponse 5 minutes. Passé ce délai, la page affiche « Moon CLI ne répond plus » : relancez
moon login. - Avec Safari, si le terminal ne reçoit rien, utilisez le lien « Mon terminal est ouvert mais rien ne se passe (Safari). Transmettre le code manuellement ».
- À la première utilisation,
moonsans session lance cette même connexion.
Si aucun de vos workspaces n’inclut Moon CLI, la page l’indique (« Moon CLI est inclus à partir du forfait Étoile. Aucun de vos workspaces ne l’a pour l’instant. ») et propose « Voir les forfaits ». Elle signale aussi un paiement en échec ou un abonnement terminé.
À chaque nouvelle connexion, Moon AI vous envoie l’e-mail « Nouvelle connexion à Moon CLI », avec le nom de l’appareil, l’heure et une adresse approximative.
Se connecter sans navigateurLien vers la section Se connecter sans navigateur
Sur un serveur, dans une session SSH ou un conteneur, utilisez un code d’appareil :
moon login --deviceMoon CLI choisit ce mode de lui-même dans une session SSH, ou sous Linux sans affichage graphique (hors WSL). moon force le navigateur.
- Le terminal affiche une adresse (
https://) et un code de la formechat.realmoon.ai/ api/ v1/ auths/ cli/ device ABCD-EF23. - Sur n’importe quel appareil, ouvrez l’adresse, connectez-vous à Moon AI, saisissez le code et cliquez sur « Autoriser ».
- La page « Autoriser cet appareil ? » affiche le nom de l’appareil (déclaré par la machine, non vérifié), son adresse IP approximative, l’heure de la demande et le code. S’il s’agit bien de votre machine, cliquez sur « Autoriser cet appareil », sinon sur « Refuser ».
- Le terminal confirme la connexion. Lancez ensuite
moondans votre projet.
Le code reste valable 10 minutes.
Coller un jetonLien vers la section Coller un jeton
moon login --token <jeton>Sans valeur après --token, Moon CLI vous demande de coller le jeton. Il le vérifie auprès de Moon AI avant de l’enregistrer. Un jeton de session du site web est refusé avec le message « Ce jeton n’est pas un jeton Moon CLI. ».
La clé d’API de votre compte (« Réglages » › « Compte » › « Clés API ») sert aussi à Moon CLI, dans la limite de votre forfait. Préférez la connexion par le navigateur : la session y est renouvelée seule et apparaît dans vos sessions Moon CLI.
Pour une exécution sans terminal (intégration continue), voir Tâche sans interface.
Où est rangé le jetonLien vers la section Où est rangé le jeton
- Le jeton est rangé dans le trousseau du système : Gestionnaire d’identification sous Windows, Trousseau sous macOS, libsecret sous Linux. Le fichier
auth.jsondu dossier d’état ne garde alors que l’adresse, l’e-mail et les dates. - Sans trousseau (serveur Linux sans session graphique, WSL, conteneur), le jeton est dans
auth.json, lisible par votre seul compte. moon doctorindique où se trouve votre jeton.- L’agent ne voit jamais le jeton : un composant local de Moon CLI l’ajoute à chaque requête vers Moon AI.
- Le jeton n’est envoyé qu’à
https://. Une session enregistrée pour une autre adresse est ignorée.chat.realmoon.ai
Durée de la sessionLien vers la section Durée de la session
| Étape | Ce qui se passe |
|---|---|
| Connexion | Un jeton valable 30 jours est créé. |
| Moins de 7 jours avant l’échéance | Au lancement suivant, Moon CLI le renouvelle sans rien vous demander : nouveau jeton, l’ancien est révoqué. |
| 90 jours après la connexion par le navigateur ou par code | Moon CLI vous demande de vous reconnecter par le navigateur. |
moon whoami affiche l’échéance du jeton et le nombre de jours avant la reconnexion obligatoire. Plusieurs moon ouverts en même temps partagent le même renouvellement.
Voir l’état de la connexionLien vers la section Voir l’état de la connexion
moon whoamiConnecté · vous@exemple.fr · jeton eyJh…k3Qw · valable jusqu’au 05/12/2026
Workspace · Studio · Étoile · ✦ accès Moon CLI actif
Reconnexion par le navigateur dans 84 jours.Le jeton n’est jamais affiché en entier. Si Moon AI refuse la session (expirée ou révoquée), moon whoami vous dit de lancer moon login.
Voir et révoquer les sessionsLien vers la section Voir et révoquer les sessions
Chaque connexion crée une session Moon CLI, nommée d’après l’appareil (par exemple PC-ALICE ).
Depuis le terminal :
moon sessions
moon sessions revoke 3f9a1cmoon liste vos sessions avec leur identifiant, l’appareil et la date ; la session du terminal courant est marquée « celle-ci ». moon accepte le début de l’identifiant s’il ne désigne qu’une session.
Depuis l’application :
- Ouvrez « Réglages » › « Sécurité » (chat.realmoon.ai/settings/security).
- Dans « Sessions Moon CLI », cliquez sur « Révoquer » en face de la session, puis confirmez « Révoquer cette session Moon CLI ? ».
La section n’apparaît que si vous avez au moins une session Moon CLI.
Ces gestes ferment aussi vos sessions Moon CLI :
- « Déconnecter les autres appareils », dans « Réglages » › « Sécurité » : tous les autres navigateurs, applications et sessions Moon CLI.
- « Se déconnecter de tous les appareils » (« Tout déconnecter ») : chaque appareil, celui-ci compris.
- Le changement de votre mot de passe.
Dans une organisation gérée, un administrateur peut aussi terminer les sessions Moon CLI d’un membre liées à l’organisation. Voir Sécurité du compte.
Se déconnecterLien vers la section Se déconnecter
moon logoutMoon CLI révoque la session auprès de Moon AI, puis efface le jeton de votre machine. Si Moon AI est injoignable à ce moment, le jeton local est quand même effacé : révoquez alors la session depuis « Réglages » › « Sécurité ».
Si ça ne marche pasLien vers la section Si ça ne marche pas
- Le navigateur ne s’ouvre pas, ou vous êtes en SSH, dans WSL ou sur un serveur : voir La connexion ne marche pas.
- « Moon CLI requiert un abonnement Étoile ou supérieur » : voir Forfait.
- Session expirée ou mauvais compte : voir Jeton expiré ou révoqué et Le mauvais compte.