이 페이지는 영어에서 기계 번역되었습니다. 영어 원문 읽기.

gamedev CLI 레퍼런스

모든 gamedev CLI 명령과 옵션: 대화형 및 헤드리스 모드, pkg, remote, daemon, acp, image-runtime, update, 그리고 터미널의 슬래시 명령을 다룹니다.

2026년 11월 4일 업데이트 Markdown으로 보기

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로 종료합니다(확인하려면 두 번 누르세요).
  • 입력창에서 Space를 약 3분의 1초 동안 누르고 있으면 말할 수 있습니다(누르고 말하기 음성 입력).

터미널이 없으면(파이프 입력) 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]

OS 서비스는 macOS에서는 LaunchAgent, Linux에서는 systemd 사용자 유닛, Windows에서는 로그온 시 실행되는 Task Scheduler 작업이며 관리자 권한이 필요 없습니다.

gamedev acp

gamedev acp는 CLI를 T3 Code, Zed, JetBrains IDE 같은 ACP 클라이언트를 위한 Agent Client Protocol 에이전트로 전환합니다. 클라이언트가 이를 실행하며, 프로토콜 메시지는 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를 포함한 설정
/permissionsAI가 도구를 실행하기 전에 언제 물어볼지 표시하거나 변경
/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]이 채팅에서 언급된 파일 목록 표시, 파일 열기
/search, /replace프로젝트 검색, Search Replace 저장·적용·복구
/git상태, 스테이징, 커밋, 변경 폐기, 풀, 푸시, 강제 푸시 및 init

확장 기능, 패키지 및 모델

명령기능
/packagesgamedev pkg와 동일한 하위 명령에 views, tree <view id>, runs, cancel, reload 추가
/mcp프로젝트의 MCP 서버 관리: 추가, 활성화, 제거, 테스트
/pluginClaude 플러그인 및 마켓플레이스 관리: 설치, 활성화, 업데이트
/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_GLYPHS1로 설정하면 이모지를 잘못 측정하는 터미널에서 /model 선택기의 미터를 ASCII로 강제합니다

설정 우선순위: 명령줄 옵션, 그다음 환경 변수, 그다음 ~/.ai-game-dev/config.json.