gamedev CLI リファレンス
gamedev CLI のすべてのコマンドとオプションを解説します。対話モードとヘッドレスモード、pkg、remote、daemon、acp、image-runtime、update、そしてターミナル内のスラッシュコマンドを網羅します。
gamedev CLI はターミナル上で動く AI Game Dev エージェントです。デスクトップアプリと同じアカウント、モデル、パッケージ、エンジン接続を使用します。このリファレンスでは、CLI のすべてのコマンドとオプション、CLI 内で入力するスラッシュコマンド、および終了コードを一覧します。インストールは npm install -g @baizor/gamedev で行います(インストールを参照)。
使用法の概要
gamedev [<project-dir>] [options] interactive terminal UI
gamedev --print "<prompt>" headless one-shot query, reply on stdout
gamedev --print - headless, prompt read from stdin
gamedev --headless headless, prompt read from stdin
gamedev update upgrade the CLI to the latest version
gamedev pkg <subcommand> [args] manage packages, then exit
gamedev image-runtime [status|start] the local image runtime
gamedev remote <subcommand> [args] remote access and your other devices
gamedev daemon <subcommand> the background service
gamedev --on <name|id-prefix> the terminal UI on another computer's chats
gamedev acp [--model <model>] Agent Client Protocol agent on stdin/stdout
gamedev --help | --versionオプション
| オプション | 意味 |
|---|---|
<project-dir> | プロジェクトフォルダ(--project と同じ)。相対パスはカレントディレクトリを基準に解決されます |
--project, -p <path> | プロジェクトフォルダ(デフォルト: カレントディレクトリ) |
--cwd <path> | --project のエイリアス |
--model <model> | 使用するモデル(デフォルト: アカウントに割り当てられたモデル) |
--resume, -r <id> | 前回のセッションを再開する |
--print <prompt> | 非対話: プロンプトを送信し、応答を stdout にストリームして終了します。- を指定すると stdin から読み込みます |
--headless | 非対話モードを強制し、stdin からプロンプトを読み取る |
--on <name> | ペアリング済みの別のコンピューターのチャットでターミナル UI を開く |
--help, -h | ヘルプを表示する |
--version, -v | バージョンを表示する |
--project と --cwd は位置引数のフォルダより優先されます。
対話モード
プロジェクトフォルダで gamedev を実行します。リクエストを入力して Enter を押します。便利なキー操作:
/でスラッシュコマンドパレットが開きます。矢印キーで移動し、Tab でコマンド名を補完します。- 応答のストリーミング中に Esc を押すと中断します。
- Ctrl+C で終了します(確認のため 2 回押します)。
- 入力欄で Space を約 0.3 秒間押し続けると話せます(プッシュトゥトーク音声入力)。
ターミナルがない場合(パイプ入力)は、CLI はシンプルな行モードにフォールバックします。
ヘッドレスモードとスクリプト
ヘッドレス実行では応答のみが stdout に出力されます。CLI が検出した内容(例:「Unity project detected」)は stderr に出力されます。
gamedev --print "List every scene in this project"
echo "Summarise the open TODOs in Assets/Scripts" | gamedev --headless
gamedev --project ./MyGame --model <model-id> --print "Run the edit-mode tests"| 終了コード | 条件 |
|---|---|
0 | 応答が完了した |
1 | クエリ、ネットワーク、エージェントのエラー、または実行開始後の Ctrl+C |
2 | サインインしていない、プロンプトが空、または使用できないフォルダやフラグ |
130 | 実行開始前の Ctrl+C。何も送信されていない |
143 | SIGTERM。CLI はデタッチし、すでに送信されたプロンプトはバックグラウンドサービスで実行され続ける |
gamedev pkg
カレントディレクトリ(または --cwd <path>)のプロジェクトのパッケージを管理します。レベルフラグ: --user(このコンピューター上のすべてのプロジェクト)、--project(コミット対象、デフォルト)、--local(このチェックアウトのみ)。
gamedev pkg list [--user] packages in effect (--user: the user level alone)
gamedev pkg add <input> [level] <publisher.name>[@range] | github:<owner>/<repo>[@tag|#ref] | npm:<name> | file:<path> | URL | owner/repo | folder
gamedev pkg remove <id> [level] delete the id's entry at that level
gamedev pkg exclude <id> [level] turn the package off at that level
gamedev pkg include <id> [level] undo exclude
gamedev pkg update [<id>] [--user] newest compatible version within the declared range, now
gamedev pkg auto-update on|off <id> this computer's auto-update preference for one package
gamedev pkg sync [--user] make locks and cache match the level files
gamedev pkg link <folder> [level] use a local folder instead of the published version (default --local)
gamedev pkg unlink <id> [level] stop using the local folder
gamedev pkg dev <folder> [level] link, and rebuild on every source change until Ctrl+C
gamedev pkg settings <id> [<key> [<value>]] read or write a package's settings (--unset clears a value)gamedev pkg settings は値が拒否された場合はコード 1、使用法のエラーでは 2 で終了します。link と dev についてはパッケージの作成を参照してください。
gamedev image-runtime
gamedev image-runtime status [--json] show this computer's local image runtime coordinator
gamedev image-runtime start [--json] start it through the background serviceモデル自体は CLI 内の /images で管理します(後述)。
gamedev remote
同じアカウントにサインインしたコンピューターやデバイス間のリモートアクセスです。対話型 CLI の /remote は同じコマンドです。
gamedev remote status this computer and your other devices
gamedev remote pair show a pairing code and QR, then approve the device that enters it
gamedev remote join <device> <code> pair with another computer
gamedev remote allow [<device>] allow remote control here, or let a device control chats
gamedev remote allow <device> --services let a device use this computer's shared models
gamedev remote block [<device>] [--services] turn remote control off, or take a device's access away
gamedev remote share [on|off] share this computer's models with your other computers
gamedev remote share pause|resume stop or resume accepting images from other computers
gamedev remote forget <device> unpin a computer you paired with
gamedev remote revoke <device> remove a device paired with this computer
gamedev remote rename <name> the name your other devices seeデバイスは名前、または id の先頭部分で指定します。pair は表示、操作、モデルの共有について個別に確認します。その後 gamedev --on <device> でそのコンピューターのチャットを開きます。/machine でコンピューターを一覧表示または切り替え、/machine this で戻ります。
gamedev daemon
デスクトップアプリと CLI が共有するバックグラウンドサービスです。
gamedev daemon status installed and running; the Kernel, account, remote access, logs
gamedev daemon install run it as a per-user OS service that starts at login and restarts if it stops
gamedev daemon uninstall remove the OS service
gamedev daemon start start the background service
gamedev daemon stop stop it
gamedev daemon restart stop, then start
gamedev daemon logs [kernel|service|remote|auth] [--lines N] [--follow]OS のサービスは、macOS では LaunchAgent、Linux では systemd のユーザーユニット、Windows ではログオン時のタスクスケジューラタスクです。管理者権限は不要です。
gamedev acp
gamedev acp は CLI を、T3 Code、Zed、JetBrains IDE などの ACP クライアント向けの Agent Client Protocol エージェントに変えます。起動はクライアント側から行います。プロトコルメッセージは stdout を使用し、診断情報は stderr に出力されます。クライアントで、コマンド gamedev と引数 acp を指定してカスタムエージェントを追加します。このコンピューターのサインイン、アカウントのモデル、プロジェクトのエンジンツールが使用されます。セットアップの手順はブログ記事 T3 Code で ACP エージェントとして AI Game Dev を使うで解説しています。
スラッシュコマンド
これらは対話型 CLI 内で入力します。多くはデスクトップのチャットでも動作します。
チャットとセッション
| コマンド | 内容 |
|---|---|
/help | 使用可能なコマンドを一覧表示する |
/clear | 新しい会話を開始する |
/reset | 現在のセッションをリセットする |
/reopen | 失われたチャットを保存履歴から再度開く(再送信は行われない) |
/saved | 保存されたメッセージ、設定、画像、ファイルや Git の変更を復元する |
/model | モデルを選択する(Tab: 推論の強度) |
/agent | エージェントを一覧表示する。/agent use <id> で切り替え、/agent refresh でリストを再読み込みする |
/skills | このプロジェクトで利用可能なスキルを一覧表示する |
/context | コンテキストデバッグパネルを切り替える |
/exit | 終了する(/quit も可) |
アカウント、設定、更新
| コマンド | 内容 |
|---|---|
/login [--switch] | サインインする。--switch はこのコンピューターのアカウントを変更する |
/logout | サインアウトする |
/config | 設定(このセッションのToolsを含む) |
/permissions | AIがツールを実行する前に確認するタイミングを表示・変更する |
/voice-language | 音声文字起こしの言語を設定する |
/update [now] | CLIのアップグレード方法。nowを付けると待機中のバックグラウンドサービスを更新する |
/remote、/machine | リモートアクセス。コンピューターの一覧表示や切り替え |
エンジンとプロジェクト
| コマンド | 動作内容 |
|---|---|
/install-plugin [path] | 現在のUnity、Godot、UnrealプロジェクトにMCPプラグインをインストールする |
/install-extension | エンジン拡張機能を参照してインストールする |
/open | 現在のプロジェクトのエディターを開く |
/create-project | 新しいゲームプロジェクトを作成する。例:/create-project unity MyGame(エンジンはunity、godot、unreal、プロジェクト名、任意の親フォルダー) |
/file | プロジェクトファイルの作成、名前変更、移動、コピー、削除 |
/files [n] | このチャットで言及されたファイルを一覧表示する。1つを開く |
/search、/replace | プロジェクト内を検索する。Search Replaceの保存、適用、復元 |
/git | ステータス、ステージ、コミット、破棄、プル、プッシュ、強制プッシュ、init |
拡張機能、パッケージ、モデル
| コマンド | 動作内容 |
|---|---|
/packages | gamedev pkgと同じサブコマンドに加えて、views、tree <view id>、runs、cancel、reload |
/mcp | プロジェクトのMCPサーバーを管理する:追加、有効化、削除、テスト |
/plugin | Claudeプラグインとマーケットプレイスを管理する:インストール、有効化、更新 |
/images | ローカル画像モデル、ダウンロード、ストレージ(/images help) |
/image [n] | このセッションの画像を一覧表示する。1つを開くか削除する |
/models | メディアモデルを実行するすべての方法(ローカルとクラウド)。image、video、audio、3dを追加(/models help) |
/cloud | このセッションのCloud生成設定:ask、budget <percent>、off |
/blender、/supercollider、/kb | Blender、Music、Knowledge Baseパッケージのコマンド |
インストールされたパッケージはスラッシュコマンドを追加できます。それらは/パレットに表示されます。
/imagesのサブコマンド
/images this computer, the runtime, storage and every image model
/images download <model> [--yes] download a model (and the runtime when missing); asks first
/images cancel|resume <model|runtime> stop or continue a download
/images update <model> [--yes] download a model's update
/images delete <model> [--yes] delete a model's files from this computer
/images allow|block <model> [--user|--project] whether the agent may use it
/images default <model|auto> the default image model (auto = recommended for this computer)
/images stop [session|<job id>] stop image generation and free the GPU
/images free-space [--yes] delete model files no model uses any more
/images storage [<new folder>] show or move the model storage folder
/images redetect detect the GPU, memory and driver again
/images reinstall set the image runtime up again環境変数
| 変数 | 目的 |
|---|---|
AI_GAME_DEV_MODEL | デフォルトモデルの上書き |
AI_GAME_DEV_ASCII_GLYPHS | 1を指定すると、絵文字の測定を誤るターミナル向けに/modelピッカーでASCIIメーターを強制する |
設定の優先順位:コマンドラインオプション、次に環境変数、次に~/.ai-game-dev/config.json。
関連情報
- エンジンプラグインには独自のCLIがあります:
unity-mcp-cli、unreal-mcp-cli、godot-cli。 - 実際のエラーと終了コードについてはトラブルシューティングを参照してください。