Le binaire moon réunit le lanceur (connexion, workspace, Moon Blur, mises à jour) et l’agent. Les commandes que le lanceur ne traite pas sont transmises à l’agent. moon --help affiche le résumé dans le terminal.
Vue d’ensembleLien vers la section Vue d’ensemble
| Commande | Rôle |
|---|---|
moon | Lancer l’agent dans le dossier courant ou dans le dossier indiqué. |
moon , moon | Exécuter une tâche sans interface. |
moon (moon ) | Rendre une session de cet ordinateur pilotable depuis la page Code de Moon AI. Voir Contrôle à distance. |
moon login | Se connecter à Moon AI. |
moon logout | Se déconnecter et révoquer la session. |
moon whoami | État de la connexion et du workspace. |
moon (moon ) | Lister vos workspaces et choisir celui de Moon CLI. |
moon | Lister et révoquer vos sessions Moon CLI. |
moon blur | Régler Moon Blur. |
moon guard | Activer ou désactiver Moon Guard. |
moon doctor | Diagnostiquer l’installation, le réseau et le compte. |
moon update (moon upgrade) | Mettre à jour Moon CLI. |
moon | Revenir à la version précédente. |
moon | Désinstaller Moon CLI. |
moon (moon ) | Afficher les licences. |
moon (-v) | Afficher la version. |
moon --help (-h, moon help) | Afficher l’aide du lanceur. |
moon (moon ) | Afficher l’aide d’une commande, sans rien faire d’autre. |
Réglages et variables d’environnement : Configuration.
moonLien vers la section moon
Lance l’agent dans le dossier courant, ou dans le dossier passé en premier argument. Sans session, la connexion démarre d’abord ; une session expirée ou révoquée déclenche une nouvelle connexion.
| Option | Effet |
|---|---|
--auto | Démarre en mode approbation automatique. Voir Modes de permission. |
-m, --model | Modèle de la session. moonai/auto désigne Auto. |
-c, --continue | Reprend la dernière session. |
-s, --session | Reprend la session indiquée. |
--fork | Avec -c ou -s : reprend dans une copie de la session. |
--prompt | Envoie ce message dès l’ouverture. |
--agent | Agent de départ (build ou plan). |
--print-logs | Écrit le journal de l’agent dans le terminal (sortie d’erreur). |
--log-level | Niveau du journal : DEBUG, INFO, WARN ou ERROR. |
moon
moon ../autre-projet
moon -c
moon -m moonai/anthropic/claude-haiku-4.5 --prompt "explique l’architecture du dossier src"moon runLien vers la section moon run
Exécute une tâche sans ouvrir l’interface, affiche la réponse puis se termine. moon fait la même chose : un premier argument qui n’est ni une option, ni une commande, ni un fichier ou dossier existant est traité comme une tâche.
| Option | Effet |
|---|---|
--dir | Travaille dans ce dossier. La question de confiance et le mode de Moon Blur portent sur lui. |
-m, --model | Modèle à utiliser. |
--agent | Agent à utiliser (build ou plan). |
--auto | Accepte toutes les demandes d’autorisation. Sans cette option, toute action qui demande votre accord est refusée. |
-f, --file | Joint un ou plusieurs fichiers au message. |
-c, --continue | Continue la dernière session. |
-s, --session | Continue la session indiquée. |
--fork | Avec -c ou -s : continue dans une copie de la session. |
--command | Exécute une commande / de l’agent ; le message sert d’arguments. |
--title | Titre de la session. |
--format | Écrit les événements bruts en JSON, un par ligne. |
--thinking | Affiche la réflexion du modèle. |
--attach | Utilise un agent déjà lancé par moon serve (avec -p, --password et -u, --username). |
moon run "explique le rôle du dossier src/api"
moon run --auto "corrige le test qui échoue"
git diff | moon run "résume ces modifications"
moon run --command review main- Sans
--auto, une modification de fichier, une commande ou un accès au web est refusé, avec le message « permission demandée : … ; refus automatique ». - Ce que vous envoyez sur l’entrée standard (
|) est ajouté au message. - Le code de sortie vaut 1 en cas d’erreur.
Intégration continue : Tâche sans interface.
moon loginLien vers la section moon login
Relie Moon CLI à votre compte Moon AI.
| Option | Effet |
|---|---|
| (aucune) | Connexion par le navigateur, puis lancement de l’agent dans le dossier courant. Par code dans une session SSH ou sous Linux sans affichage graphique. |
--device | Connexion par code, pour une machine sans navigateur. |
--browser | Force la connexion par le navigateur. |
--token | Enregistre un jeton Moon CLI collé ; sans valeur, le jeton est demandé. |
--no-launch | Ne lance pas l’agent après la connexion par le navigateur. |
--no-open | N’ouvre pas de navigateur : affiche l’adresse de connexion, à ouvrir là où votre compte Moon AI est connecté (5 minutes). |
--json | Pour une application : aucun navigateur ouvert, des lignes JSON (l’adresse à ouvrir, puis le résultat), jamais le jeton. |
moon login
moon login --deviceVoir Connexion.
moon logoutLien vers la section moon logout
Révoque la session auprès de Moon AI, puis efface le jeton de votre machine. La commande n’accepte aucun argument (« Usage : moon logout »).
moon logoutmoon whoamiLien vers la section moon whoami
Affiche le compte, le jeton masqué et son échéance, le workspace de la session avec son forfait, l’accès à Moon CLI et le nombre de jours avant la reconnexion obligatoire. Code de sortie 1 si vous n’êtes pas connecté ou si Moon AI refuse la session. Avec --json, le même état en JSON pour une application, sans le jeton.
moon whoamimoon workspaceLien vers la section moon workspace
Liste vos workspaces avec leur forfait : ✦ marque ceux qui incluent Moon CLI, « utilisé par Moon CLI » celui de la session. moon change le workspace de la session, désigné par son numéro dans la liste, son nom ou son identifiant (le début suffit s’il ne désigne qu’un workspace). Le workspace ouvert sur le web ne change pas.
moon workspace
moon workspace use 2
moon workspace use StudioVoir Workspaces et modèles.
moon sessionsLien vers la section moon sessions
Liste vos sessions Moon CLI (identifiant, appareil, date de connexion) et marque celle du terminal courant (« celle-ci »). moon en ferme une ; le début de l’identifiant suffit s’il ne désigne qu’une session.
moon sessions
moon sessions revoke 3f9a1cmoon blurLien vers la section moon blur
Règle Moon Blur, l’anonymisation faite sur votre machine.
| Forme | Effet |
|---|---|
moon blur | Mode actif, son origine et la liste des modes. |
moon | Mode par défaut : off, secrets, redact, strict ou detect. |
moon | Mode du dossier courant seulement (--project est accepté). |
moon | Retire le mode par défaut ; avec --here, celui du dossier. |
moon | Ne plus masquer cette valeur. Seule son empreinte est enregistrée. |
moon | Nombre de valeurs autorisées. |
moon | Vide la liste des valeurs autorisées. |
moon | Liste ce qui serait masqué dans un fichier (50 premiers éléments), sans rien envoyer. |
moon blur redact --here
moon blur audit config/dev.envL’ancienne forme moon reste acceptée. Voir Moon Blur.
moon guardLien vers la section moon guard
Active (on) ou désactive (off) Moon Guard pour les lancements suivants de moon. Sans argument, affiche l’état et son origine.
moon guard on
moon guardVoir Moon Guard.
moon doctorLien vers la section moon doctor
Vérifie l’installation, le réseau, la session, le workspace, les réglages, le dossier courant et la présence d’une mise à jour, et dit quoi corriger. --json donne le même diagnostic en JSON, sans votre jeton. Code de sortie 1 s’il reste un problème à corriger.
moon doctor
moon doctor --json > diagnostic.jsonVoir Dépannage.
moon updateLien vers la section moon update
Cherche la dernière version publiée et l’installe. Elle sert au prochain lancement de moon.
| Option | Effet |
|---|---|
--to | Installe cette version, plus ancienne comprise. |
--channel | Canal de mise à jour ; latest par défaut. |
--force | Réinstalle même si la version est à jour. |
moon update
moon update --to 0.2.2Voir Mises à jour.
moon rollbackLien vers la section moon rollback
Réactive la version installée avant la version active. Elle sert au prochain lancement. Moon CLI demande d’abord « Revenir à la version précédente de Moon CLI ? [o/N] » ; --yes (ou -y) confirme d’avance, pour un script.
moon rollback
moon rollback --yesmoon uninstallLien vers la section moon uninstall
Révoque la session et efface le jeton, puis retire Moon CLI : binaire, versions installées et ajout au PATH. Vos réglages et l’historique des sessions de l’agent sont gardés.
| Option | Effet |
|---|---|
--purge | Efface aussi vos réglages, votre configuration personnelle de l’agent, l’historique des sessions et les caches. |
--yes (-y) | Pas de confirmation. Obligatoire sans terminal interactif. |
moon uninstall
moon uninstall --purge --yesVoir Désinstaller.
moon licensesLien vers la section moon licenses
Affiche les mentions de licence de Moon CLI, de l’agent (basé sur OpenCode, licence MIT) et des composants inclus.
moon licenses | lessmoon --versionLien vers la section moon --version
Affiche Moon , puis la version d’OpenCode sur laquelle l’agent est basé.
moon --versionCommandes transmises à l’agentLien vers la section Commandes transmises à l’agent
Ces commandes passent d’abord par la connexion et le contrôle du workspace, comme moon, puis sont exécutées par l’agent. moon affiche leurs options.
| Commande | Rôle |
|---|---|
moon serve | Démarre le serveur local de l’agent, sans interface (--port, --hostname). |
moon | Ouvre l’interface sur un serveur lancé par moon serve. |
moon acp | Démarre l’agent pour un éditeur de code compatible avec le protocole ACP (Agent Client Protocol). |
moon models | Liste les identifiants des modèles utilisables (moonai/). |
moon , moon | Crée un agent personnalisé, liste les agents disponibles. |
moon | Liste les serveurs MCP et leur état. |
moon mcp add | Ajoute un serveur MCP : --url pour un serveur distant (--header ), ou la commande après -- pour un serveur local (--env ). Sans nom, l’ajout est guidé. |
moon , moon | Connecte un serveur MCP par OAuth, ou efface ses identifiants. |
moon | Diagnostique la connexion OAuth d’un serveur MCP. |
moon , moon | Liste les sessions de l’agent (-n, --format ), en supprime une. |
moon | Exporte une session en JSON (--sanitize masque les données sensibles de la transcription). |
moon | Importe une session depuis un fichier JSON. |
moon stats | Statistiques de vos sessions : jetons, outils, modèles (--days, --models, --tools, --project). |
moon | Récupère la branche d’une pull request GitHub, puis lance l’agent. |
moon , moon | Affiche la configuration finale de l’agent, ou ses dossiers. |
moon models
moon mcp add context7 --url https://mcp.context7.com/mcp
moon session list -n 5moon servedémarre toujours avec un mot de passe : si vous n’en fixez pas avecOPENCODE_SERVER_PASSWORD, Moon CLI en tire un au hasard et l’affiche avec l’utilisateur (« moon », sauf si vous posezOPENCODE_SERVER_USERNAME).moon serve,moon acpetmoon prne chargent jamais la configuration du dépôt.
Commandes refusées :
| Commande | Réponse |
|---|---|
moon | Refusée : Moon CLI passe uniquement par Moon AI. |
moon web, moon account, moon github | Refusées : non disponibles dans Moon CLI. |
Commandes de l’interfaceLien vers la section Commandes de l’interface
Dans l’agent, tapez / pour voir les commandes et filtrer la liste en tapant la suite du nom. CtrlP ouvre la palette, qui contient aussi les actions sans commande /. Les noms entre parenthèses sont des alias.
Moon AILien vers la section Moon AI
| Commande | Effet |
|---|---|
/workspace (/ws) | Change le workspace de la session, sans quitter l’agent. Le web n’est pas modifié. |
/usage (/quota, /limites) | Affiche votre utilisation : session de 5 h, semaine et mois. |
/blur | Change le mode de Moon Blur pour la session. |
/rc | Rend la conversation en cours pilotable depuis la page Code de Moon AI, après avoir dit ce que la page verra ; /rc stop, ou /rc une seconde fois, l’arrête. Voir Depuis une conversation ouverte. |
/mcp | Ajoute, connecte, déconnecte ou supprime des serveurs MCP. |
Modèle, agent et permissionsLien vers la section Modèle, agent et permissions
| Commande | Effet |
|---|---|
/models (/mo) | Choisit le modèle, avec son niveau de coût. |
/variants | Choisit une variante du modèle, quand il en propose. |
/agents | Choisit l’agent : build (accès complet) ou plan (analyse sans modification). |
/mcps | Active ou désactive les serveurs MCP configurés. |
/ (/modifs) | Active ou coupe le mode « modifications acceptées ». |
/auto (/bypass) | Active ou coupe l’approbation automatique ; demande confirmation la première fois. |
SessionLien vers la section Session
| Commande | Effet |
|---|---|
/new (/clear) | Démarre une nouvelle session. |
/sessions (/resume, /continue) | Reprend une session précédente. |
/rename | Renomme la session. |
/compact (/summarize) | Résume la conversation pour libérer du contexte. |
/undo | Annule votre dernier message et les modifications de fichiers qui l’ont suivi ; le message revient dans la saisie. |
/redo | Rétablit ce que /undo a annulé. |
/timeline | Va à un message de la session. |
/fork | Duplique la session à partir d’un message. |
/copy | Copie la transcription de la session dans le presse-papiers. |
/export | Enregistre la transcription en Markdown dans le dossier courant, après le choix du nom et du contenu (réflexion, détail des outils), puis l’ouvre dans votre éditeur. |
/move | Déplace la session vers un autre dossier de projet. |
Saisie et affichageLien vers la section Saisie et affichage
| Commande | Effet |
|---|---|
/editor | Rédige le message dans votre éditeur de texte (variable VISUAL ou EDITOR). |
/skills | Liste les skills disponibles et insère celle choisie. |
/diff | Ouvre le visualiseur des modifications Git. |
/thinking (/) | Déplie ou replie la réflexion du modèle. |
/timestamps (/) | Affiche ou masque l’heure des messages. |
/themes | Change le thème de l’interface. |
ProjetLien vers la section Projet
| Commande | Effet |
|---|---|
/init | Crée ou met à jour le fichier AGENTS.md du projet. Le texte tapé après la commande précise ce qu’il doit couvrir. |
/review | Relit des modifications et signale les problèmes : sans argument, les modifications non commitées ; sinon un commit, une branche à comparer, ou une pull request (numéro ou adresse, avec l’outil gh installé). |
SystèmeLien vers la section Système
| Commande | Effet |
|---|---|
/status | État des serveurs MCP, des serveurs de langage, des formateurs et des plugins chargés. |
/debug | Version, système, terminal, session et modèle, à copier pour une demande d’aide. |
/help | Aide : commandes et raccourcis. |
/exit (/quit, /q) | Quitte l’agent. |
Commandes ajoutées par vos fichiersLien vers la section Commandes ajoutées par vos fichiers
La liste contient aussi :
- vos commandes personnalisées ;
- vos skills, appelées par leur nom (
/<nom>) ; - les prompts proposés par vos serveurs MCP.
Raccourcis clavierLien vers la section Raccourcis clavier
| Touche | Effet |
|---|---|
| Entrée | Envoyer le message. |
| MajEntrée ou CtrlJ | Aller à la ligne dans la saisie. |
| Échap deux fois | Interrompre la réponse en cours. |
| MajTab | Passer au mode de permission suivant. |
| Tab | Passer à l’agent suivant (build, plan). |
| CtrlP | Palette de commandes. |
| CtrlT | Variante suivante du modèle. |
| F2 | Modèle récent suivant. |
| CtrlC | Effacer la saisie ; quitter si elle est vide. |
| ! en début de saisie | Mode shell : la ligne est lancée comme commande dans le projet. |
| @ | Citer un fichier, un agent ou une ressource MCP. |
CtrlX est le préfixe : appuyez sur ces touches, relâchez-les, puis tapez une lettre.
| Suite | Effet |
|---|---|
| N | Nouvelle session. |
| L | Liste des sessions. |
| M | Liste des modèles. |
| A | Liste des agents. |
| C | Compacter la session. |
| E | Rédiger dans l’éditeur externe. |
| U, R | Annuler ou rétablir le dernier message. |
| Y | Copier le message. |
| X | Exporter la session. |
| G | Chronologie de la session. |
| S | Statut. |
| T | Thèmes. |
| B | Afficher ou masquer le panneau latéral. |
Les raccourcis se changent dans tui.json : voir Interface de l’agent.