6. CLI e agentes

Use o Saba-chan pelo terminal e deixe seu próprio agente de IA, como Claude Code ou Codex, cuidar dele.

6. CLI e agentes

saba-chan-cli é a ferramenta para usar o Saba-chan pelo terminal. Um terminal é uma janela onde você digita comandos. Tudo o que o app faz, a CLI também faz. Como o app, a CLI só pede ao daemon e nunca mexe nos arquivos do servidor por conta própria. Ela é fácil de usar para pessoas e também dá saídas legíveis por máquinas, então você pode usá-la para entregar o Saba-chan ao seu próprio agente de IA.


Usando a CLI

A CLI fica na pasta onde você instalou o Saba-chan (por padrão C:\Program Files\Saba-chan\saba-chan-cli.exe). O instalador não muda o PATH do sistema (a lista de pastas onde o Windows procura comandos). Chame a CLI pelo caminho completo ou adicione você mesmo essa pasta ao PATH. No Linux, o instalador cria ~/.local/bin/saba-chan-cli.

  • Sem argumentos, abre uma tela interativa.
  • Se o daemon não estiver rodando, pergunta se deve iniciá-lo. Fechar a CLI deixa o daemon e os servidores rodando.
  • Parte do nome do servidor já basta.
O que você querComando
Status geralsaba-chan-cli status
Adicionar um servidorsaba-chan-cli server add
Iniciar · parar · reiniciarsaba-chan-cli start pal · stop pal · restart pal
Console · comando do jogosaba-chan-cli console pal · saba-chan-cli run fim say Olá
Backups · tarefas agendadassaba-chan-cli backup … · saba-chan-cli schedule …
Conectar o Discordsaba-chan-cli bot pair (mostra um código e espera conectar)
Permissões de comando · ver comandos por nívelsaba-chan-cli perm … · perm commands
Etapa de confirmação no Discordsaba-chan-cli bot confirm
Prefixo e formato dos comandos de barra do servidor do Discordsaba-chan-cli bot prefix … · bot slash …
Saba-chan leitora · gerenciamento do servidor do Discordsaba-chan-cli bot tts … · bot moderation · bot channel …
Ver as ferramentas da Saba-chan falantesaba-chan-cli chatbot tools (para mudar: chatbot set tools=[lol,pubg] --guild …)
Ver e desconectar agentes de IA conectados (remotos)saba-chan-cli bot agent · bot agent --unlink
Atualizações do Saba-chansaba-chan-cli update check · update apply
Daemon remotosaba-chan-cli remote … · --daemon <nome> em qualquer comando (Daemon remoto)
Mudar para o appsaba-chan-cli gui
Apagar todos os meus dadossaba-chan-cli bot erase
Ajuda detalhadasaba-chan-cli <comando> --help

Conectando seu agente de IA

Qualquer agente de IA que consiga rodar comandos de terminal, como Claude Code ou Codex, pode cuidar do Saba-chan para você. O agente recebe pedidos em palavras comuns, como uma pessoa, roda saba-chan-cli nos bastidores e lê o resultado.

Meu agente de IA (ex.: Claude Code, Codex)
›

A CLI segue estas regras para que os agentes possam confiar nela.

  • --json: a saída padrão traz exatamente um documento JSON. Avisos e progresso vão para a saída de erro. Em caso de falha, traz error, error_code e, se houver, suggestions.
  • Códigos de saída: 0 sucesso, 1 falha, 2 erro de uso ou vários alvos possíveis, 3 sem acesso ao daemon, 4 alvo não encontrado, 130 cancelado.
  • help --json: a árvore completa de comandos, argumentos, opções globais e a tabela de códigos de saída em JSON. Funciona mesmo com o daemon desligado. Faça seu agente ler isso primeiro em vez de decorar comandos.
  • --json-stream: tarefas longas (instalar servidor, atualizações) informam o progresso com um objeto JSON por linha e o resultado na última.
  • events --json: acompanha os eventos do daemon (início e parada de servidores, progresso de instalação etc.) linha a linha.
  • do: a lista de ações que o daemon oferece. do ação --plan mostra o que mudaria antes de executar.

O que uma pessoa precisa fazer

  • Comandos que precisam de confirmação (inclusive stop e restart de um servidor ligado) não perguntam fora de um terminal; eles param e só rodam com --yes. Faça o agente perguntar a você antes de colocar --yes em algo irreversível, como apagar ou redefinir um servidor.
  • Aceitar a EULA de um jogo e aceitar rodar um módulo não verificado sem isolamento não dá para fazer com --yes ou --json. Uma pessoa faz isso no terminal ou no app.

Exemplo para colar nas instruções do seu agente

Adicione algo assim ao arquivo de instruções do seu agente (por exemplo AGENTS.md ou CLAUDE.md). Ajuste o caminho para o seu local de instalação.

## Servidores de jogo do Saba-chan
- Gerenciar os servidores de jogo só com o saba-chan-cli: "C:\Program Files\Saba-chan\saba-chan-cli.exe"
- Ler uma vez os comandos e argumentos com `saba-chan-cli help --json`.
- Colocar --json em todo comando e conferir o código de saída (0 sucesso, 1 falha, 2 uso ou ambíguo, 3 sem daemon, 4 não encontrado).
- Perguntar à pessoa antes de colocar --yes em algo irreversível, como apagar ou redefinir um servidor.
- Deixar com a pessoa a aceitação da EULA e o desligamento do isolamento.

Conectando um agente de IA remotamente (MCP)

Mesmo que um agente de IA como o ChatGPT ou o Claude não consiga usar o terminal do seu PC, você pode ligá-lo à nuvem do Saba-chan por MCP remoto e deixar com ele os servidores de jogo do seu PC. Ele cuida de todos os PCs conectados à sua conta do Discord, como no aplicativo.

  1. Na tela de adicionar conector (servidor MCP remoto) do agente, coloque https://saba-chan.online/mcp. Esse endereço também aparece na tela Configurações → Conexão do app, em /mysaba agent e em saba-chan-cli bot agent.
  2. Quando o login do Discord abrir no navegador, entre com a conta do Discord à qual o PC está conectado e permita na tela de consentimento do Saba-chan.
  3. Peça ao agente em palavras comuns. Por exemplo: "diga o status do servidor de Minecraft", "reinicie o servidor de Palworld".

Vale saber:

  • Cada conta do Discord tem um só agente conectado. Se você permitir outro agente, o que estava conectado antes é desconectado.
  • Comandos perigosos, parar e reiniciar são confirmados de novo na tela do agente antes de executar (mesma regra do app). A confirmação não é feita pelo Discord.
  • O que fica bloqueado no Saba-chan web (configurações só do PC, como caminhos e senhas, e atualizações do Saba-chan) também não pode ser feito pelo agente.
  • Para desconectar: o botão Desconectar agente na tela Configurações → Conexão do app, /mysaba agent no Discord ou saba-chan-cli bot agent --unlink. Uma conexão sem uso por 90 dias é desconectada automaticamente.