6. CLI и агенты

Управляйте Saba-chan из терминала и поручите это своему ИИ-агенту, например Claude Code или Codex.

6. CLI и агенты

saba-chan-cli — инструмент для работы с Saba-chan из терминала. Терминал — это окно, в которое вводят команды. Всё, что умеет приложение, умеет и CLI. Как и приложение, CLI только просит демона и никогда сама не трогает файлы серверов. Ею удобно пользоваться людям, и она умеет выдавать машиночитаемый вывод, поэтому с её помощью можно передать Saba-chan своему ИИ-агенту.


Работа с CLI

CLI лежит в папке, куда установлен Saba-chan (по умолчанию C:\Program Files\Saba-chan\saba-chan-cli.exe). Установщик не меняет системный PATH (список папок, где Windows ищет команды). Вызывайте CLI по полному пути или добавьте эту папку в PATH сами. В Linux установщик создаёт ~/.local/bin/saba-chan-cli.

  • Без аргументов открывается интерактивный экран.
  • Если демон не запущен, CLI спросит, запустить ли его. После закрытия CLI демон и серверы продолжают работать.
  • Достаточно части имени сервера.
Что нужноКоманда
Общее состояниеsaba-chan-cli status
Добавить серверsaba-chan-cli server add
Запуск · остановка · перезапускsaba-chan-cli start pal · stop pal · restart pal
Консоль · игровая командаsaba-chan-cli console pal · saba-chan-cli run выходн say Привет
Бэкапы · задачи по расписаниюsaba-chan-cli backup … · saba-chan-cli schedule …
Подключить Discordsaba-chan-cli bot pair (показывает код и ждёт подключения)
Права на команды · команды по уровнямsaba-chan-cli perm … · perm commands
Уровень уточняющих вопросов в Discordsaba-chan-cli bot confirm
Префикс сервера Discord · вид слэш-командsaba-chan-cli bot prefix … · bot slash …
Читающая Saba-chan · управление сервером Discordsaba-chan-cli bot tts … · bot moderation · bot channel …
Инструменты Говорящей Saba-chansaba-chan-cli chatbot tools (изменить: chatbot set tools=[lol,pubg] --guild …)
Подключённые ИИ-агенты (удалённые): просмотр · отключениеsaba-chan-cli bot agent · bot agent --unlink
Обновления Saba-chansaba-chan-cli update check · update apply
Удалённый демонsaba-chan-cli remote … · --daemon <имя> у любой команды (Удалённый демон)
Перейти в приложениеsaba-chan-cli gui
Удалить все мои данныеsaba-chan-cli bot erase
Подробная справкаsaba-chan-cli <команда> --help

Подключение своего ИИ-агента

Любой ИИ-агент, который умеет выполнять команды терминала, например Claude Code или Codex, может присматривать за Saba-chan вместо вас. Агент принимает просьбы обычными словами, как человек, за кадром запускает saba-chan-cli и читает результат.

Мой ИИ-агент (например, Claude Code, Codex)
›

Чтобы агенты могли на неё полагаться, CLI соблюдает такие правила.

  • --json: в стандартный вывод идёт ровно один JSON-документ. Подсказки и ход выполнения идут в стандартный поток ошибок. При неудаче в нём есть error, error_code и, если есть, suggestions.
  • Коды выхода: 0 успех, 1 ошибка, 2 неверное использование или несколько подходящих целей, 3 нет связи с демоном, 4 цель не найдена, 130 отменено.
  • help --json: полное дерево команд, аргументы, глобальные параметры и таблица кодов выхода в JSON. Работает даже при выключенном демоне. Пусть агент сначала читает это, а не заучивает команды.
  • --json-stream: долгие задачи (установка сервера, обновления) сообщают о ходе выполнения по одному JSON-объекту в строке, результат — в последней строке.
  • events --json: построчно следит за событиями демона (запуск и остановка серверов, ход установки и т. п.).
  • do: список действий, которые предлагает демон. do действие --plan показывает, что изменится, ещё до выполнения.

Что человек делает сам

  • Команды, требующие подтверждения, вне терминала не спрашивают, а останавливаются и выполняются только с --yes. Пусть агент спрашивает вас, прежде чем добавить --yes к необратимому действию, например удалению или сбросу сервера.
  • Принять EULA игры и согласиться запускать непроверенный модуль без изоляции нельзя через --yes или --json. Это делает человек в терминале или в приложении.

Пример для инструкций агента

Добавьте в файл инструкций агента (например AGENTS.md или CLAUDE.md) что-то вроде этого. Поправьте путь под свою папку установки.

## Игровые серверы Saba-chan
- Управлять игровыми серверами только через saba-chan-cli: "C:\Program Files\Saba-chan\saba-chan-cli.exe"
- Один раз прочитать команды и аргументы через `saba-chan-cli help --json`.
- Добавлять --json к каждой команде и проверять код выхода (0 успех, 1 ошибка, 2 использование или неоднозначно, 3 нет демона, 4 не найдено).
- Спрашивать человека, прежде чем добавить --yes к необратимому действию, например удалению или сбросу сервера.
- Принятие EULA и отключение изоляции оставлять человеку.

Подключение ИИ-агента удалённо (MCP)

Даже если ИИ-агент вроде ChatGPT или Claude не может пользоваться терминалом вашего ПК, его можно подключить к облаку Saba-chan как удалённый MCP и поручить ему игровые серверы на вашем ПК. Он управляет всеми ПК, подключёнными к вашему аккаунту Discord, так же, как приложение.

  1. На экране добавления коннектора (удалённого MCP-сервера) в агенте введите https://saba-chan.online/mcp. Этот адрес также виден на экране Настройки → Подключение приложения, в /mysaba agent и в saba-chan-cli bot agent.
  2. Когда в браузере откроется вход в Discord, войдите в аккаунт Discord, к которому подключён ваш ПК, и разрешите доступ на экране согласия Saba-chan.
  3. Просите агента обычными словами. Например: «Покажи состояние сервера Minecraft», «Перезапусти сервер Palworld».

Что стоит знать.

  • К одному аккаунту Discord подключается только один агент. Если вы разрешите другого агента, ранее подключённый отключается.
  • Об опасных командах, остановке и перезапуске агент спрашивает ещё раз на своём экране перед выполнением (те же правила, что и в приложении). Через Discord он не спрашивает.
  • То, что заблокировано в Saba-chan веб (настройки только для ПК, например пути и пароли, обновление Saba-chan и т. п.), нельзя сделать и через агента.
  • Отключение: кнопка Отключить агента на экране Настройки → Подключение приложения, /mysaba agent в Discord или saba-chan-cli bot agent --unlink. Подключение, которым не пользовались 90 дней, обрывается само.