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öchtenBefehl
Gesamtstatussaba-chan-cli status
Server hinzufügensaba-chan-cli server add
Starten · Stoppen · Neustartsaba-chan-cli start pal · stop pal · restart pal
Konsole · Spielbefehlsaba-chan-cli console pal · saba-chan-cli run wochenend say Hallo
Backups · geplante Aufgabensaba-chan-cli backup … · saba-chan-cli schedule …
Discord verbindensaba-chan-cli bot pair (zeigt einen Code und wartet, bis die Verbindung steht)
Befehlsrechte · Befehle pro Stufe ansehensaba-chan-cli perm … · perm commands
Rückfragestufe für Discordsaba-chan-cli bot confirm
Präfix und Aussehen der Slash-Befehle pro Discord-Serversaba-chan-cli bot prefix … · bot slash …
Vorlesende Saba-chan · Verwaltung des Discord-Serverssaba-chan-cli bot tts … · bot moderation · bot channel …
Tools der Sprechenden Saba-chan ansehensaba-chan-cli chatbot tools (ändern: chatbot set tools=[lol,pubg] --guild …)
Verbundene KI-Agenten (remote) ansehen · trennensaba-chan-cli bot agent · bot agent --unlink
Saba-chan-Updatessaba-chan-cli update check · update apply
Remote-Daemonsaba-chan-cli remote … · --daemon <Name> bei jedem Befehl (Remote-Daemon)
Zur App wechselnsaba-chan-cli gui
Alle meine Daten löschensaba-chan-cli bot erase
Ausführliche Hilfesaba-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.

Mein KI-Agent (z. B. Claude Code, Codex)
›

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 es error, error_code und, falls vorhanden, suggestions.
  • Exit-Codes: 0 Erfolg, 1 Fehler, 2 falsche Verwendung oder mehrere passende Ziele, 3 Daemon nicht erreichbar, 4 Ziel nicht gefunden, 130 abgebrochen.
  • 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 --plan zeigt 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 --yes an 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 --yes oder --json erledigen. 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.

  1. Tragen Sie https://saba-chan.online/mcp auf 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 agent und mit saba-chan-cli bot agent.
  2. Ö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.
  3. 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 agent oder mit saba-chan-cli bot agent --unlink. Eine Verbindung, die 90 Tage nicht genutzt wurde, wird automatisch getrennt.