# Référence des commandes

> Toutes les sous-commandes du binaire moon avec leurs options et un exemple, les commandes de l’interface de l’agent tapées avec / et les raccourcis clavier.

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’ensemble

| Commande | Rôle |
| --- | --- |
| `moon [dossier]` | Lancer l’agent dans le dossier courant ou dans le dossier indiqué. |
| `moon run "<tâche>"`, `moon "<tâche>"` | Exécuter une tâche sans interface. |
| `moon rc [dossier]` (`moon remote-control`) | Rendre une session de cet ordinateur pilotable depuis la page Code de Moon AI. Voir [Contrôle à distance](https://realmoon.ai/documentation/moon-cli/controle-a-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 workspace` (`moon workspaces`) | Lister vos workspaces et choisir celui de Moon CLI. |
| `moon sessions` | 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 rollback` | Revenir à la version précédente. |
| `moon uninstall` | Désinstaller Moon CLI. |
| `moon licenses` (`moon licences`) | Afficher les licences. |
| `moon --version` (`-v`) | Afficher la version. |
| `moon --help` (`-h`, `moon help`) | Afficher l’aide du lanceur. |
| `moon <commande> --help` (`moon help <commande>`) | Afficher l’aide d’une commande, sans rien faire d’autre. |

Réglages et variables d’environnement : [Configuration](https://realmoon.ai/documentation/moon-cli/configuration/).

## 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](https://realmoon.ai/documentation/moon-cli/utiliser/#modes). |
| `-m`, `--model moonai/<identifiant>` | Modèle de la session. `moonai/auto` désigne Auto. |
| `-c`, `--continue` | Reprend la dernière session. |
| `-s`, `--session <id>` | Reprend la session indiquée. |
| `--fork` | Avec `-c` ou `-s` : reprend dans une copie de la session. |
| `--prompt "<message>"` | Envoie ce message dès l’ouverture. |
| `--agent <nom>` | Agent de départ (`build` ou `plan`). |
| `--print-logs` | Écrit le journal de l’agent dans le terminal (sortie d’erreur). |
| `--log-level <niveau>` | Niveau du journal : `DEBUG`, `INFO`, `WARN` ou `ERROR`. |

```bash title="Terminal"
moon
moon ../autre-projet
moon -c
moon -m moonai/anthropic/claude-haiku-4.5 --prompt "explique l’architecture du dossier src"
```

## moon run

Exécute une tâche sans ouvrir l’interface, affiche la réponse puis se termine. `moon "<tâche>"` 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 <dossier>` | Travaille dans ce dossier. La question de confiance et le mode de Moon Blur portent sur lui. |
| `-m`, `--model moonai/<identifiant>` | Modèle à utiliser. |
| `--agent <nom>` | 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 <fichier>` | Joint un ou plusieurs fichiers au message. |
| `-c`, `--continue` | Continue la dernière session. |
| `-s`, `--session <id>` | Continue la session indiquée. |
| `--fork` | Avec `-c` ou `-s` : continue dans une copie de la session. |
| `--command <nom>` | Exécute une commande `/` de l’agent ; le message sert d’arguments. |
| `--title "<titre>"` | Titre de la session. |
| `--format json` | Écrit les événements bruts en JSON, un par ligne. |
| `--thinking` | Affiche la réflexion du modèle. |
| `--attach <adresse>` | Utilise un agent déjà lancé par `moon serve` (avec `-p`, `--password` et `-u`, `--username`). |

```bash title="Terminal"
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](https://realmoon.ai/documentation/moon-cli/utiliser/#run).

## 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 <jeton>` | 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. |

```bash title="Terminal"
moon login
moon login --device
```

Voir [Connexion](https://realmoon.ai/documentation/moon-cli/connexion/).

## 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 »).

```bash title="Terminal"
moon logout
```

## 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.

```bash title="Terminal"
moon whoami
```

## moon workspace

Liste vos workspaces avec leur forfait : `✦` marque ceux qui incluent Moon CLI, « utilisé par Moon CLI » celui de la session. `moon workspace use` 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.

```bash title="Terminal"
moon workspace
moon workspace use 2
moon workspace use Studio
```

Voir [Workspaces et modèles](https://realmoon.ai/documentation/moon-cli/workspaces-modeles/).

## moon sessions

Liste vos sessions Moon CLI (identifiant, appareil, date de connexion) et marque celle du terminal courant (« celle-ci »). `moon sessions revoke <id>` en ferme une ; le début de l’identifiant suffit s’il ne désigne qu’une session.

```bash title="Terminal"
moon sessions
moon sessions revoke 3f9a1c
```

## 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 blur <mode>` | Mode par défaut : `off`, `secrets`, `redact`, `strict` ou `detect`. |
| `moon blur <mode> --here` | Mode du dossier courant seulement (`--project` est accepté). |
| `moon blur reset` | Retire le mode par défaut ; avec `--here`, celui du dossier. |
| `moon blur allow <valeur>` | Ne plus masquer cette valeur. Seule son empreinte est enregistrée. |
| `moon blur allow` | Nombre de valeurs autorisées. |
| `moon blur allow --clear` | Vide la liste des valeurs autorisées. |
| `moon blur audit <fichier>` | Liste ce qui serait masqué dans un fichier (50 premiers éléments), sans rien envoyer. |

```bash title="Terminal"
moon blur redact --here
moon blur audit config/dev.env
```

L’ancienne forme `moon blur mode <mode>` reste acceptée. Voir [Moon Blur](https://realmoon.ai/documentation/moon-cli/moon-blur/).

## moon guard

Active (`on`) ou désactive (`off`) Moon Guard pour les lancements suivants de `moon`. Sans argument, affiche l’état et son origine.

```bash title="Terminal"
moon guard on
moon guard
```

Voir [Moon Guard](https://realmoon.ai/documentation/moon-cli/moon-guard/).

## 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.

```bash title="Terminal"
moon doctor
moon doctor --json > diagnostic.json
```

Voir [Dépannage](https://realmoon.ai/documentation/moon-cli/depannage/#doctor).

## moon update

Cherche la dernière version publiée et l’installe. Elle sert au prochain lancement de `moon`.

| Option | Effet |
| --- | --- |
| `--to <version>` | Installe cette version, plus ancienne comprise. |
| `--channel <canal>` | Canal de mise à jour ; `latest` par défaut. |
| `--force` | Réinstalle même si la version est à jour. |

```bash title="Terminal"
moon update
moon update --to 0.2.2
```

Voir [Mises à jour](https://realmoon.ai/documentation/moon-cli/mises-a-jour/).

## 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.

```bash title="Terminal"
moon rollback
moon rollback --yes
```

## 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. |

```bash title="Terminal"
moon uninstall
moon uninstall --purge --yes
```

Voir [Désinstaller](https://realmoon.ai/documentation/moon-cli/mises-a-jour/#desinstaller).

## moon licenses

Affiche les mentions de licence de Moon CLI, de l’agent (basé sur OpenCode, licence MIT) et des composants inclus.

```bash title="Terminal"
moon licenses | less
```

## moon --version

Affiche `Moon CLI 0.4.0`, puis la version d’OpenCode sur laquelle l’agent est basé.

```bash title="Terminal"
moon --version
```

## 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 <commande> --help` affiche leurs options.

| Commande | Rôle |
| --- | --- |
| `moon serve` | Démarre le serveur local de l’agent, sans interface (`--port`, `--hostname`). |
| `moon attach <adresse>` | 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/<identifiant>`). |
| `moon agent create`, `moon agent list` | Crée un agent personnalisé, liste les agents disponibles. |
| `moon mcp list` | Liste les serveurs MCP et leur état. |
| `moon mcp add` | Ajoute un serveur MCP : `--url <adresse>` pour un serveur distant (`--header CLÉ=VALEUR`), ou la commande après `--` pour un serveur local (`--env CLÉ=VALEUR`). Sans nom, l’ajout est guidé. |
| `moon mcp auth [nom]`, `moon mcp logout [nom]` | Connecte un serveur MCP par OAuth, ou efface ses identifiants. |
| `moon mcp debug <nom>` | Diagnostique la connexion OAuth d’un serveur MCP. |
| `moon session list`, `moon session delete <id>` | Liste les sessions de l’agent (`-n`, `--format json`), en supprime une. |
| `moon export [id]` | Exporte une session en JSON (`--sanitize` masque les données sensibles de la transcription). |
| `moon import <fichier>` | Importe une session depuis un fichier JSON. |
| `moon stats` | Statistiques de vos sessions : jetons, outils, modèles (`--days`, `--models`, `--tools`, `--project`). |
| `moon pr <numéro>` | Récupère la branche d’une pull request GitHub, puis lance l’agent. |
| `moon debug config`, `moon debug paths` | Affiche la configuration finale de l’agent, ou ses dossiers. |

```bash title="Terminal"
moon models
moon mcp add context7 --url https://mcp.context7.com/mcp
moon session list -n 5
```

- `moon serve` démarre toujours avec un mot de passe : si vous n’en fixez pas avec `OPENCODE_SERVER_PASSWORD`, Moon CLI en tire un au hasard et l’affiche avec l’utilisateur (« moon », sauf si vous posez `OPENCODE_SERVER_USERNAME`).
- `moon serve`, `moon acp` et `moon pr` ne chargent jamais la configuration du dépôt.

Commandes refusées :

| Commande | Réponse |
| --- | --- |
| `moon providers login` | 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’interface

Dans l’agent, tapez `/` pour voir les commandes et filtrer la liste en tapant la suite du nom. `Ctrl` `P` ouvre la palette, qui contient aussi les actions sans commande `/`. Les noms entre parenthèses sont des alias.

### 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](https://realmoon.ai/documentation/moon-cli/controle-a-distance/#rc). |
| `/mcp` | Ajoute, connecte, déconnecte ou supprime des serveurs MCP. |

### 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. |
| `/modifications` (`/modifs`) | Active ou coupe le mode « modifications acceptées ». |
| `/auto` (`/bypass`) | Active ou coupe l’approbation automatique ; demande confirmation la première fois. |

### 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 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` (`/toggle-thinking`) | Déplie ou replie la réflexion du modèle. |
| `/timestamps` (`/toggle-timestamps`) | Affiche ou masque l’heure des messages. |
| `/themes` | Change le thème de l’interface. |

### 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è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 fichiers

La liste contient aussi :

- vos [commandes personnalisées](https://realmoon.ai/documentation/moon-cli/configuration/#commandes) ;
- vos skills, appelées par leur nom (`/<nom>`) ;
- les prompts proposés par vos serveurs MCP.

## Raccourcis clavier

| Touche | Effet |
| --- | --- |
| `Entrée` | Envoyer le message. |
| `Maj` `Entrée` ou `Ctrl` `J` | Aller à la ligne dans la saisie. |
| `Échap` deux fois | Interrompre la réponse en cours. |
| `Maj` `Tab` | Passer au mode de permission suivant. |
| `Tab` | Passer à l’agent suivant (`build`, `plan`). |
| `Ctrl` `P` | Palette de commandes. |
| `Ctrl` `T` | Variante suivante du modèle. |
| `F2` | Modèle récent suivant. |
| `Ctrl` `C` | 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. |

`Ctrl` `X` 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](https://realmoon.ai/documentation/moon-cli/configuration/#tui).

---

Documentation Moon AI › Moon CLI › Commandes. Page : https://realmoon.ai/documentation/moon-cli/commandes/. Modifiée le 8 novembre 2026.

© 2026 Stellarr Studio SAS. Tous droits réservés. Moon AI, Moon Blur et Stellarr Studio sont des marques déposées à l’INPI.