Configuration

Moon CLI lit deux familles de fichiers : ses propres réglages (moon.json), écrits par les commandes moon blur et moon guard, et la configuration de l’agent (opencode.json, tui.json et des dossiers de skills, de commandes et d’instructions). Chacune existe en version personnelle, valable pour tous vos projets, et la configuration de l’agent existe aussi au niveau d’un projet.

Emplacements#Lien vers la section Emplacements

La configuration de l’agent accepte aussi les noms opencode.jsonc (avec commentaires) et config.json dans le même dossier. Si vous définissez XDG_CONFIG_HOME, le dossier ~/.config est remplacé par sa valeur.

Dans un projet, l’agent lit les fichiers suivants, entre la racine du dépôt Git et le dossier ouvert :

Réglages de Moon CLI (moon.json)#Lien vers la section Réglages de Moon CLI (moon.json)

{
  "blur": {
    "mode": "secrets",
    "projects": { "/home/alice/code/client": "redact" },
    "allow": ["<empreinte SHA-256 d’une valeur>"]
  },
  "guard": { "enabled": true },
  "updates": { "auto": true }
}

Un dépôt ne peut pas modifier ce fichier, et les outils de l’agent n’y ont pas accès. Un fichier illisible est ignoré : tous les réglages reviennent alors à leur valeur par défaut.

Configuration de l’agent (opencode.json)#Lien vers la section Configuration de l’agent (opencode.json)

Le même format sert pour le fichier personnel et pour celui d’un projet. Exemple de fichier de projet :

{
  "model": "moonai/anthropic/claude-haiku-4.5",
  "instructions": ["guides/conventions.md"],
  "permission": {
    "bash": {
      "*": "ask",
      "npm test": "allow"
    }
  },
  "mcp": {
    "context7": { "type": "remote", "url": "https://mcp.context7.com/mcp", "enabled": true }
  }
}

Une valeur peut reprendre une variable d’environnement avec {env:NOM}, ou le contenu d’un fichier avec {file:chemin} (chemin relatif au fichier de configuration, ou commençant par ~/). Utilisez-les pour ne pas écrire de secret en clair dans un fichier versionné.

Moon CLI ne laisse passer aucun autre fournisseur de modèles que Moon AI : une clé provider ou enabled_providers qui en ajouterait un est ignorée, et le partage de session reste désactivé.

Ordre de priorité#Lien vers la section Ordre de priorité

Configuration de l’agent#Lien vers la section Configuration de l’agent

Les sources sont fusionnées dans cet ordre ; une clé définie plus bas remplace la même clé définie plus haut.

1. Votre configuration personnelle (~/.config/moon/opencode.json).
2. Les réglages de session posés par Moon CLI à chaque lancement : fournisseur Moon AI et ses modèles, modèle Auto, petit modèle pour les tâches de fond, compaction automatique, permissions par défaut.
3. La configuration du projet, si vous l’avez approuvée : les fichiers opencode.json de la racine du dépôt jusqu’au dossier ouvert, puis les dossiers .opencode/.
4. La configuration gérée par l’administrateur du poste (voir plus bas).
5. Les clés verrouillées par Moon CLI : fournisseur unique Moon AI, partage désactivé, pas de mise à jour de l’agent par lui-même.

Les listes instructions s’additionnent d’une source à l’autre. Conséquence de cet ordre : dans votre configuration personnelle, les clés model, small_model, compaction.auto, compaction.prune et les règles edit, bash, webfetch, websearch sont remplacées par celles de Moon CLI. Pour les changer, utilisez la configuration d’un projet.

Réglages de Moon CLI#Lien vers la section Réglages de Moon CLI

Modèle par défaut#Lien vers la section Modèle par défaut

Au lancement, l’agent choisit son modèle dans cet ordre :

1. l’option -m moonai/<identifiant> (ou --model) de moon ou de moon run ;
2. la clé model de la configuration du projet approuvée ;
3. Auto, le modèle par défaut de Moon CLI.

Le modèle choisi dans l’agent avec /models vaut pour la session en cours ; au lancement suivant, Moon CLI repart sur la règle ci-dessus. moon models liste les identifiants disponibles, déjà préfixés par moonai/.

moon models
moon -m moonai/anthropic/claude-haiku-4.5

Le choix du modèle et les niveaux de coût sont détaillés dans Workspaces et modèles.

Permissions#Lien vers la section Permissions

Par défaut, l’agent demande votre accord avant :

Les outils de fichiers de l’agent n’ont jamais accès au dossier d’état de Moon CLI (votre session) ni à ~/.config/moon.

Trois façons de réduire les demandes :

• Le mode de la session : modifications acceptées ou approbation automatique, avec MajTab, /modifications ou /auto. Voir Modes de permission.
• « Toujours autoriser » sur une demande, quand elle le propose.
• Des règles dans la configuration du projet, sous la clé permission.

