Ligne de commande (CLI v2)
Utilisez SARION dans votre terminal, sur vos propres fichiers de projet. À quoi elle sert, ce qu’il vous faut, comment installer la préversion signée, et comment la mettre à jour ou la retirer.
Où le trouver Capabilities > Terminal (CLI)
Ce que c’est
La ligne de commande SARION est un client en terminal pour votre compte SARION. Vous l’exécutez sur votre propre ordinateur ou sur un serveur, dans un dossier de projet. Elle peut lire les fichiers que vous autorisez, proposer ou appliquer des modifications, et répondre à des questions sur votre projet. Elle utilise le même compte et les mêmes crédits que l’application web SARION : il n’y a donc rien de distinct à acheter.
Cette rubrique décrit CLI v2, actuellement une préversion publique (version 2.0.0-preview.2). Une préversion peut changer d’une version à l’autre. Ses autorisations sont explicites : par défaut, elle ne fait que lire, et tout ce qui modifie vos fichiers ou exécute un programme demande votre approbation.
Quand l’utiliser
Utilisez-la quand le travail se trouve dans un dossier de votre machine : comprendre une base de code, trouver pourquoi un test échoue, préparer une modification ou poser une question sur un fichier. Utilisez l’application web pour tout le reste (chat, voix, documents, rapports, facturation).
Ce dont vous avez besoin
- Un compte SARION avec une formule active et du crédit. Voir Facturation et crédits.
- Node.js 24.21.0 ou plus récent dans la branche Node 24 (en dessous de Node 25), ainsi que npm, Git et Python 3. Vérifiez avec
node --versionetnpm --version. Node 20, 22 et 25 ne sont pas pris en charge par cette version. - Linux x64 (Ubuntu 22.04) : le bac à sable des programmes exige bubblewrap et l’outil
prlimitde util-linux. - macOS (Intel, macOS 15) : pris en charge et testé. Les autres versions de macOS et Apple Silicon ne sont pas confirmés.
- Windows : les outils sur fichiers fonctionnent, mais l’exécution de programmes et les modifications Git sont refusées sous Windows natif. Utilisez WSL2 (Windows Subsystem for Linux) et suivez les étapes Linux à l’intérieur.
- Les autres processeurs et systèmes ne sont pas confirmés.
Installer sous Linux, macOS ou WSL2
L’installateur est un paquet signé. Ces commandes le téléchargent, vérifient la signature de l’éditeur, la taille et la somme de contrôle par rapport à une empreinte que vous pouvez comparer, et ne l’installent qu’ensuite, dans son propre dossier, sans droits d’administrateur. Exécutez-les dans un nouveau dossier de travail vide :
mkdir sarion-cli-v2-preview &&
cd sarion-cli-v2-preview &&
curl -fL https://github.com/web3devworld/sarion-cli/releases/download/v2.0.0-preview.2/sarion-cli-v2.0.0-preview.2-signed.tar.gz -o sarion-cli-v2.0.0-preview.2-signed.tar.gz &&
mkdir bundle trusted &&
tar -xzf sarion-cli-v2.0.0-preview.2-signed.tar.gz -C bundle &&
curl -fL https://github.com/web3devworld/sarion-cli/releases/download/v2.0.0-preview.2/sarion-cli-release-ed25519-public.pem -o trusted/operator-public.pem &&
git clone https://github.com/web3devworld/sarion-cli.git reviewed-source &&
git -C reviewed-source switch --detach 7c3e855f6d2825494f9e85aca57442c16d773893 &&
node reviewed-source/scripts/verify-release.mjs bundle trusted/operator-public.pem c3c3fc868422444696ca730e3eb2679640682d5cd68521607b7c350a3f93ab40 &&
SARION_RELEASE_PUBLIC_KEY="$PWD/trusted/operator-public.pem" node reviewed-source/scripts/install.mjs bundle "$HOME/.local/share/sarion-cli-v2" &&
export PATH="$HOME/.local/share/sarion-cli-v2/bin:$PATH" &&
sarion --version &&
sarion --help
L’étape de vérification affiche une ligne qui commence par {"verified":true. Si ce n’est pas le cas, arrêtez-vous : voir Dépannage de la ligne de commande. Les deux dernières commandes doivent afficher 2.0.0-preview.2 et la liste des commandes.
Pour utiliser sarion dans chaque nouveau terminal, ajoutez $HOME/.local/share/sarion-cli-v2/bin au PATH dans le fichier de démarrage de votre shell. L’empreinte figurant dans la commande (c3c3fc86…) est l’empreinte officielle ; la page Terminal (CLI) dans SARION affiche la même valeur, ce qui vous permet de les comparer.
Windows
La voie prise en charge pour exécuter des programmes et modifier Git est WSL2 : ouvrez un terminal Ubuntu dans WSL2, installez-y Node 24, npm, Git et Python 3, puis utilisez les commandes Linux ci-dessus. Une installation sous PowerShell existe aussi, pour les seuls outils sur fichiers ; ses commandes exactes figurent sur la page Terminal (CLI) dans SARION.
Vérifier que cela fonctionne
- Exécutez
sarion --version. Elle affiche2.0.0-preview.2. - Exécutez
sarion --help. Elle liste toutes les commandes. - Exécutez
sarion sandbox doctor. Elle indique si cette machine peut contenir des programmes en toute sécurité. Il n’est pas nécessaire d’être connecté.
Ensuite : se connecter.
Si un ancien sarion est déjà installé
L’ancien outil en ligne de commande (version 0.x) est un programme différent. L’installateur de la v2 utilise son propre dossier et ne le remplace pas. Si taper sarion ouvre encore l’ancien outil, exécutez le programme v2 par son chemin complet, ~/.local/share/sarion-cli-v2/bin/sarion --version, ou placez son dossier en premier dans votre PATH.
Mise à jour
Les mises à jour sont manuelles. Il n’y a ni mise à jour automatique ni commande sarion update dans la v2. Arrêtez les sessions en cours, téléchargez la prochaine version signée, vérifiez-la de la même façon et installez-la dans le même dossier. Conservez vos données de récupération pendant la mise à jour.
Désinstallation
- Exécutez
sarion logoutpour que votre connexion soit révoquée. - Retirez le programme :
npm uninstall --global --ignore-scripts --offline --no-audit --no-fund --prefix "$HOME/.local/share/sarion-cli-v2" @volta/sarion-cli.
Retirer le programme ne vous déconnecte pas et ne supprime pas les données de récupération. Ne supprimez pas un journal de récupération pour contourner une erreur.
Questions fréquentes
La ligne de commande est-elle disponible sur npm ?
Non. Cette version s’installe à partir du téléchargement signé ci-dessus, et non avec npm install -g.
Cela coûte-t-il un supplément ?
Non. Elle utilise votre formule et votre crédit SARION. Voir Autorisations, récupération et crédits.
Fonctionne-t-elle hors ligne ?
Non. Chaque requête passe par votre compte SARION.