Aller au contenu principal
Documentation

Moon CLI.

Moon CLI, l'agent de code de Moon AI dans votre terminal : installation, commandes, Moon Blur, Moon Guard et notes de version.

Moon CLI v0.1.5

L'agent de code de Moon AI, dans votre terminal.

Introduction

Moon CLI est l'agent de code de Moon AI en ligne de commande. Il lit et modifie les fichiers de votre projet, exécute des commandes et se connecte à votre compte Moon AI : mêmes modèles, mêmes quotas et mêmes crédits que sur chat.realmoon.ai.

Deux protections tournent en permanence sur votre machine : Moon Blur masque vos secrets et données personnelles avant chaque envoi au modèle, et Moon Guard inspecte chaque commande shell avant son exécution. Le workspace actif doit avoir un abonnement Étoile ou supérieur.

$ moon

  ◗  Moon CLI
     l'agent de code de Moon AI
     ~/projets/mon-app
     Mon workspace · Étoile · Auto · choix intelligent · Moon Blur: redact
     Limite mensuelle ███░░░░░░░ 27 %

Installation

Le script d'installation télécharge deux binaires autonomes (moon, le lanceur, et moon-agent, l'agent), vérifie leur empreinte SHA-256 puis les ajoute au PATH. Il n'y a aucune dépendance à installer.

Windows · PowerShell 
PS> irm https://realmoon.ai/install.ps1 | iex
macOS & Linux 
$ curl -fsSL https://realmoon.ai/install.sh | sh

Ouvrez ensuite un nouveau terminal pour que le PATH soit pris en compte, puis lancez moon login.

Emplacements

  • Windows : binaires dans %LOCALAPPDATA%\Moon, données dans %USERPROFILE%\.local\share\moon.
  • macOS / Linux : binaires dans ~/.local/bin, données dans ~/.local/share/moon.
  • La variable MOON_INSTALL_DIR permet de choisir un autre dossier d'installation avant de lancer le script.

Les binaires sortent progressivement par plateforme : Windows x64 est disponible (ARM64 via émulation), macOS et Linux arrivent. Si votre plateforme n'est pas encore servie, le script d'installation vous l'indique clairement.

Premiers pas

  1. 1

    Installer Moon CLI

    Exécutez le script correspondant à votre système, puis ouvrez un nouveau terminal.

  2. 2

    Se connecter

    moon login ouvre la page d'autorisation Moon AI dans votre navigateur. Une fois validée, la connexion revient au terminal et l'agent démarre.

  3. 3

    Ouvrir un projet

    Placez-vous dans le dossier de votre projet (cd mon-projet).

  4. 4

    Lancer l'agent

    moon démarre l'agent dans le dossier courant. Décrivez votre tâche.

moon login
cd mon-projet
moon

Sur une machine sans navigateur (SSH, serveur), utilisez moon login --device : le terminal affiche un code à saisir depuis n'importe quel appareil connecté à votre compte.

Commandes

Référence des commandes du binaire moon en version 0.1.5. moon --help affiche cette liste dans le terminal.

