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ê quer | Comando |
|---|---|
| Status geral | saba-chan-cli status |
| Adicionar um servidor | saba-chan-cli server add |
| Iniciar · parar · reiniciar | saba-chan-cli start pal · stop pal · restart pal |
| Console · comando do jogo | saba-chan-cli console pal · saba-chan-cli run fim say Olá |
| Backups · tarefas agendadas | saba-chan-cli backup … · saba-chan-cli schedule … |
| Conectar o Discord | saba-chan-cli bot pair (mostra um código e espera conectar) |
| Permissões de comando · ver comandos por nível | saba-chan-cli perm … · perm commands |
| Etapa de confirmação no Discord | saba-chan-cli bot confirm |
| Prefixo e formato dos comandos de barra do servidor do Discord | saba-chan-cli bot prefix … · bot slash … |
| Saba-chan leitora · gerenciamento do servidor do Discord | saba-chan-cli bot tts … · bot moderation · bot channel … |
| Ver as ferramentas da Saba-chan falante | saba-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-chan | saba-chan-cli update check · update apply |
| Daemon remoto | saba-chan-cli remote … · --daemon <nome> em qualquer comando (Daemon remoto) |
| Mudar para o app | saba-chan-cli gui |
| Apagar todos os meus dados | saba-chan-cli bot erase |
| Ajuda detalhada | saba-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.
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, trazerror,error_codee, se houver,suggestions.- Códigos de saída:
0sucesso,1falha,2erro de uso ou vários alvos possíveis,3sem acesso ao daemon,4alvo não encontrado,130cancelado. 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 --planmostra o que mudaria antes de executar.
O que uma pessoa precisa fazer
- Comandos que precisam de confirmação (inclusive
stoperestartde 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--yesem 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
--yesou--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.
- 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 agente emsaba-chan-cli bot agent. - 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.
- 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 agentena tela Configurações → Conexão do app,/mysaba agentno Discord ousaba-chan-cli bot agent --unlink. Uma conexão sem uso por 90 dias é desconectada automaticamente.