Commandes et exemples
Chaque commande de la ligne de commande SARION avec sa syntaxe, un exemple, les formats de sortie et les options qui fonctionnent sur toutes les commandes.
Où le trouver Terminal, sarion --help
Comment les commandes sont écrites
sarion --help affiche la liste complète. Dans la syntaxe ci-dessous, <valeur> est obligatoire, [valeur] est facultatif et a|b signifie « l’un ou l’autre ». La ligne de commande n’a pas de page d’aide distincte pour chaque commande : sarion <commande> --help affiche la même liste générale. Les exemples ont été vérifiés sur SARION CLI v2 2.0.0-preview.2. Les commandes qui parlent à votre compte exigent d’abord d’être connecté (voir Se connecter depuis la ligne de commande), et ask, agent et chat consomment du crédit.
Ask, agent et chat
sarion ask <prompt> [--attach path] [--stdin] [--format json|ndjson]envoie une question et affiche la réponse. Ne joignez que ce que vous choisissez :sarion ask 'Explain this file' --attach src/main.ts. Pour envoyer du texte par un tube, ajoutez--stdin:git diff | sarion ask 'Review this patch' --stdin.sarion agent <task> [--permission-mode mode] [--share-context] [--model auto|id] [--resume id]laisse SARION travailler sur votre dossier de projet dans le mode d’autorisation que vous choisissez. Première requête, en lecture seule :sarion agent 'Summarize this project without changing files' --model auto --permission-mode read-only --share-context.sarion chat [--resume [id]] [--model auto|id], ou simplementsarion, démarre une conversation dans le terminal. Reprenez une conversation précédente avec--resume SESSION_ID.- Limites pour une exécution :
--max-steps N,--max-tool-calls N,--max-output-tokens Net--max-context-tokens N.
--share-context est votre consentement explicite à l’envoi de données choisies de votre projet à SARION. Les chemins sensibles, les fichiers ignorés et les liens symboliques sont exclus, mais ne vous y fiez pas dans un dossier plein de secrets. Les scripts qui s’exécutent sans personne devant le clavier doivent donner eux-mêmes ce consentement et les autorisations requises.
Compte, modèles et crédit
sarion whoamiaffiche le compte connecté, le profil et l’expiration de l’identifiant.sarion modelsliste les modèles que votre formule vous permet d’utiliser. Utilisez--model auto, ou l’un des identifiants qu’elle affiche.sarion usageaffiche l’utilisation et le solde que le serveur indique pour votre compte. Exécutez-la avant et après une requêteagentpour voir ce que la requête a consommé.sarion account list|use <id>etsarion tenant list|use <id>listent les comptes et espaces de travail que vous pouvez utiliser, et permettent de passer de l’un à l’autre.sarion login,sarion logoutet leurs options sont expliqués dans Se connecter depuis la ligne de commande.
Projets
Ces commandes travaillent sur le dossier où vous vous trouvez, ou sur celui donné avec --project path, et n’exigent aucune connexion :
sarion project initcrée les réglages du projet. En mode interactif, elle demande d’abord confirmation ; dans un script, ajoutez--permission-mode workspace-write. Si le projet est déjà configuré, elle le dit et ne fait rien.sarion project statusaffiche le dossier, son identifiant d’espace de travail et le nombre de fichiers visibles par SARION.sarion project filesliste ces fichiers,sarion project search <text>cherche du texte dedans, etsarion project read <path>affiche un fichier. Exemple :sarion project search helloaffiche chaque correspondance sous la forme{"path":"README.md","line":2,"text":"hello world"}.
Placez des consignes pour SARION dans un fichier nommé AGENTS.md ou SARION.md dans le dossier. Ce ne sont que des conseils : ils n’accordent jamais d’autorisation.
Sessions, points de contrôle et récupération
sarion session list,sarion session show <id>,sarion session history <id>etsarion session delete <id>gèrent vos sessions enregistrées.sarion checkpoint listetsarion checkpoint restore <id>listent et restaurent des états enregistrés de vos fichiers.sarion recover <session-id> [--abandon <command-id>]examine une session qui s’est arrêtée alors qu’une modification était incertaine. Voir Autorisations, récupération et crédits.
Réglages, politique et vérifications
sarion config list,sarion config get <key>etsarion config set <key> <value>lisent et modifient les réglages locaux. Exemple :sarion config set verbosity quietafficheSaved. Une clé qui n’existe pas affichenull.sarion policyaffiche la politique protégée qui s’applique, etsarion audit [count]affiche ce que le programme a fait sur cette machine.sarion sandbox doctorindique si des programmes peuvent être exécutés en sécurité ici. Sur une machine Linux prise en charge, elle affiche un court rapport avec"available": true, le profil et l’autorisation ou non de l’accès réseau.sarion endpoint list|add <name> --url URL --boundary cloud|use <name>|doctorgère les profils de serveur. La plupart des gens n’en ont jamais besoin, car le profil nommé cloud est intégré.
Options valables pour toutes les commandes
--profile namechoisit un profil de serveur et--project pathchoisit le dossier.--format text|json|ndjsonchoisit le format de sortie.textest fait pour être lu.jsonaffiche un seul objet résultat, etndjsonaffiche un flux avec un objet JSON par ligne. Utilisez-les dans les scripts.--verbosity quiet|normal|verbosechoisit la quantité d’informations affichées.--non-interactivene pose jamais de question : un script échoue au lieu d’attendre.--timeout secondsarrête une commande trop longue.--encrypted-storedéverrouille le magasin de connexion chiffré (voir Se connecter depuis la ligne de commande).
En --format json, une erreur ressemble à {"state":"error","error":{"code":"UNAUTHENTICATED","message":"Run sarion login first"},"recoveryRequired":false}. Testez le code de sortie (voir Dépannage de la ligne de commande).
Questions fréquentes
Quelle commande utiliser pour une question rapide ?
sarion ask 'votre question'. Ajoutez --attach path pour inclure un fichier.
Comment l’utiliser dans un script ?
Ajoutez --non-interactive --format json, indiquez explicitement le mode d’autorisation et --share-context, et vérifiez le code de sortie.
Existe-t-il un « oui » automatique ?
Non. Il n’y a pas d’option --yes. Chaque modification est limitée par le mode d’autorisation que vous choisissez.