# Mises à jour et désinstallation

> Mises à jour automatiques et signées de Moon CLI, mise à jour immédiate ou vers une version précise, retour à la version précédente et désinstallation complète.

Moon CLI se tient à jour tout seul. Chaque mise à jour est signée et vérifiée avant d’être activée, et la version précédente reste sur votre machine pour un retour arrière.

## Mises à jour automatiques

Pendant une session de l’agent, au plus une fois par jour, Moon CLI cherche une nouvelle version en arrière-plan et l’installe. Votre session continue sur la version en cours. À la fin de la session, Moon CLI indique la version installée : elle sert au prochain lancement de `moon`.

- Après une erreur (réseau, serveur), Moon CLI réessaie une heure plus tard.
- La mise à jour automatique ne tourne pas sans terminal interactif, en intégration continue (variable `CI` définie), avec une clé `MOON_API_KEY`, ni depuis une copie de `moon` posée hors de l’installation (depuis la 0.3.1 ; `MOON_INSTALL_DIR` permet de gérer une telle copie).

Pour la couper :

```bash title="Variable d’environnement"
export MOON_DISABLE_AUTOUPDATE=1
```

```json title="moon.json"
{
  "updates": { "auto": false }
}
```

Le fichier `moon.json` est dans `~/.config/moon/` (Windows : `%USERPROFILE%\.config\moon\`).

## Mettre à jour maintenant

```bash title="Terminal"
moon update
```

| Option | Effet |
| --- | --- |
| (aucune) | Installe la dernière version du canal si elle est plus récente. |
| `--to <version>` | Installe cette version précise, y compris une version plus ancienne. |
| `--force` | Réinstalle même si la version est déjà à jour. |
| `--channel <canal>` | Choisit le canal de mise à jour ; `latest` par défaut. |

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

`moon upgrade` fait la même chose que `moon update`.

| Message | Signification |
| --- | --- |
| « Moon CLI 0.4.0 est à jour. » | Rien à installer. |
| « Moon CLI … est installé. Il sera utilisé au prochain lancement de « moon ». » | La nouvelle version est prête. |
| « Une mise à jour est déjà en cours dans une autre session. » | Une autre session `moon` met déjà à jour : rien à faire. |
| « La version … n’est pas encore publiée pour votre plateforme (…). » | Votre machine garde la version actuelle. |

## Ce qui est vérifié

1. Moon CLI télécharge le manifeste de la version et vérifie sa signature avec une clé publique intégrée au binaire. Une signature invalide arrête tout.
2. Il vérifie l’empreinte SHA-256 de l’archive, puis celle du binaire décompressé, toutes deux inscrites dans le manifeste signé.
3. Il lance le nouveau binaire pour vérifier qu’il démarre sur votre machine. Sinon, l’installation est annulée.
4. Il active la nouvelle version d’un seul coup, sans état intermédiaire.

Rien n’est exécuté depuis le serveur. Un canal ne revient jamais en arrière, et une mise à jour sans `--to` n’installe jamais une version plus ancienne que la vôtre.

En cas de refus, `moon update` affiche « Mise à jour impossible : » suivi de la raison, puis propose de réessayer plus tard ou de réinstaller.

## Revenir à la version précédente

Moon CLI garde la version active et la précédente.

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

Moon CLI demande « Revenir à la version précédente de Moon CLI ? [o/N] ». La version précédente redevient active au prochain lancement. Dans un script, ajoutez `--yes` : `moon rollback --yes`. Sans version précédente sur la machine, Moon CLI l’indique. Pour une version plus ancienne encore, utilisez `moon update --to <version>`.

## Désinstaller

```bash title="Terminal"
moon uninstall
```

1. Moon CLI demande confirmation (« Désinstaller … ? [o/N] »).
2. Il révoque votre session auprès de Moon AI et efface le jeton de votre machine, comme `moon logout`.
3. Il retire le binaire, les versions installées et l’ajout au `PATH` (bloc `# >>> moon cli >>>` des fichiers de votre shell, fichier `moon.fish` de fish, ou `PATH` utilisateur sous Windows).

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 : dossiers `moon` de `~/.local/share`, `~/.config`, `~/.cache` et `~/.local/state`. |
| `--yes` (ou `-y`) | Pas de confirmation. Obligatoire sans terminal interactif. |

Sous Windows, ouvrez ensuite un nouveau terminal pour que le `PATH` soit à jour. Si vous aviez installé Moon CLI dans un autre dossier avec `MOON_INSTALL_DIR`, supprimez ce dossier vous-même s’il ne s’appelle pas `Moon`.

### Désinstaller à la main

Si la commande ne fonctionne plus, révoquez d’abord la session dans « Réglages » › « Sécurité » › « Sessions Moon CLI » ([chat.realmoon.ai/settings/security](https://chat.realmoon.ai/settings/security)), puis supprimez :

| Élément | Windows | macOS, Linux, WSL |
| --- | --- | --- |
| Binaire et versions | le dossier `%LOCALAPPDATA%\Moon` | `~/.local/bin/moon` et `~/.local/share/moon/versions/` |
| Ajout au `PATH` | entrée du `PATH` utilisateur | bloc `# >>> moon cli >>>` de `.zshrc`, `.bashrc`, `.bash_profile` ou `.profile`, ou le fichier `~/.config/fish/conf.d/moon.fish` |
| Session, état et historique (facultatif) | `%USERPROFILE%\.local\share\moon` | `~/.local/share/moon` |
| Réglages (facultatif) | `%USERPROFILE%\.config\moon` | `~/.config/moon` |

Sans trousseau du système, le jeton est dans le dossier d’état ; avec un trousseau, l’entrée `moon-cli` reste dans le trousseau tant que la session n’a pas été effacée par `moon logout`.

## Depuis une version 0.1.x

Sur une version 0.1.x, `moon update` relance l’installeur en ligne, qui installe la version actuelle. Vous pouvez aussi relancer directement la commande d’installation : voir [Installation](https://realmoon.ai/documentation/moon-cli/installation/). L’installeur retire `moon-agent`, le second binaire des versions 0.1.x.

## Notes de version

`moon --version` affiche la version installée. Ce qui change à chaque version est dans les [notes de version](https://realmoon.ai/documentation/moon-cli/versions/).

## Si ça ne marche pas

- « Mise à jour impossible : » suivi d’une empreinte ou d’une signature : voir [L’empreinte ou la signature ne correspond pas](https://realmoon.ai/documentation/moon-cli/depannage/#empreinte).
- Les autres messages de `moon update` et `moon rollback` : voir [Mises à jour et version](https://realmoon.ai/documentation/moon-cli/depannage/#mises-a-jour).
- Réinstaller ou repartir de zéro : voir [Désinstaller ou réinstaller proprement](https://realmoon.ai/documentation/moon-cli/depannage/#reinstaller).

## Voir aussi

- [Installation](https://realmoon.ai/documentation/moon-cli/installation/)
- [Référence des commandes](https://realmoon.ai/documentation/moon-cli/commandes/#update)
- [Dépannage](https://realmoon.ai/documentation/moon-cli/depannage/)

---

Documentation Moon AI › Moon CLI › Mises à jour. Page : https://realmoon.ai/documentation/moon-cli/mises-a-jour/. Modifiée le 7 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.