6. CLI とエージェント連携

ターミナルからサバちゃんを扱い、Claude Code や Codex のような自分の AI エージェントに任せます。

6. CLI とエージェント連携

saba-chan-cli は、サバちゃんをターミナル(コマンドを入力するウィンドウ)から扱うツールです。アプリでできることは CLI でもすべてでき、CLI もアプリと同じくデーモンに頼むだけで、サーバーファイルを直接さわりません。人が使いやすく、機械が読みやすい出力も出せるので、自分の AI エージェントにサバちゃんを任せるのにも使えます。


CLI を使う

CLI はサバちゃんをインストールしたフォルダーにあります(既定は C:\Program Files\Saba-chan\saba-chan-cli.exe)。インストーラーはシステムの PATH(Windows がコマンドを探すフォルダーの一覧)を変えません。CLI はフルパスで呼ぶか、そのフォルダーを自分で PATH に追加してください。Linux ではインストーラーが ~/.local/bin/saba-chan-cli を作ります。

  • 引数なしで実行すると対話型の画面が開きます。
  • デーモンが止まっていれば、起動するか聞いてきます。CLI を閉じてもデーモンとサーバーは動き続けます。
  • サーバー名は一部だけでも大丈夫です。
やりたいことコマンド
全体の状態saba-chan-cli status
サーバーの追加saba-chan-cli server add
起動 · 停止 · 再起動saba-chan-cli start パル · stop パル · restart パル
コンソール · ゲームのコマンドsaba-chan-cli console パル · saba-chan-cli run 週末 say こんにちは
バックアップ · 予約タスクsaba-chan-cli backup … · saba-chan-cli schedule …
Discord 接続saba-chan-cli bot pair(コードを見せて、つながるまで待ちます)
Discord サーバーのプレフィックス · スラッシュコマンドの形saba-chan-cli bot prefix … · bot slash …
読み上げサバちゃん · Discord サーバー管理saba-chan-cli bot tts … · bot moderation · bot channel …
おしゃべりサバちゃんのツールの確認saba-chan-cli chatbot tools(変更: chatbot set tools=[lol,pubg] --guild …)
接続された AI エージェント(リモート)の確認 · 切断saba-chan-cli bot agent · bot agent --unlink
コマンド権限 · レベル別コマンドの確認saba-chan-cli perm … · perm commands
Discord の聞き返しの段階saba-chan-cli bot confirm
サバちゃんのアップデートsaba-chan-cli update check · update apply
リモートデーモンsaba-chan-cli remote … · 任意のコマンドに --daemon <名前>(リモートデーモン)
アプリに切り替えsaba-chan-cli gui
個人情報をすべて削除saba-chan-cli bot erase
詳しいヘルプsaba-chan-cli <コマンド> --help

自分の AI エージェントと連携する

Claude Code や Codex のように、ターミナルのコマンドを実行できる AI エージェントならサバちゃんを任せられます。エージェントは人と同じように言葉で頼まれ、裏で saba-chan-cli を実行して結果を読みます。

自分のAIエージェント(例: 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 で何が変わるかを先に見てから実行できます。

人が自分で行うこと

  • 確認が必要なコマンド(起動中のサーバーの stop・restart を含む)は、ターミナルでなければ聞かずに止まるので、--yes がないと実行されません。サーバーの削除や初期化のように元に戻せないコマンドに --yes を付ける前は、エージェントがまず人に聞くようにしてください。
  • ゲームの規約(EULA)への同意と、確認されていないモジュールを隔離なしで動かす同意は、--yes や --json で代わりにできません。人がターミナルかアプリで直接行います。

エージェントの指示に貼り付ける例

エージェントの指示ファイル(例: AGENTS.md、CLAUDE.md)に次のように書いておけば十分です。パスは自分のインストール先に合わせて直してください。

## サバちゃんのゲームサーバー
- ゲームサーバーは saba-chan-cli だけで扱う: "C:\Program Files\Saba-chan\saba-chan-cli.exe"
- 最初に一度 `saba-chan-cli help --json` でコマンドと引数を読む。
- すべてのコマンドに --json を付け、終了コードを確かめる(0 成功、1 失敗、2 使い方・あいまい、3 デーモンなし、4 対象なし)。
- サーバーの削除・初期化のように元に戻せないコマンドは、人に聞いてから --yes を付ける。
- 規約への同意と隔離の解除は人に任せる。

リモートで AI エージェントを接続する (MCP)

ChatGPT や Claude のような AI エージェントが PC のターミナルを使えなくても、サバちゃんクラウドにリモート MCP で接続して、自分の PC のゲームサーバーを任せられます。自分の Discord アカウントに接続したすべての PC を、アプリと同じように扱えます。

  1. エージェントのコネクター(リモート MCP サーバー)追加画面に https://saba-chan.online/mcp を入れます。このアドレスは、アプリの 設定 → 接続 画面、/mysaba agent、saba-chan-cli bot agent でも確認できます。
  2. ブラウザーで Discord のログインが開いたら、PC を接続した Discord アカウントでログインし、サバちゃんの同意画面で許可します。
  3. エージェントに言葉で頼みます。例:「マイクラのサーバーの状態を教えて」「Palworld のサーバーをもう一度起動して」

知っておくと便利なこと:

  • エージェントは Discord アカウントごとに1つだけ接続できます。別のエージェントを許可すると、先に接続したエージェントは切断されます。
  • 危険なコマンドと停止・再起動は、実行前にエージェントの画面でもう一度確認されます(アプリと同じルール)。Discord では尋ねません。
  • サバちゃんウェブでできないこと(パスやパスワードのような PC 専用の設定、サバちゃんのアップデートなど)は、エージェントからもできません。
  • 切断する方法:アプリの 設定 → 接続 画面の エージェントの接続を解除、Discord の /mysaba agent、saba-chan-cli bot agent --unlink。90日間使われなかった接続は自動的に切れます。