SARION

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 simplement sarion, 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 N et --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 whoami affiche le compte connecté, le profil et l’expiration de l’identifiant.
  • sarion models liste les modèles que votre formule vous permet d’utiliser. Utilisez --model auto, ou l’un des identifiants qu’elle affiche.
  • sarion usage affiche l’utilisation et le solde que le serveur indique pour votre compte. Exécutez-la avant et après une requête agent pour voir ce que la requête a consommé.
  • sarion account list|use <id> et sarion 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 logout et 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 init cré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 status affiche le dossier, son identifiant d’espace de travail et le nombre de fichiers visibles par SARION.
  • sarion project files liste ces fichiers, sarion project search <text> cherche du texte dedans, et sarion project read <path> affiche un fichier. Exemple : sarion project search hello affiche 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> et sarion session delete <id> gèrent vos sessions enregistrées.
  • sarion checkpoint list et sarion 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> et sarion config set <key> <value> lisent et modifient les réglages locaux. Exemple : sarion config set verbosity quiet affiche Saved. Une clé qui n’existe pas affiche null.
  • sarion policy affiche la politique protégée qui s’applique, et sarion audit [count] affiche ce que le programme a fait sur cette machine.
  • sarion sandbox doctor indique 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>|doctor gè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 name choisit un profil de serveur et --project path choisit le dossier.
  • --format text|json|ndjson choisit le format de sortie. text est fait pour être lu. json affiche un seul objet résultat, et ndjson affiche un flux avec un objet JSON par ligne. Utilisez-les dans les scripts.
  • --verbosity quiet|normal|verbose choisit la quantité d’informations affichées.
  • --non-interactive ne pose jamais de question : un script échoue au lieu d’attendre. --timeout seconds arrête une commande trop longue.
  • --encrypted-store dé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.