8. Comment il fonctionne à l'intérieur
8.5 La ligne de commande
Les commandes de l'exécutable d'Atollo pour préparer, vérifier et synchroniser le kit sans ouvrir la fenêtre.
En bref
- L'exécutable d'Atollo est aussi un programme en ligne de commande : avec une commande, il fait le travail et quitte, sans ouvrir la fenêtre.
- Utile pour préparer un kit pour un autre système, contrôler les composants ou voir l'environnement.
- Fonctionne aussi pendant que l'application est ouverte.
Comment l'utiliser
Ouvrez une console dans le dossier du kit. Sur Windows, dans PowerShell, ajoutez | Out-Host pour que la sortie apparaisse dans la console (l'exécutable est un programme à fenêtre) ; dans l'Invite de commandes, ce n'est pas nécessaire. Sur macOS et Linux, utilisez le chemin du programme (par exemple ./Atollo.AppImage).
cd D:\Atollo
.\Atollo.exe components | Out-Host
.\Atollo.exe prepare --only node,php --line php=8.3 | Out-Host
.\Atollo.exe check | Out-HostLes commandes
| Commande | Ce qu'elle fait |
|---|---|
env [--project <nom>] | Affiche l'environnement du kit (secrets masqués) ; avec un projet, avec ses versions. |
components [--target <système>] | Liste les composants : choisi ou non, groupe, version installée ou raison de l'indisponibilité. |
versions [<id>] | Sans id : les versions sur disque des outils installés. Avec un id : demande à la source les versions proposées et les enregistre. |
check | Demande à chaque composant installé sa version et marque ✓ ou ✗. |
check --kit | La santé du kit : disque, espace, chemin, permissions, bibliothèques, comme « Santé du kit » dans les Paramètres. Une ligne par contrôle (√, ! ou x) avec en dessous ce qu'il faut faire ; se termine par 1 si un contrôle est une erreur. |
check --files | Les fichiers des programmes, comme « Vérifier les fichiers » dans la page Outils : une ligne par dossier (√ en ordre, x endommagé avec les chemins manquants ou modifiés, - sans manifeste) ; se termine par 1 si un dossier est endommagé. |
prepare [options] | Installe, met à jour et retire les composants selon le choix. Les options sont dans le tableau ci-dessous. |
sync [--project <dossier>] [--verbose] | Aligne les instructions, skills et serveurs MCP des agents. |
serve <dossier> <port> | Sert un dossier comme site statique (le serveur de fichiers du kit). |
keyring restore | save | Utilisé par le kit autour d'Antigravity : remet ou enregistre sa connexion. |
models | Les modèles locaux : ceux du catalogue et ceux téléchargés. |
models pull <modèle> | Télécharge un id du catalogue ou un modèle de Hugging Face (propriétaire/nom:quantification) ; reprend s'il est interrompu. |
models rm <id> | Supprime un modèle téléchargé. |
llm start | stop | status | Le serveur des modèles locaux (chat et agents) : le démarre, l'arrête ou dit s'il répond. status n'envoie pas la clé à ce qui écoute sur le port. |
diagnostics | Crée le zip à joindre à un signalement (secrets masqués) dans data\app\diagnostics, comme « Exporter le diagnostic » dans les Paramètres, et en affiche le chemin. |
version · help | La version (aussi --version, -V) et l'aide (aussi --help, -h, /?). |
| Option de prepare | Effet |
|---|---|
--only a,b | Seulement ces composants (plus ce dont ils ont besoin), sans retirer les autres. |
--skip a,b | Tous sauf ceux-ci (les obligatoires ne peuvent pas être sautés). |
--update-all | Met aussi à jour ce qui est déjà installé. |
--force | Réinstalle même si la version est déjà celle-là. |
--line id=x.y | Ajoute cette version à côté des autres (peut être répété). |
--target <système> | Prépare pour un autre système : win32-x64, win32-arm64, darwin-arm64, darwin-x64, linux-x64, linux-arm64. |
Sous le capot
| Code de sortie | Signification |
|---|---|
0 | Tout va bien. |
1 | prepare ou check : quelque chose a échoué. |
2 | Commande inconnue (l'aide est aussi affichée). |
3 | prepare : une autre préparation du même kit est déjà en cours. |
En ligne de commande, prepare utilise GITHUB_TOKEN ou GH_TOKEN de la console, s'ils existent, pour relever la limite de l'API de GitHub ; il n'utilise pas le compte du kit. Si un téléchargement échoue, il affiche l'adresse à télécharger à la main et le dossier où le mettre.