6. CLI y agentes

Use Saba-chan desde una terminal y deje que su propio agente de IA, como Claude Code o Codex, lo maneje por usted.

6. CLI y agentes

saba-chan-cli es la herramienta para usar Saba-chan desde una terminal. Una terminal es una ventana donde se escriben comandos. Todo lo que hace la app también lo hace la CLI. Como la app, la CLI solo le pide cosas al demonio y nunca toca los archivos del servidor. Es fácil de usar para las personas y además da salidas legibles por máquinas, así que puede usarla para confiar Saba-chan a su propio agente de IA.


Usar la CLI

La CLI está en la carpeta donde instaló Saba-chan (por defecto C:\Program Files\Saba-chan\saba-chan-cli.exe). El instalador no cambia el PATH del sistema (la lista de carpetas donde Windows busca comandos). Llame a la CLI con la ruta completa o añada usted esa carpeta al PATH. En Linux, el instalador crea ~/.local/bin/saba-chan-cli.

  • Sin argumentos abre una pantalla interactiva.
  • Si el demonio no está en marcha, pregunta si lo inicia. Al cerrar la CLI, el demonio y los servidores siguen funcionando.
  • Basta con parte del nombre del servidor.
Qué quiereComando
Estado generalsaba-chan-cli status
Añadir un servidorsaba-chan-cli server add
Iniciar · detener · reiniciarsaba-chan-cli start pal · stop pal · restart pal
Consola · comando del juegosaba-chan-cli console pal · saba-chan-cli run finde say Hola
Copias · tareas programadassaba-chan-cli backup … · saba-chan-cli schedule …
Conectar Discordsaba-chan-cli bot pair (muestra un código y espera a que se conecte)
Permisos de comandos · ver los comandos por nivelsaba-chan-cli perm … · perm commands
Nivel de repreguntas en Discordsaba-chan-cli bot confirm
Prefijo y aspecto de los slash commands de un servidor de Discordsaba-chan-cli bot prefix … · bot slash …
Saba-chan lectora · gestión del servidor de Discordsaba-chan-cli bot tts … · bot moderation · bot channel …
Ver las herramientas de Saba-chan parlantesaba-chan-cli chatbot tools (para cambiarlas: chatbot set tools=[lol,pubg] --guild …)
Ver y desconectar los agentes de IA conectados (remoto)saba-chan-cli bot agent · bot agent --unlink
Actualizaciones de Saba-chansaba-chan-cli update check · update apply
Daemon remotosaba-chan-cli remote … · --daemon <nombre> en cualquier comando (Daemon remoto)
Cambiar a la appsaba-chan-cli gui
Borrar todos mis datossaba-chan-cli bot erase
Ayuda detalladasaba-chan-cli <comando> --help

Conectar su agente de IA

Cualquier agente de IA que pueda ejecutar comandos de terminal, como Claude Code o Codex, puede ocuparse de Saba-chan por usted. El agente recibe peticiones en palabras normales, como una persona, ejecuta saba-chan-cli por detrás y lee el resultado.

Mi agente de IA (p. ej. Claude Code, Codex)
›

La CLI cumple estas reglas para que los agentes puedan fiarse de ella.

  • --json: la salida estándar lleva exactamente un documento JSON. Los avisos y el progreso van a la salida de error. Si falla, incluye error, error_code y, si las hay, suggestions.
  • Códigos de salida: 0 éxito, 1 fallo, 2 error de uso o varios objetivos posibles, 3 no se alcanza el demonio, 4 objetivo no encontrado, 130 cancelado.
  • help --json: el árbol completo de comandos, los argumentos, las opciones globales y la tabla de códigos de salida en JSON. Funciona aunque el demonio esté apagado. Haga que su agente lea esto primero en vez de memorizar comandos.
  • --json-stream: los trabajos largos (instalar un servidor, actualizaciones) informan del progreso con un objeto JSON por línea y el resultado en la última.
  • events --json: sigue los eventos del demonio (inicio y parada de servidores, progreso de instalación, etc.) línea a línea.
  • do: la lista de acciones que ofrece el demonio. do acción --plan muestra qué cambiaría antes de ejecutarla.

Lo que tiene que hacer una persona

  • Los comandos que necesitan confirmación no preguntan fuera de una terminal; se detienen y solo se ejecutan con --yes. Haga que el agente le pregunte antes de añadir --yes a algo irreversible, como borrar o reiniciar de fábrica un servidor.
  • Aceptar la EULA de un juego y aceptar ejecutar un módulo no verificado sin aislamiento no se puede hacer con --yes ni --json. Lo hace una persona en la terminal o en la app.

Ejemplo para pegar en las instrucciones de su agente

Añada algo así al archivo de instrucciones de su agente (por ejemplo AGENTS.md o CLAUDE.md). Ajuste la ruta a su carpeta de instalación.

## Servidores de juego de Saba-chan
- Gestionar los servidores de juego solo con saba-chan-cli: "C:\Program Files\Saba-chan\saba-chan-cli.exe"
- Leer una vez comandos y argumentos con `saba-chan-cli help --json`.
- Añadir --json a todos los comandos y comprobar el código de salida (0 éxito, 1 fallo, 2 uso o ambiguo, 3 sin demonio, 4 no encontrado).
- Preguntar a la persona antes de añadir --yes a algo irreversible, como borrar o reiniciar de fábrica un servidor.
- Dejar a la persona la aceptación de la EULA y la desactivación del aislamiento.

Conectar un agente de IA de forma remota (MCP)

Aunque un agente de IA como ChatGPT o Claude no pueda usar la terminal de su PC, puede conectarlo por MCP remoto a la nube de Saba-chan y encargarle los servidores de juego de su PC. Maneja todos los PC conectados a su cuenta de Discord como lo hace la app.

  1. En la pantalla de añadir un conector (servidor MCP remoto) del agente, introduzca https://saba-chan.online/mcp. Esta dirección también aparece en la pantalla Ajustes → Conexión de la app, en /mysaba agent y en saba-chan-cli bot agent.
  2. Cuando se abra el inicio de sesión de Discord en el navegador, inicie sesión con la cuenta de Discord que conectó los PC y permita el acceso en la pantalla de consentimiento de Saba-chan.
  3. Pídaselo al agente con palabras. Por ejemplo: «dime cómo está el servidor de Minecraft», «reinicia el servidor de Palworld».

Conviene saber:

  • Solo se conecta un agente por cuenta de Discord. Si permite otro agente, el que se conectó antes se desconecta.
  • Los comandos peligrosos y detener o reiniciar vuelven a preguntarse en la pantalla del agente antes de ejecutarse (la misma regla que en la app). No se pregunta por Discord.
  • Lo que está bloqueado en Saba-chan web (ajustes exclusivos del PC como rutas y contraseñas, actualizar Saba-chan, etc.) tampoco se puede hacer con el agente.
  • Para desconectar: Desconectar el agente en la pantalla Ajustes → Conexión de la app, /mysaba agent en Discord o saba-chan-cli bot agent --unlink. Una conexión que no se usa durante 90 días se desconecta sola.