Moon CLI s’installe en une commande, sans droits administrateur. L’installeur choisit le binaire adapté à votre machine, vérifie son empreinte, teste son démarrage, puis ajoute la commande moon à votre PATH.
Installer sous WindowsLien vers la section Installer sous Windows
Dans PowerShell (5.1 ou 7) :
irm https://realmoon.ai/install.ps1 | iexDepuis l’invite de commandes (CMD) :
curl -fsSL https://realmoon.ai/install.cmd -o install.cmd && install.cmd && del install.cmdOuvrez ensuite un nouveau terminal : le PATH mis à jour n’est lu qu’à l’ouverture.
- Sur un PC ARM64, l’installeur prend la version ARM64 si elle est publiée, sinon la version x64, qui tourne en émulation. Il l’indique pendant l’installation.
- Sur un processeur x64 sans instructions AVX2, il choisit seul la variante adaptée.
- Dans Git Bash ou MSYS, le script
install.shrefuse de s’installer : utilisez PowerShell.
Installer sous macOS, Linux et WSLLien vers la section Installer sous macOS, Linux et WSL
Dans un terminal :
curl -fsSL https://realmoon.ai/install.sh | shLe script a besoin de curl, de gzip et de sha256sum ou shasum. Il détecte l’architecture (x64 ou ARM), la bibliothèque C (glibc ou musl) et la présence des instructions AVX2. Sur un Mac Apple Silicon, il installe la version native même si le terminal tourne sous Rosetta.
- WSL : lancez la commande dans votre distribution Linux.
- Alpine et autres systèmes musl : Moon CLI a besoin des paquets
libstdc++etlibgcc. S’ils manquent, l’installeur affiche la commande à lancer :
apk add libstdc++ libgcc- macOS : installez avec le script plutôt qu’en téléchargeant le binaire avec un navigateur, que macOS peut bloquer.
Ouvrez ensuite un nouveau terminal, ou rechargez le profil de votre shell, pour que moon soit trouvé.
Plateformes serviesLien vers la section Plateformes servies
| Système | Variantes |
|---|---|
| Windows 10 et 11 | x64, x64 sans AVX2, ARM64 (sinon x64 en émulation) |
| macOS | Apple Silicon, Intel |
| Linux (glibc) | x64, x64 sans AVX2, ARM64 |
| Linux (musl, par exemple Alpine) | x64, ARM64 |
Si la version demandée n’est pas publiée pour votre machine, l’installeur s’arrête sans rien modifier.
Ce que fait l’installeurLien vers la section Ce que fait l’installeur
- Il lit le numéro de la dernière version publiée, ou prend celle que vous avez indiquée.
- Il télécharge le binaire compressé de votre plateforme, en HTTPS seulement.
- Il vérifie l’empreinte SHA-256 du fichier téléchargé, puis celle du binaire décompressé, avec la liste publiée pour cette version.
- Il lance le binaire (
moon) pour vérifier qu’il démarre sur votre machine. En cas d’échec, rien n’est remplacé.--version - Il range le binaire dans un dossier propre à la version et active cette version.
- Il ajoute le dossier de
moonà votrePATH. - Il retire
moon-agent, le second binaire des versions 0.1.x, devenu inutile.
Ajout au PATH, selon votre shell :
| Shell | Fichier modifié |
|---|---|
| zsh | ~/.zshrc |
| bash | ~/.bashrc, ou ~/ sous macOS |
| fish | ~/ |
| autre | ~/.profile |
| Windows | variable Path de votre compte utilisateur |
Dans les fichiers de shell, l’ajout est encadré par les lignes # et # .
Options d’installationLien vers la section Options d’installation
| Réglage | macOS, Linux, WSL | Windows |
|---|---|---|
| Version précise | numéro de version en argument du script | variable MOON_VERSION |
Ne pas modifier le PATH | option --no-modify-path, ou variable MOON_NO_MODIFY_PATH= | variable MOON_NO_MODIFY_PATH= |
| Autre dossier | variable MOON_INSTALL_DIR : dossier du lien moon | variable MOON_INSTALL_DIR : dossier de moon.exe et des versions |
# Version précise
curl -fsSL https://realmoon.ai/install.sh | sh -s -- 0.4.0
# Sans toucher au PATH
curl -fsSL https://realmoon.ai/install.sh | sh -s -- --no-modify-path
# Commande moon dans ~/bin
curl -fsSL https://realmoon.ai/install.sh | MOON_INSTALL_DIR="$HOME/bin" sh# Version précise
$env:MOON_VERSION = '0.4.0'
irm https://realmoon.ai/install.ps1 | iex
# Sans toucher au PATH
$env:MOON_NO_MODIFY_PATH = '1'
irm https://realmoon.ai/install.ps1 | iex
# Autre dossier
$env:MOON_INSTALL_DIR = 'D:\Outils\Moon'
irm https://realmoon.ai/install.ps1 | iexSous macOS et Linux, une variable se place après le |, devant sh : c’est le script qui la lit, pas curl.
Emplacements des fichiersLien vers la section Emplacements des fichiers
| Élément | macOS, Linux, WSL | Windows |
|---|---|---|
Commande moon | ~/ (lien vers la version active) | %LOCALAPPDATA%\Moon\moon.exe |
| Versions installées (active et précédente) | ~/ | %LOCALAPPDATA%\Moon\versions\<version>\ |
Réglages de Moon CLI (moon.json) | ~/ | %USERPROFILE%\.config\moon\ |
| Configuration personnelle de l’agent | ~/ | %USERPROFILE%\.config\moon\ |
| Session et état du lanceur | ~/ | %USERPROFILE%\.local\share\moon\cli\ |
| Données de l’agent (historique des sessions) | ~/ | %USERPROFILE%\.local\share\moon\ |
| Journaux de l’agent | ~/ | %USERPROFILE%\.local\share\moon\log\ |
| Cache et état de l’agent | ~/, ~/ | %USERPROFILE%\.cache\moon\, %USERPROFILE%\.local\state\moon\ |
Les variables XDG_CONFIG_HOME, XDG_DATA_HOME, XDG_CACHE_HOME et XDG_STATE_HOME sont respectées si vous les définissez. Le jeton de connexion est rangé dans le trousseau du système quand il existe : voir Où est rangé le jeton. Les fichiers de configuration sont décrits dans Configuration.
Vérifier l’installationLien vers la section Vérifier l’installation
moon --version
moon doctormoon affiche Moon . moon doctor vérifie l’installation, le réseau et votre session, et dit quoi corriger : voir Dépannage.
Vérifier les empreintesLien vers la section Vérifier les empreintes
Pour refaire vous-même la vérification de l’installeur :
curl -fsSL https://realmoon.ai/dl/releases/0.4.0/SHA256SUMS
sha256sum ~/.local/share/moon/versions/0.4.0/moonirm https://realmoon.ai/dl/releases/0.4.0/SHA256SUMS
Get-FileHash "$env:LOCALAPPDATA\Moon\versions\0.4.0\moon.exe" -Algorithm SHA256L’empreinte du binaire doit être celle de la ligne moon-<version>-<plateforme> de la liste, par exemple moon-0.4.0-linux-x64 ou moon-0.4.0-windows-x64.exe. Sous macOS, utilisez shasum à la place de sha256sum.
Les mises à jour vérifient en plus un manifeste signé avec une clé publique intégrée au binaire. Une mise à jour dont la signature ou une empreinte ne correspond pas est refusée : voir Vérifications.
Mettre à jour ou désinstallerLien vers la section Mettre à jour ou désinstaller
Moon CLI se met à jour seul, au plus une fois par jour. Pour une mise à jour immédiate, un retour à la version précédente ou une désinstallation, voir Mises à jour et désinstallation.
Si ça ne marche pasLien vers la section Si ça ne marche pas
- « moon » n’est pas reconnu après l’installation : voir Ajouter Moon CLI au PATH, sous Windows ou macOS et Linux.
- L’installeur est bloqué (politique d’exécution de PowerShell, antivirus,
curlabsent, proxy) : voir L’installeur ne s’exécute pas. - « Empreinte » ou « signature » refusée : voir L’empreinte ou la signature ne correspond pas.
- WSL, macOS ou Linux : voir Plateformes.