Esta página se tradujo automáticamente del inglés. Lee el original en inglés.

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.

Actualizado el 4 de noviembre de 2026 Ver como Markdown

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 | --version

Opciones

OpciónSignificado
<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
--headlessFuerza 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, -hMuestra la ayuda
--version, -vImprime 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 salidaCuándo
0La respuesta terminó
1Un error de consulta, de red o del agente, o Ctrl+C después de que la ejecución haya comenzado
2Sin sesión iniciada, un prompt vacío o una carpeta o flag inutilizable
130Ctrl+C antes de que la ejecución comenzara; no se envió nada
143SIGTERM; 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 service

Los 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 see

Un 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

ComandoQué hace
/helpLista los comandos disponibles
/clearInicia una conversación nueva
/resetReinicia la sesión actual
/reopenReabre un chat perdido desde su historial guardado (no se reenvía nada)
/savedRecupera mensajes, ajustes, imágenes y cambios de archivos o de Git guardados
/modelElige el modelo (Tab: esfuerzo de razonamiento)
/agentLista los agentes; /agent use <id> cambia, /agent refresh recarga la lista
/skillsLista las habilidades disponibles en este proyecto
/contextActiva o desactiva el panel de depuración de contexto
/exitSalir (también /quit)

Cuenta, ajustes y actualizaciones

ComandoQué hace
/login [--switch]Inicia sesión; --switch cambia la cuenta de este equipo
/logoutCierra la sesión
/configAjustes, incluidos los Tools de esta sesión
/permissionsMuestra o cambia cuándo la IA pregunta antes de ejecutar herramientas
/voice-languageEstablece el idioma de transcripción de voz
/update [now]Cómo actualizar la CLI; now actualiza un servicio en segundo plano en espera
/remote, /machineAcceso remoto; lista o cambia de equipo

Motor y proyecto

ComandoQué hace
/install-plugin [path]Instala el plugin MCP en el proyecto actual de Unity, Godot o Unreal
/install-extensionExplora e instala una extensión de motor
/openAbre el editor del proyecto actual
/create-projectCrea un nuevo proyecto de juego, por ejemplo /create-project unity MyGame (motor unity, godot o unreal, un nombre, una carpeta padre opcional)
/fileCrea, renombra, mueve, copia o elimina archivos del proyecto
/files [n]Lista los archivos mencionados en este chat; abre uno
/search, /replaceBusca en el proyecto; guarda, aplica y recupera Search Replace
/gitEstado, preparar (stage), commit, descartar, pull, push, force-push e init

Extensiones, paquetes y modelos

ComandoQué hace
/packagesLos mismos subcomandos que gamedev pkg, más views, tree <view id>, runs, cancel y reload
/mcpGestiona los servidores MCP del proyecto: añadir, activar, eliminar, probar
/pluginGestiona plugins y marketplaces de Claude: instalar, activar, actualizar
/imagesModelos de imagen locales, descargas y almacenamiento (/images help)
/image [n]Lista las imágenes de esta sesión; abre o elimina una
/modelsTodas las formas de ejecutar un modelo de medios, local y en la nube; añade image, video, audio o 3d (/models help)
/cloudEl ajuste de generación en la nube de esta sesión: ask, budget <percent> u off
/blender, /supercollider, /kbComandos 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 again

Variables de entorno

VariablePropósito
AI_GAME_DEV_MODELAnulación del modelo predeterminado
AI_GAME_DEV_ASCII_GLYPHS1 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.