Une règle vaut allow (sans demande), ask (demande) ou deny (refus). Pour bash, une règle peut viser un motif de commande, où * remplace n’importe quelle suite de caractères ; quand plusieurs motifs correspondent, la dernière règle écrite l’emporte.

{
  "permission": {
    "bash": {
      "*": "ask",
      "npm test": "allow",
      "git status": "allow",
      "rm *": "deny"
    },
    "webfetch": "deny",
    "context7_*": "allow"
  }
}

Moon Blur#Lien vers la section Moon Blur

Le mode se règle avec moon blur (enregistré dans moon.json), pour un terminal avec MOON_BLUR_MODE, et pendant une session avec /blur.

moon blur redact          # tous vos projets
moon blur strict --here   # ce dossier seulement

Modes, détection et valeurs autorisées : Moon Blur dans Moon CLI.

Moon Guard#Lien vers la section Moon Guard

Moon Guard est désactivé par défaut. moon guard on l’active pour les lancements suivants (clé guard.enabled), MOON_GUARD=on pour un seul lancement. Voir Moon Guard.

Serveurs MCP#Lien vers la section Serveurs MCP

/mcp écrit les serveurs dans votre configuration personnelle (~/.config/moon/opencode.json). Vous pouvez aussi les déclarer à la main, dans ce fichier ou dans celui d’un projet, sous la clé mcp :

Ajout, connexion et sécurité des serveurs : Serveurs MCP dans Moon CLI.

Skills#Lien vers la section Skills

Une skill est un dossier qui contient un fichier SKILL.md : un nom et une description en en-tête, puis les consignes, et éventuellement des scripts. L’agent la charge quand la tâche s’y prête.

Dans l’agent, /skills liste les skills disponibles ; chacune s’appelle aussi directement avec /<nom>.

Fichiers d’instructions#Lien vers la section Fichiers d’instructions

Les fichiers d’instructions accompagnent chaque appel au modèle. L’agent lit :

1. une seule instruction personnelle : ~/.config/moon/AGENTS.md, sinon ~/.claude/CLAUDE.md ;
2. dans le projet approuvé, les fichiers AGENTS.md de la racine du dépôt jusqu’au dossier ouvert. S’il n’y en a aucun, les CLAUDE.md, sinon les CONTEXT.md ;
3. les fichiers listés par la clé instructions ;
4. en cours de session, l’AGENTS.md d’un sous-dossier dont l’agent lit un fichier.

Chaque fichier est coupé au-delà de 40 Ko (le début est gardé), et l’ensemble est limité à 100 Ko. Au lancement, Moon CLI signale tout fichier de plus de 40 Ko avec une estimation des jetons envoyés à chaque appel. /init crée ou met à jour l’AGENTS.md du projet.

Commandes personnalisées#Lien vers la section Commandes personnalisées

Un fichier Markdown dans ~/.config/moon/commands/ (pour vous) ou .opencode/commands/ (pour le projet) devient une commande / de l’agent, du nom du fichier.

---
description: Lance les tests d’un module et explique les échecs
---
Lance les tests du module $ARGUMENTS, puis résume chaque échec et propose une correction.

/test-module paiement envoie le texte au modèle en remplaçant $ARGUMENTS par paiement ; $1, $2 désignent les arguments un par un. L’en-tête accepte aussi agent (agent qui exécute la commande), model et subtask (true : exécutée par un sous-agent).

Interface de l’agent (tui.json)#Lien vers la section Interface de l’agent (tui.json)

{
  "keybinds": {
    "leader": "ctrl+x",
    "session_new": "<leader>n"
  },
  "mouse": true,
  "diff_style": "auto"
}

Le thème se choisit avec /themes. La liste des raccourcis par défaut est dans Raccourcis clavier.

Configuration gérée par l’administrateur#Lien vers la section Configuration gérée par l’administrateur

Sur un poste d’entreprise, l’administrateur peut imposer une configuration de l’agent, appliquée après celle de la personne et du projet :

Le dossier et le fichier doivent appartenir à l’administration du poste (root sans écriture pour le groupe ni les autres sous Linux et macOS, Administrateurs ou SYSTEM sous Windows) ; sinon ils sont ignorés.

Variables d’environnement#Lien vers la section Variables d’environnement

Moon CLI#Lien vers la section Moon CLI

Installation#Lien vers la section Installation

Détail : Options d’installation.

Réseau#Lien vers la section Réseau

Agent#Lien vers la section Agent

L’agent reçoit votre environnement, sauf les variables MOON_* et OTEL_*. Parmi ses propres variables, seules celles-ci lui sont transmises :

Les autres variables de votre environnement, comme GITHUB_TOKEN, restent visibles par l’agent et par les commandes qu’il lance.

Voir aussi#Lien vers la section Voir aussi

• Référence des commandes
• Utiliser l’agent
• Emplacements des fichiers d’installation