Une fois connecté, Moon CLI s’utilise depuis le dossier de votre projet. Vous décrivez la tâche, l’agent lit le code, propose des modifications et lance des commandes, avec votre accord.
Lancer l’agent dans un projetLien vers la section Lancer l’agent dans un projet
cd mon-projet
moonVous pouvez aussi désigner un autre dossier : moon .
Au lancement, le terminal affiche un résumé : votre workspace et son forfait, le modèle choisi, le mode de Moon Blur et votre utilisation (session de 5 h, semaine, mois). La barre d’utilisation passe à l’ambre à partir de 75 % et au rouge à partir de 90 %. L’interface de l’agent s’ouvre ensuite.
L’agent travaille dans ce dossier, à l’intérieur du dépôt Git qui le contient. Il ne charge ni configuration ni instructions situées au-dessus de la racine du dépôt.
À la fin de la session, Moon CLI indique combien de valeurs Moon Blur a masquées.
Dossier personnel et racine d’un disqueLien vers la section Dossier personnel et racine d’un disque
Lancé dans votre dossier personnel ou à la racine d’un disque, l’agent parcourrait tous les fichiers et le démarrage pourrait prendre plusieurs minutes. Moon CLI le signale et demande « Continuer quand même ? [o/N] ». Placez-vous plutôt dans le dossier d’un projet.
Pour ne plus voir cet avertissement (par exemple dans un script), définissez MOON_ALLOW_BROAD_DIR=.
Configuration d’un dépôtLien vers la section Configuration d’un dépôt
Un dépôt peut contenir une configuration d’agent : elle peut lancer des plugins, ajouter des serveurs MCP ou des skills, ou autoriser des commandes sans confirmation. Un dépôt cloné piégé pourrait ainsi prendre la main. Moon CLI ne la charge qu’avec votre accord.
Fichiers concernés, dans chaque dossier entre le dossier ouvert et la racine du dépôt :
opencode.json,opencode.jsonc,tui.json,tui.jsonc;- les dossiers
.opencode/,.claude/etskills/ .agents/.skills/
Si l’un d’eux existe, Moon CLI les liste et demande « Faire confiance à cette configuration ? [o/N] ».
| Réponse | Effet |
|---|---|
o (oui) | La configuration est chargée. Votre accord est retenu pour ce dépôt tant que ces fichiers ne changent pas. |
N (non, par défaut) | Rien n’est chargé du dépôt pour cette session : ni configuration, ni plugins, ni skills, ni AGENTS.md ou CLAUDE.md. |
- La question revient si le contenu de ces fichiers change.
- Au-delà de 5 000 fichiers ou de 200 Mo, la configuration ne peut pas être vérifiée en entier : la question revient à chaque lancement.
- Sans terminal interactif, la configuration du dépôt est ignorée, sauf si
MOON_TRUST_PROJECT=est défini.1 - Un dépôt sans aucun de ces fichiers ne pose pas de question : ses fichiers d’instructions sont lus normalement.
- Pour oublier tous vos accords, supprimez le fichier
trusted-projects.jsondu dossier d’état (voir Emplacements des fichiers).
Fichiers d’instructionsLien vers la section Fichiers d’instructions
L’agent lit les fichiers AGENTS.md de votre projet (à défaut CLAUDE.md, puis CONTEXT.md) et votre fichier d’instructions personnel (~/, à défaut ~/). Ils accompagnent chaque appel au modèle et comptent donc dans votre limite d’utilisation. Au-delà de 40 Ko, Moon CLI affiche un avertissement au lancement avec une estimation des jetons envoyés à chaque appel : gardez ces fichiers courts.
/init crée ou met à jour l’AGENTS.md du projet. Ordre de lecture et limites : Fichiers d’instructions.
L’interfaceLien vers la section L’interface
- En-tête : votre workspace et la jauge de votre limite d’utilisation.
- Barre d’état : dossier, branche Git, mode de Moon Blur et remplissage du contexte.
- Panneau de saisie : votre message et le mode de permission actif.
- Actions : chaque action de l’agent est résumée sur une ligne.
- Autorisations et questions : les choix sont numérotés, répondez avec les touches 1, 2, 3.
- Moon, la mascotte de Moon AI, suit la session : elle réfléchit, agit, attend votre accord, se réjouit à la fin d’un tour ou s’inquiète d’une erreur.
/themes change les couleurs de toute l’interface.
Écrire à l’agentLien vers la section Écrire à l’agent
| Saisie | Effet |
|---|---|
| Texte puis Entrée | Envoie la demande. MajEntrée va à la ligne. |
@ | Cite un fichier du projet, un agent ou une ressource d’un serveur MCP. |
/ | Ouvre la liste des commandes. Voir Commandes de l’interface. |
! en début de saisie | Passe en mode shell : la ligne est lancée comme commande dans le projet. |
| Échap deux fois | Interrompt la réponse en cours. |
Agents build et planLien vers la section Agents build et plan
Deux agents principaux sont disponibles. Tab ou /agents passe de l’un à l’autre.
| Agent | Usage |
|---|---|
build | Agent par défaut, avec tous les outils : il lit, modifie et lance des commandes. |
plan | Analyse et propose sans modifier vos fichiers. Utile pour explorer un dépôt avant d’autoriser des modifications. |
Pour explorer le code, l’agent peut confier une partie du travail à un sous-agent, qui utilise un modèle économique.
Modes de permissionLien vers la section Modes de permission
Par défaut, l’agent demande votre accord avant de modifier un fichier, de lancer une commande, de lire une page web ou de faire une recherche, et avant d’utiliser l’outil d’un serveur MCP. Certaines demandes proposent aussi de toujours autoriser (par exemple pour un site).
Trois modes changent ce comportement :
| Mode | Modifications de fichiers | Commandes, web et outils MCP | Indicateur |
|---|---|---|---|
| Normal | Demandées | Demandées | aucun |
| Modifications acceptées | Sans demande | Demandées | « ⏵⏵ modifications acceptées » |
| Approbation automatique | Sans demande | Sans demande | « ⏵⏵ approbation automatique » |
- MajTab passe de normal à modifications acceptées, puis à l’approbation automatique si vous l’avez déjà acceptée dans cette session, puis revient à normal.
/active ou coupe le mode modifications acceptées.modifications /autoactive ou coupe l’approbation automatique. La première fois dans une session, Moon CLI demande « Activer l’approbation automatique ? ».moon --autodémarre directement en approbation automatique, sans confirmation.
Les demandes déjà affichées au moment du changement de mode attendent toujours votre réponse.
Pour autoriser durablement certaines commandes dans un projet, utilisez des règles de permission : voir Permissions.
Commandes de l’agentLien vers la section Commandes de l’agent
Tapez / dans l’agent pour afficher les commandes, ou CtrlP pour la palette. Les plus utilisées :
| Commande | Rôle |
|---|---|
/models | Choisir le modèle, avec son niveau de coût. |
/workspace | Changer le workspace de la session. |
/usage | Voir votre utilisation : session de 5 h, semaine, mois. |
/blur | Changer le mode de Moon Blur pour la session. |
/mcp | Ajouter et connecter des serveurs MCP. |
/compact | Résumer la conversation pour libérer du contexte. |
/undo | Annuler le dernier message et ses modifications de fichiers. |
/new | Démarrer une nouvelle session. |
Liste complète avec les alias : Commandes de l’interface.
Tâche sans interface (moon run)Lien vers la section Tâche sans interface (moon run)
Pour une tâche ponctuelle, sans ouvrir l’interface :
moon run "explique le rôle du dossier src/api"
moon run --auto "ajoute un test pour la fonction parse_date"moon "…" fait la même chose : un premier argument qui n’est ni une option, ni une commande, ni un dossier existant est traité comme une tâche. Moon CLI affiche la réponse puis se termine.
Personne n’est là pour répondre aux demandes d’autorisation : sans --auto, toute modification de fichier, commande ou accès au web est refusé, et le terminal affiche « permission demandée : … ; refus automatique ». La lecture et la recherche dans le code restent possibles. Avec --auto, chaque demande est acceptée.
| Option | Rôle |
|---|---|
--auto | Accepter les demandes d’autorisation. |
--dir | Travailler dans un autre dossier. La question de confiance et le mode de Moon Blur portent sur ce dossier. |
-m, --model | Choisir le modèle, par exemple moonai/auto. |
-c, --continue | Continuer la dernière session. |
Ce que vous envoyez sur l’entrée standard est ajouté à la demande : git . Toutes les options : moon run.
En intégration continueLien vers la section En intégration continue
Sans terminal interactif, Moon CLI ne lance pas de connexion par le navigateur. Utilisez une clé d’API de workspace (moai_org_…) dans la variable MOON_API_KEY : rien n’est écrit sur le disque, et le workspace et le forfait sont ceux de la clé.
export MOON_API_KEY="moai_org_..."
export MOON_TRUST_PROJECT=1 # seulement si la configuration du dépôt est sûre
export MOON_GUARD=on # bloque les commandes destructrices
moon run --auto "lance les tests et résume les échecs"--autopermet à l’agent de lancer des commandes : réservez-le à un environnement jetable.- La clé est retirée de l’environnement de l’agent et des commandes qu’il lance.
- Les mises à jour automatiques ne tournent pas en intégration continue.
- Créer une clé de workspace : voir Clés de workspace.