6. CLI und Agenten
Saba-chan im Terminal benutzen und Ihren eigenen KI-Agenten, etwa Claude Code oder Codex, damit arbeiten lassen.
6. CLI und Agenten
saba-chan-cli ist das Werkzeug, mit dem Sie Saba-chan im Terminal bedienen. Ein Terminal ist ein Fenster, in dem Sie Befehle eingeben. Alles, was die App kann, kann auch die CLI. Wie die App bittet auch die CLI nur den Daemon und fasst Serverdateien nie selbst an. Sie ist leicht zu bedienen und liefert auch maschinenlesbare Ausgaben. Damit können Sie Saba-chan Ihrem eigenen KI-Agenten überlassen.
Die CLI benutzen
Die CLI liegt im Installationsordner von Saba-chan (standardmäßig C:\Program Files\Saba-chan\saba-chan-cli.exe). Das Installationsprogramm ändert den System-PATH (die Liste der Ordner, in denen Windows nach Befehlen sucht) nicht. Rufen Sie sie also mit vollem Pfad auf oder fügen Sie den Ordner selbst zum PATH hinzu. Unter Linux legt das Installationsprogramm ~/.local/bin/saba-chan-cli an.
- Ohne Argumente gestartet, öffnet sie eine interaktive Oberfläche.
- Läuft der Daemon nicht, fragt sie, ob er gestartet werden soll. Schließen Sie die CLI, laufen Daemon und Server weiter.
- Ein Teil des Servernamens genügt.
| Was Sie möchten | Befehl |
|---|---|
| Gesamtstatus | saba-chan-cli status |
| Server hinzufügen | saba-chan-cli server add |
| Starten · Stoppen · Neustart | saba-chan-cli start pal · stop pal · restart pal |
| Konsole · Spielbefehl | saba-chan-cli console pal · saba-chan-cli run wochenend say Hallo |
| Backups · geplante Aufgaben | saba-chan-cli backup … · saba-chan-cli schedule … |
| Discord verbinden | saba-chan-cli bot pair (zeigt einen Code und wartet, bis die Verbindung steht) |
| Befehlsrechte · Befehle pro Stufe ansehen | saba-chan-cli perm … · perm commands |
| Rückfragestufe für Discord | saba-chan-cli bot confirm |
| Präfix und Aussehen der Slash-Befehle pro Discord-Server | saba-chan-cli bot prefix … · bot slash … |
| Vorlesende Saba-chan · Verwaltung des Discord-Servers | saba-chan-cli bot tts … · bot moderation · bot channel … |
| Tools der Sprechenden Saba-chan ansehen | saba-chan-cli chatbot tools (ändern: chatbot set tools=[lol,pubg] --guild …) |
| Verbundene KI-Agenten (remote) ansehen · trennen | saba-chan-cli bot agent · bot agent --unlink |
| Saba-chan-Updates | saba-chan-cli update check · update apply |
| Remote-Daemon | saba-chan-cli remote … · --daemon <Name> bei jedem Befehl (Remote-Daemon) |
| Zur App wechseln | saba-chan-cli gui |
| Alle meine Daten löschen | saba-chan-cli bot erase |
| Ausführliche Hilfe | saba-chan-cli <Befehl> --help |
Ihren KI-Agenten anbinden
Jeder KI-Agent, der Terminalbefehle ausführen kann, etwa Claude Code oder Codex, kann Saba-chan für Sie betreuen. Er nimmt Bitten in normalen Worten entgegen, führt im Hintergrund saba-chan-cli aus und liest das Ergebnis.
Damit sich Agenten darauf verlassen können, hält die CLI diese Regeln ein.
--json: Die Standardausgabe enthält genau ein JSON-Dokument. Hinweise und Fortschritt gehen auf die Standardfehlerausgabe. Bei Fehlern enthält eserror,error_codeund, falls vorhanden,suggestions.- Exit-Codes:
0Erfolg,1Fehler,2falsche Verwendung oder mehrere passende Ziele,3Daemon nicht erreichbar,4Ziel nicht gefunden,130abgebrochen. help --json: der vollständige Befehlsbaum, Argumente, globale Optionen und die Exit-Code-Tabelle als JSON. Funktioniert auch, wenn der Daemon aus ist. Lassen Sie Ihren Agenten zuerst das lesen, statt Befehle auswendig zu lernen.--json-stream: Lange Aufgaben (Server installieren, Updates) melden ihren Fortschritt als ein JSON-Objekt pro Zeile, das Ergebnis steht in der letzten Zeile.events --json: verfolgt Daemon-Ereignisse (Serverstart und -stopp, Installationsfortschritt usw.) Zeile für Zeile.do: die Liste der Aktionen, die der Daemon anbietet.do Aktion --planzeigt vor dem Ausführen, was sich ändern würde.
Was ein Mensch selbst tun muss
- Befehle, die eine Bestätigung brauchen, fragen außerhalb eines Terminals nicht nach, sondern brechen ab und laufen nur mit
--yes. Lassen Sie den Agenten nachfragen, bevor er--yesan etwas Unumkehrbares hängt, etwa das Löschen oder Zurücksetzen eines Servers. - Die Zustimmung zu einer Spiel-EULA und zum Ausführen eines ungeprüften Moduls ohne Isolation lässt sich nicht mit
--yesoder--jsonerledigen. Das macht ein Mensch im Terminal oder in der App.
Beispiel für die Anweisungen Ihres Agenten
Ergänzen Sie die Anweisungsdatei Ihres Agenten (zum Beispiel AGENTS.md oder CLAUDE.md) etwa so. Passen Sie den Pfad an Ihren Installationsort an.
## Saba-chan-Spielserver
- Spielserver nur mit saba-chan-cli verwalten: "C:\Program Files\Saba-chan\saba-chan-cli.exe"
- Befehle und Argumente einmal mit `saba-chan-cli help --json` lesen.
- An jeden Befehl --json hängen und den Exit-Code prüfen (0 Erfolg, 1 Fehler, 2 Verwendung oder mehrdeutig, 3 kein Daemon, 4 nicht gefunden).
- Vor --yes bei Unumkehrbarem, etwa Löschen oder Zurücksetzen eines Servers, den Menschen fragen.
- EULA-Zustimmung und das Abschalten der Isolation dem Menschen überlassen.
KI-Agenten remote verbinden (MCP)
Auch ein KI-Agent wie ChatGPT oder Claude, der das Terminal Ihres PCs nicht nutzen kann, lässt sich per Remote-MCP mit der Saba-chan-Cloud verbinden und kann dann die Spieleserver Ihres PCs übernehmen. Er steuert alle PCs, die mit Ihrem Discord-Konto verbunden sind, wie in der App.
- Tragen Sie
https://saba-chan.online/mcpauf dem Bildschirm des Agenten zum Hinzufügen eines Connectors (Remote-MCP-Server) ein. Diese Adresse sehen Sie auch im Bildschirm Einstellungen → Verbindung der App, unter/mysaba agentund mitsaba-chan-cli bot agent. - Öffnet sich im Browser die Discord-Anmeldung, melden Sie sich mit dem Discord-Konto an, mit dem Sie den PC verbunden haben, und erlauben es auf dem Saba-chan-Zustimmungsbildschirm.
- Bitten Sie den Agenten in Worten, etwas zu tun. Zum Beispiel: „Wie ist der Status des Minecraft-Servers?“, „Starte den Palworld-Server neu“
Gut zu wissen:
- Pro Discord-Konto ist nur ein Agent verbunden. Erlauben Sie einen weiteren Agenten, wird der zuerst verbundene getrennt.
- Gefährliche Befehle sowie Stoppen und Neustarten werden vor der Ausführung auf dem Bildschirm des Agenten noch einmal abgefragt (dieselbe Regel wie in der App). Es wird nicht über Discord gefragt.
- Was in Saba-chan Web gesperrt ist (PC-eigene Einstellungen wie Pfade und Passwörter, Saba-chan-Updates usw.), kann auch der Agent nicht tun.
- Trennen: im Bildschirm Einstellungen → Verbindung der App mit
Agentenverbindung trennen, in Discord mit/mysaba agentoder mitsaba-chan-cli bot agent --unlink. Eine Verbindung, die 90 Tage nicht genutzt wurde, wird automatisch getrennt.