Commande Description
moon Lance l'agent dans le dossier courant. À la première utilisation, la connexion démarre automatiquement ; si la session a expiré, la reconnexion est automatique.
moon run "<tâche>" Exécution non interactive, pour les scripts et l'intégration continue.
moon login Connexion à votre compte Moon AI : ouvre la page d'autorisation dans le navigateur, puis revient au terminal.
moon login --device (SSH, machine sans navigateur) · moon login --token <jeton>
moon logout Déconnexion. La session est aussi révoquée côté serveur.
moon whoami Compte connecté, expiration du jeton, workspace actif avec son plan et son éligibilité Moon CLI.
moon workspace Liste vos workspaces : nom, plan, éligibilité Moon CLI.
moon workspace use <numéro|nom|id>
moon sessions Liste les sessions Moon CLI actives sur votre compte.
moon sessions revoke <id> (préfixe accepté s'il est unique)
moon blur Affiche le mode d'anonymisation Moon Blur actif. Le mode se règle avec la variable d'environnement MOON_BLUR_MODE.
moon update Met à jour Moon CLI : compare la version installée à la version publiée, puis télécharge les nouveaux binaires et vérifie leur empreinte SHA-256. Ne télécharge rien si vous êtes déjà à jour.
moon update --force (retélécharge même à jour)
moon --version Affiche la version installée.
moon --help

Tout autre argument est transmis tel quel à l'agent : moon "corrige le test qui échoue" équivaut à moon run "corrige le test qui échoue".

Dans l'agent

Une fois moon lancé, tapez / pour afficher les commandes de l'agent. Les alias entre parenthèses sont acceptés, et Ctrl+P ouvre la palette de commandes.

/workspace /ws

Changer de workspace Moon AI sans quitter l'agent.

/usage /quota · /limites

Consommation de votre limite : jour, semaine, mois.

/models /mo

Choisir le modèle. Les prix sont affichés, « Auto » est le choix par défaut.

/agents

Changer d'agent (build, plan).

/variants

Variantes du modèle actif (effort de raisonnement), quand il en propose.

/mcps

Activer ou désactiver les serveurs MCP configurés.

/sessions /resume · /continue

Reprendre une conversation précédente.

/new /clear

Démarrer une nouvelle session.

/themes

Changer le thème de l'interface.

/status

État de l'agent et de la connexion.

/help

Aide : commandes et raccourcis clavier.

/exit /quit · /q

Quitter l'agent.

Modèle Auto. Le modèle « Auto · choix intelligent » est sélectionné par défaut. À chaque requête, il route la demande vers le modèle le moins cher capable de la traiter : modèle maison Moon pour les demandes courtes, modèle plus puissant quand la conversation grossit ou contient du code. Pour fixer un modèle précis, utilisez /models.

Moon Blur

Moon Blur analyse chaque message avant son envoi au modèle et masque ce qui ne doit pas quitter votre machine : clés et jetons d'API (AWS, GitHub, GitLab, Stripe, Google, Slack, OpenAI, Anthropic, npm, etc.), clés privées PEM, chaînes de connexion, affectations de secrets dans les fichiers .env, JWT, ainsi que les données personnelles (emails, IBAN, cartes bancaires, numéros de téléphone, NIR, SIRET, TVA).

Les valeurs détectées sont remplacées par des placeholders, puis restaurées dans la réponse : le modèle ne voit jamais les valeurs réelles, et vous ne voyez jamais les placeholders. La table de correspondance reste en mémoire locale et est purgée à la fin de la session.

Modes

Mode Comportement
off Analyse désactivée. Le texte part tel quel.
detect Détecte et signale les secrets et les données personnelles, sans modifier le texte envoyé.
redact défaut Remplace secrets et données personnelles par des placeholders avant l'envoi, puis restaure les valeurs réelles dans la réponse.
strict Comme redact, et bloque la requête entière si un secret est détecté.

Réglage

Le mode se définit avec la variable d'environnement MOON_BLUR_MODE avant de lancer moon. La commande moon blur affiche le mode actif.

# bash / zsh
export MOON_BLUR_MODE=strict

# PowerShell
$env:MOON_BLUR_MODE = "strict"

moon blur   # vérifie le mode actif

Moon Guard

Moon Guard inspecte chaque commande shell que l'agent veut exécuter, avant son exécution. Il est toujours actif quand l'agent est lancé via moon et fonctionne en deux niveaux.

Bloqué

La commande est refusée, l'agent ne peut pas l'exécuter.

  • Suppression récursive d'une cible critique : racine, dossier système, dossier personnel, ou cible opaque (substitution de commande, remontée hors du projet).
  • Écriture directe sur un disque (redirection ou dd vers /dev/sd*, /dev/nvme*) et formatage (mkfs).
  • Suppression de masse via find -delete ou find -exec rm.
  • Exécution de code téléchargé (curl | sh, eval sur un script distant, pipe vers un interpréteur).
  • Arrêt ou redémarrage de la machine, fork bomb.

Signalé

La commande est risquée mais courante : elle est signalée et vous gardez la main pour confirmer.

  • rm récursif forcé sur une cible ordinaire.
  • git push --force et git reset --hard.
  • chmod 777 sur un chemin système.
  • Effacement de l'historique du shell.

Confidentialité

Au-delà de Moon Blur et Moon Guard, Moon CLI applique les règles suivantes.

Jeton local

moon login enregistre un jeton de session dans un fichier protégé de votre dossier utilisateur, lisible par votre compte uniquement. L'agent ne le voit jamais : un proxy local l'injecte au moment de l'envoi.

Sessions révocables

Le jeton a une durée de vie limitée. Révoquez une session à tout moment avec moon sessions revoke, ou depuis Réglages puis Sécurité sur chat.realmoon.ai. moon logout révoque la session côté serveur.

Compte et quotas

Moon CLI consomme les quotas et crédits de votre compte Moon AI, comme l'application. Le workspace actif doit avoir un abonnement Étoile ou supérieur ; moon workspace liste vos workspaces avec leur éligibilité.

Verrouillage Moon AI

L'agent ne communique qu'avec Moon AI : les fournisseurs tiers sont désactivés et le partage de session vers des services externes est coupé.

Une question ?

L'équipe répond aux questions techniques par email. L'application reste disponible à tout moment.

contact@stellarrstudio.com Ouvrir l'application