Referencia de la CLI gamedev
Todos los comandos y opciones de la CLI gamedev: modos interactivo y headless, pkg, remote, daemon, acp, image-runtime, update y comandos de barra.
La CLI gamedev es el agente de AI Game Dev en tu terminal: la misma cuenta, modelos, paquetes y conexión con el motor que la app de escritorio. Esta referencia enumera todos los comandos y opciones de la CLI, los comandos de barra que escribes dentro de ella y sus códigos de salida. Instálala con npm install -g @baizor/gamedev (consulta Instalación).
Uso de un vistazo
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 | --versionOpciones
| Opción | Significado |
|---|---|
<project-dir> | Carpeta del proyecto (igual que --project); una ruta relativa se resuelve respecto al directorio actual |
--project, -p <path> | Carpeta del proyecto (por defecto: el directorio actual) |
--cwd <path> | Alias de --project |
--model <model> | Modelo a usar (por defecto: el asignado a tu cuenta) |
--resume, -r <id> | Reanuda una sesión anterior |
--print <prompt> | No interactivo: envía el prompt, transmite la respuesta a stdout y sale. - lee de stdin |
--headless | Fuerza el modo no interactivo; el prompt se lee de stdin |
--on <name> | Abre la interfaz de terminal en los chats de otro equipo emparejado |
--help, -h | Muestra la ayuda |
--version, -v | Imprime la versión |
--project y --cwd tienen prioridad sobre una carpeta posicional.
Modo interactivo
Ejecuta gamedev en una carpeta de proyecto. Escribe una petición y pulsa Intro. Teclas útiles:
/abre la paleta de comandos de barra; las teclas de flecha mueven, Tab completa el nombre del comando.- Esc mientras se transmite una respuesta la interrumpe.
- Ctrl+C sale (pulsa dos veces para confirmar).
- Mantén pulsada la barra espaciadora alrededor de un tercio de segundo en la entrada para hablar (entrada de voz push-to-talk).
Sin terminal (entrada por tubería), la CLI recurre a un modo de línea simple.
Modo headless y scripting
Las ejecuciones headless imprimen solo la respuesta en stdout; lo que la CLI detectó (por ejemplo, «Unity project detected») va a 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"| Código de salida | Cuándo |
|---|---|
0 | La respuesta terminó |
1 | Un error de consulta, de red o del agente, o Ctrl+C después de que la ejecución haya comenzado |
2 | Sin sesión iniciada, un prompt vacío o una carpeta o flag inutilizable |
130 | Ctrl+C antes de que la ejecución comenzara; no se envió nada |
143 | SIGTERM; la CLI se desacopla y un prompt ya enviado sigue ejecutándose en el servicio en segundo plano |
gamedev pkg
Gestiona los paquetes del proyecto en el directorio actual (o --cwd <path>). Flags de nivel: --user (todos los proyectos de este equipo), --project (incluido en el control de versiones, el predeterminado), --local (solo esta copia de trabajo).
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 sale con código 1 cuando se rechaza un valor y 2 en un error de uso. Consulta Crear paquetes para link y 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 serviceLos modelos en sí se gestionan con /images dentro de la CLI (más abajo).
gamedev remote
Acceso remoto entre tus equipos y dispositivos con sesión iniciada en la misma cuenta. /remote en la CLI interactiva es el mismo comando.
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 seeUn dispositivo es un nombre o el inicio de su id. pair pregunta por separado sobre visualización, control y modelos compartidos. Después, gamedev --on <device> abre los chats de ese equipo; /machine lista o cambia de equipo y /machine this vuelve.
gamedev daemon
El servicio en segundo plano que comparten la app de escritorio y la 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]El servicio del SO es un LaunchAgent en macOS, una unidad de usuario de systemd en Linux y una tarea del Programador de tareas al iniciar sesión en Windows; no necesita permisos de administrador.
gamedev acp
gamedev acp convierte la CLI en un agente Agent Client Protocol para clientes ACP como T3 Code, Zed e IDE de JetBrains. El cliente lo inicia; los mensajes del protocolo usan stdout y los diagnósticos van a stderr. En el cliente, añade un agente personalizado con el comando gamedev y el argumento acp. Usa el inicio de sesión de este equipo, los modelos de tu cuenta y las herramientas de motor del proyecto. La publicación AI Game Dev como agente ACP en T3 Code explica la configuración paso a paso.
Comandos de barra
Escribe estos dentro de la CLI interactiva. Muchos también funcionan en el chat de escritorio.
Chat y sesión
| Comando | Qué hace |
|---|---|
/help | Lista los comandos disponibles |
/clear | Inicia una conversación nueva |
/reset | Reinicia la sesión actual |
/reopen | Reabre un chat perdido desde su historial guardado (no se reenvía nada) |
/saved | Recupera mensajes, ajustes, imágenes y cambios de archivos o de Git guardados |
/model | Elige el modelo (Tab: esfuerzo de razonamiento) |
/agent | Lista los agentes; /agent use <id> cambia, /agent refresh recarga la lista |
/skills | Lista las habilidades disponibles en este proyecto |
/context | Activa o desactiva el panel de depuración de contexto |
/exit | Salir (también /quit) |
Cuenta, ajustes y actualizaciones
| Comando | Qué hace |
|---|---|
/login [--switch] | Inicia sesión; --switch cambia la cuenta de este equipo |
/logout | Cierra la sesión |
/config | Ajustes, incluidos los Tools de esta sesión |
/permissions | Muestra o cambia cuándo la IA pregunta antes de ejecutar herramientas |
/voice-language | Establece el idioma de transcripción de voz |
/update [now] | Cómo actualizar la CLI; now actualiza un servicio en segundo plano en espera |
/remote, /machine | Acceso remoto; lista o cambia de equipo |
Motor y proyecto
| Comando | Qué hace |
|---|---|
/install-plugin [path] | Instala el plugin MCP en el proyecto actual de Unity, Godot o Unreal |
/install-extension | Explora e instala una extensión de motor |
/open | Abre el editor del proyecto actual |
/create-project | Crea un nuevo proyecto de juego, por ejemplo /create-project unity MyGame (motor unity, godot o unreal, un nombre, una carpeta padre opcional) |
/file | Crea, renombra, mueve, copia o elimina archivos del proyecto |
/files [n] | Lista los archivos mencionados en este chat; abre uno |
/search, /replace | Busca en el proyecto; guarda, aplica y recupera Search Replace |
/git | Estado, preparar (stage), commit, descartar, pull, push, force-push e init |
Extensiones, paquetes y modelos
| Comando | Qué hace |
|---|---|
/packages | Los mismos subcomandos que gamedev pkg, más views, tree <view id>, runs, cancel y reload |
/mcp | Gestiona los servidores MCP del proyecto: añadir, activar, eliminar, probar |
/plugin | Gestiona plugins y marketplaces de Claude: instalar, activar, actualizar |
/images | Modelos de imagen locales, descargas y almacenamiento (/images help) |
/image [n] | Lista las imágenes de esta sesión; abre o elimina una |
/models | Todas las formas de ejecutar un modelo de medios, local y en la nube; añade image, video, audio o 3d (/models help) |
/cloud | El ajuste de generación en la nube de esta sesión: ask, budget <percent> u off |
/blender, /supercollider, /kb | Comandos de los paquetes Blender, Music y Knowledge Base |
Los paquetes instalados pueden añadir más comandos de barra; aparecen en la paleta /.
Subcomandos de /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 againVariables de entorno
| Variable | Propósito |
|---|---|
AI_GAME_DEV_MODEL | Anulación del modelo predeterminado |
AI_GAME_DEV_ASCII_GLYPHS | 1 fuerza medidores ASCII en el selector /model para terminales que miden mal los emoji |
Prioridad de configuración: opciones de línea de comandos, luego variables de entorno, luego ~/.ai-game-dev/config.json.
Relacionado
- Los plugins de motor tienen sus propias CLI:
unity-mcp-cli,unreal-mcp-cli,godot-cli. - Solución de problemas para errores y códigos de salida en la práctica.