本頁面由英文機器翻譯而成。閱讀英文原文。

gamedev CLI 參考

所有 gamedev CLI 命令與選項:互動與無頭模式、pkg、remote、daemon、acp、image-runtime、update,以及終端機中的斜線命令。

更新於 2026年11月4日 以 Markdown 檢視

gamedev CLI 就是終端機裡的 AI Game Dev 代理:使用與桌面應用程式相同的帳號、模型、套件與引擎連線。本參考列出 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>在另一台已配對電腦的聊天室開啟終端機介面
--help、-h顯示說明
--version、-v印出版本

--project 和 --cwd 的優先順序高於位置參數的資料夾。

互動模式

在專案資料夾中執行 gamedev。輸入請求並按 Enter。常用按鍵:

  • / 開啟斜線命令面板;方向鍵移動,Tab 補全命令名稱。
  • 回覆串流中按 Esc 可中斷。
  • Ctrl+C 結束(按兩次確認)。
  • 在輸入區按住空白鍵約三分之一秒即可說話(push-to-talk 語音輸入)。

沒有終端機時(管線輸入),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;什麼都沒送出
143SIGTERM;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]

作業系統服務在 macOS 上是 LaunchAgent、在 Linux 上是 systemd 使用者單元、在 Windows 上則是登入時執行的 Task Scheduler 工作;不需要管理員權限。

gamedev acp

gamedev acp 會把 CLI 變成 Agent Client Protocol 代理,供 T3 Code、Zed 與 JetBrains IDE 等 ACP 用戶端使用。由用戶端啟動它;通訊協定訊息走 stdout,診斷訊息則送到 stderr。在用戶端中,新增一個自訂代理,命令為 gamedev、引數為 acp。它會使用這台電腦的登入狀態、你帳號的模型以及專案的引擎工具。貼文在 T3 Code 中將 AI Game Dev 用作 ACP 代理有完整設定步驟。

斜線命令

在互動 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]將 MCP 外掛安裝到目前的 Unity、Godot 或 Unreal 專案
/install-extension瀏覽並安裝引擎擴充套件
/open開啟目前專案的編輯器
/create-project建立新的遊戲專案,例如 /create-project unity MyGame(引擎為 unity、godot 或 unreal,接著是名稱,以及選用的上層資料夾)
/file建立、重新命名、移動、複製或刪除專案檔案
/files [n]列出此對話中提到的檔案;開啟其中一個
/search、/replace搜尋專案;儲存、套用與還原 Search Replace
/git狀態、加入暫存、提交、捨棄、拉取、推送、強制推送與初始化

擴充套件、套件與模型

指令功能說明
/packages與 gamedev pkg 相同的子指令,另外還有 views、tree <view id>、runs、cancel 與 reload
/mcp管理專案的 MCP 伺服器:新增、啟用、移除、測試
/plugin管理 Claude 外掛與市集:安裝、啟用、更新
/images本機影像模型、下載與儲存空間(/images help)
/image [n]列出本次工作階段的影像;開啟或移除其中一個
/models執行媒體模型的所有方式,包含本機與雲端;可加上 image、video、audio 或 3d(/models help)
/cloud本次工作階段的 Cloud 生成設定:ask、budget <percent> 或 off
/blender、/supercollider、/kbBlender、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 計量條,適用於無法正確測量 emoji 的終端機

設定優先順序:命令列選項,其次是環境變數,最後是 ~/.ai-game-dev/config.json。