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 を実行して結果を読みます。
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 を、アプリと同じように扱えます。
- エージェントのコネクター(リモート MCP サーバー)追加画面に
https://saba-chan.online/mcpを入れます。このアドレスは、アプリの 設定 → 接続 画面、/mysaba agent、saba-chan-cli bot agentでも確認できます。 - ブラウザーで Discord のログインが開いたら、PC を接続した Discord アカウントでログインし、サバちゃんの同意画面で許可します。
- エージェントに言葉で頼みます。例:「マイクラのサーバーの状態を教えて」「Palworld のサーバーをもう一度起動して」
知っておくと便利なこと:
- エージェントは Discord アカウントごとに1つだけ接続できます。別のエージェントを許可すると、先に接続したエージェントは切断されます。
- 危険なコマンドと停止・再起動は、実行前にエージェントの画面でもう一度確認されます(アプリと同じルール)。Discord では尋ねません。
- サバちゃんウェブでできないこと(パスやパスワードのような PC 専用の設定、サバちゃんのアップデートなど)は、エージェントからもできません。
- 切断する方法:アプリの 設定 → 接続 画面の
エージェントの接続を解除、Discord の/mysaba agent、saba-chan-cli bot agent --unlink。90日間使われなかった接続は自動的に切れます。