6. CLI et agents
Utiliser Saba-chan depuis un terminal, et le confier à votre propre agent IA comme Claude Code ou Codex.
6. CLI et agents
saba-chan-cli est l'outil pour utiliser Saba-chan depuis un terminal. Un terminal est une fenêtre où l'on tape des commandes. Tout ce que fait l'app, la CLI le fait aussi. Comme l'app, la CLI ne fait que demander au démon et ne touche jamais elle-même aux fichiers des serveurs. Elle est facile à utiliser pour les humains et produit aussi une sortie lisible par les machines. Vous pouvez donc l'utiliser pour confier Saba-chan à votre propre agent IA.
Utiliser la CLI
La CLI se trouve dans le dossier où vous avez installé Saba-chan (par défaut C:\Program Files\Saba-chan\saba-chan-cli.exe). L'installateur ne modifie pas le PATH du système (la liste des dossiers où Windows cherche les commandes). Appelez la CLI avec son chemin complet ou ajoutez vous-même ce dossier au PATH. Sous Linux, l'installateur crée ~/.local/bin/saba-chan-cli.
- Lancée sans argument, elle ouvre un écran interactif.
- Si le démon ne tourne pas, elle demande s'il faut le démarrer. Fermer la CLI laisse le démon et les serveurs tourner.
- Une partie du nom du serveur suffit.
| Ce que vous voulez | Commande |
|---|---|
| État général | saba-chan-cli status |
| Ajouter un serveur | saba-chan-cli server add |
| Démarrer · arrêter · redémarrer | saba-chan-cli start pal · stop pal · restart pal |
| Console · commande de jeu | saba-chan-cli console pal · saba-chan-cli run week say Salut |
| Sauvegardes · tâches planifiées | saba-chan-cli backup … · saba-chan-cli schedule … |
| Connecter Discord | saba-chan-cli bot pair (affiche un code et attend la connexion) |
| Droits de commande · voir les commandes par niveau | saba-chan-cli perm … · perm commands |
| Niveau de demande de précision de Discord | saba-chan-cli bot confirm |
| Préfixe et forme des slash commands d'un serveur Discord | saba-chan-cli bot prefix … · bot slash … |
| Saba-chan qui lit · gestion du serveur Discord | saba-chan-cli bot tts … · bot moderation · bot channel … |
| Voir les outils de Saba-chan qui parle | saba-chan-cli chatbot tools (pour les modifier : chatbot set tools=[lol,pubg] --guild …) |
| Voir · déconnecter les agents IA connectés (à distance) | saba-chan-cli bot agent · bot agent --unlink |
| Mises à jour de Saba-chan | saba-chan-cli update check · update apply |
| Daemon distant | saba-chan-cli remote … · --daemon <nom> sur n'importe quelle commande (Daemon distant) |
| Passer à l'app | saba-chan-cli gui |
| Effacer toutes mes données | saba-chan-cli bot erase |
| Aide détaillée | saba-chan-cli <commande> --help |
Brancher votre agent IA
Tout agent IA capable de lancer des commandes de terminal, comme Claude Code ou Codex, peut s'occuper de Saba-chan pour vous. Il reçoit des demandes en mots simples, comme une personne, lance saba-chan-cli en coulisses et lit le résultat.
La CLI respecte ces règles pour que les agents puissent s'y fier.
--json: la sortie standard contient exactement un document JSON. Les messages et la progression vont sur la sortie d'erreur. En cas d'échec, il contienterror,error_codeet, s'il y en a,suggestions.- Codes de sortie :
0succès,1échec,2erreur d'utilisation ou plusieurs cibles possibles,3démon injoignable,4cible introuvable,130annulé. help --json: l'arbre complet des commandes, les arguments, les options globales et la table des codes de sortie en JSON. Fonctionne même démon arrêté. Faites lire cela en premier à votre agent plutôt que de lui faire mémoriser les commandes.--json-stream: les tâches longues (installation d'un serveur, mises à jour) donnent leur progression à raison d'un objet JSON par ligne, avec le résultat sur la dernière.events --json: suit les événements du démon (démarrage et arrêt des serveurs, progression d'installation, etc.) ligne par ligne.do: la liste des actions proposées par le démon.do action --planmontre ce qui changerait avant de l'exécuter.
Ce qu'une personne doit faire elle-même
- Les commandes qui demandent confirmation ne posent pas la question hors d'un terminal : elles s'arrêtent et ne s'exécutent qu'avec
--yes. Faites demander l'agent avant d'ajouter--yesà une action irréversible, comme supprimer ou réinitialiser un serveur. - Accepter l'EULA d'un jeu, et accepter de lancer un module non vérifié sans isolation, ne peut pas se faire avec
--yesou--json. Une personne le fait dans un terminal ou dans l'app.
Exemple à coller dans les instructions de votre agent
Ajoutez quelque chose comme ceci au fichier d'instructions de votre agent (par exemple AGENTS.md ou CLAUDE.md). Adaptez le chemin à votre installation.
## Serveurs de jeu Saba-chan
- Gérer les serveurs de jeu uniquement avec saba-chan-cli : "C:\Program Files\Saba-chan\saba-chan-cli.exe"
- Lire une fois les commandes et arguments avec `saba-chan-cli help --json`.
- Ajouter --json à chaque commande et vérifier le code de sortie (0 succès, 1 échec, 2 utilisation ou ambigu, 3 pas de démon, 4 introuvable).
- Demander à la personne avant d'ajouter --yes à une action irréversible, comme supprimer ou réinitialiser un serveur.
- Laisser à la personne l'acceptation de l'EULA et la désactivation de l'isolation.
Connecter un agent IA à distance (MCP)
Même si un agent IA comme ChatGPT ou Claude ne peut pas utiliser le terminal de votre PC, vous pouvez le brancher au cloud Saba-chan par MCP distant et lui confier les serveurs de jeu de votre PC. Il gère tous les PC reliés à votre compte Discord comme le fait l'app.
- Dans l'écran d'ajout de connecteur (serveur MCP distant) de l'agent, saisissez
https://saba-chan.online/mcp. Cette adresse figure aussi dans l'écran Paramètres → Connexion de l'app, avec/mysaba agentetsaba-chan-cli bot agent. - Quand la connexion Discord s'ouvre dans le navigateur, connectez-vous avec le compte Discord auquel votre PC est relié et autorisez-le sur l'écran de consentement de Saba-chan.
- Demandez ensuite à l'agent en mots simples. Exemple : « Dis-moi l'état du serveur Minecraft », « Redémarre le serveur Palworld »
À savoir :
- Un seul agent peut être connecté par compte Discord. Si vous en autorisez un autre, celui qui était connecté avant est déconnecté.
- Les commandes dangereuses, ainsi que l'arrêt et le redémarrage, sont redemandées dans l'écran de l'agent avant d'être exécutées (mêmes règles que dans l'app). Rien n'est demandé par Discord.
- Ce qui est bloqué dans Saba-chan web (réglages propres au PC comme les chemins et les mots de passe, mise à jour de Saba-chan, etc.) ne peut pas non plus se faire par l'agent.
- Pour déconnecter :
Déconnecter l'agentdans l'écran Paramètres → Connexion de l'app,/mysaba agentdans Discord, ousaba-chan-cli bot agent --unlink. Une connexion restée inutilisée pendant 90 jours se coupe d'elle-même.